# Доступ и разрешения

Как выбрать, какие операции TalkBar может выполнять ИИ-ассистент, как подтверждается удаление и как с этим соотносятся правила администратора и CLI.

Canonical URL: https://docs.talkbar.ru/mcp/access-and-permissions


Что может делать подключённый ИИ-ассистент, вы решаете сами — по одной операции — в разделе **Настройки → Доступ по MCP**. Чтение по умолчанию включено, изменение вашего содержимого выключено, а всё, что перемещает в корзину, архивирует или удаляет, подтверждается у вас, если ваше ИИ-приложение умеет задавать вопросы. Приложениям, которые не умеют, в этом отказывается, если вы не включили **Разрешить удаление без подтверждения**.

## Переключатель MCP

Переключатель в правом верхнем углу раздела **Доступ по MCP** включает или выключает MCP для всех подключённых приложений. После установки TalkBar он выключен.

- **Выключен:** подключённое приложение не видит инструментов TalkBar, и каждая операция отвечает, что она выключена. Переключатели разрешений ниже недоступны.
- **Включён:** подключённое приложение видит [инструменты TalkBar](/mcp/tools) и может выполнять включённые вами операции.

## Переключатели «Чтение» и «Изменение»

В карточке **Разрешения** по одной строке на каждый вид данных: **Сессии**, **Заметки**, **Проекты**, **Задачи**, **База знаний**, **Команда** (люди и компании), **Темы**, **Закладки**, **Чаты**, **Документы**, **Календарь**, **Серии сессий**, **Планировщик**, **Экспорт**, **Пространство** и **Профиль**.

В каждой строке два переключателя:

| Переключатель | Что разрешает | По умолчанию |
| --- | --- | --- |
| **Чтение** | Вывод списков, поиск и чтение этого вида данных. Чтение никогда ничего не меняет. | Включено |
| **Изменение** | Создание, изменение, перемещение в корзину, архивацию и восстановление этого вида данных. Ничего не удаляется навсегда. | Выключено, кроме строк «Календарь», «Серии сессий», «Планировщик» и «Экспорт» |

Рядом с каждым переключателем строки счётчик, например `3/7`, показывает, сколько её операций включено. Переключатель выглядит включённым, только когда включены все; если включить частично включённую строку, включатся все её операции. Операции, заблокированные вашей организацией, не учитываются ни в счётчике, ни в переключателе; если в строке заблокированы все операции, её переключатель показан заблокированным. Значки **Чтение** и **Изменение** в заголовке карточки показывают, сколько операций включено всего.


Переключатель **Изменение** охватывает любые изменения этого вида данных, включая перемещение в корзину. TalkBar всё равно спрашивает вас перед каждым перемещением в корзину, архивацией или удалением (см. [Подтверждение удаления](#подтверждение-удаления)), но включайте только то, что действительно нужно.


### Отдельные операции

Откройте строку (нажмите на её название), чтобы увидеть каждую операцию с собственным переключателем, кратким описанием и идентификатором, например `notes.create`. Здесь можно включать и выключать отдельные операции, если вся строка — это больше, чем вы хотите разрешить: например, разрешить ассистенту добавлять заметки, но не перемещать их в корзину.

У операций, которые запускают работу или что-то убирают, есть значок **Желательно подтверждение**. Это подсказка для вас и для ИИ-приложений; обязательное подтверждение TalkBar — только для удаления, оно описано ниже.




### Изменения, включённые по умолчанию

Эти операции изменения включаются сразу, как только вы включаете MCP. Они планируют встречи и продвигают экспорт и фоновые задания, а не меняют ваши сессии, заметки или базу знаний:

| Область | Операции, включённые по умолчанию |
| --- | --- |
| Календарь | `calendar.schedule`, `calendar.prepare`, `calendar.prep.edit`, `calendar.move`, `calendar.snooze`, `calendar.start`, `calendar.skip`, `calendar.cancel` |
| Серии сессий | `series.create`, `series.update`, `series.sessions.assign`, `series.schedule.set`, `series.archive` |
| Планировщик | `scheduler.job.cancel`, `scheduler.job.retry` |
| Экспорт | `exports.destination.save`, `exports.destination.delete`, `exports.rule.save`, `exports.rule.delete`, `exports.enqueue`, `exports.run`, `exports.cancel`, `exports.retry`, `exports.resolve` |

`calendar.skip`, `calendar.cancel`, `series.archive`, `exports.destination.delete` и `exports.rule.delete`, как и любое удаление, выполняются через `talkbar_delete`, поэтому подтверждаются у вас (или отклоняются для приложений, которые не умеют спрашивать). `calendar.start` никогда не начинает запись: запись запускается только в приложении.

### Кнопки быстрой настройки

| Кнопка | Что делает |
| --- | --- |
| **Сбросить к стандартным** | Возвращает все операции к значениям по умолчанию. Показывается, только если что-то отличается от значений по умолчанию. |
| **Включить все** | Включает все операции после предупреждения. |
| **Отключить все** | Выключает все операции после предупреждения. После этого подключённые приложения ничего не могут ни прочитать, ни изменить. |

## Какой инструмент что выполняет

TalkBar разносит чтение, изменение и удаление по отдельным MCP-инструментам, чтобы ваше ИИ-приложение могло обращаться с ними по-разному — например, свободно выполнять чтение, но спрашивать вас перед изменениями:

| Инструмент | Выполняет | Есть в списке, когда |
| --- | --- | --- |
| `talkbar_read` | Операции чтения | Включено хотя бы одно чтение |
| `talkbar_change` | Изменения, которые ничего не убирают | Включено хотя бы одно из них |
| `talkbar_delete` | Перемещение в корзину, архивацию и удаление | Включена хотя бы одна из этих операций |

Только через `talkbar_delete` выполняются: `notes.trash`, `projects.trash`, `sessions.trash`, `chats.trash`, `knowledge.archive`, `contacts.archive`, `organizations.archive`, `series.archive`, `action_items.remove`, `topics.delete`, `markers.delete`, `exports.destination.delete`, `exports.rule.delete`, `calendar.cancel` и `calendar.skip`.

Восстановление из корзины, разархивация и другие изменения идут через `talkbar_change`. Как вызывать каждый инструмент, см. в разделе [Пять инструментов MCP](/mcp/tools).

## Когда изменения вступают в силу

TalkBar проверяет переключатели при каждом вызове, поэтому изменение в разделе **Доступ по MCP** действует уже со следующего вызова, без перезапуска.

- Выключенная операция отвечает кодом `turned_off` и сообщением «… is turned off in TalkBar. Ask the user to turn it on in TalkBar Settings > MCP Access.». Хороший ассистент после этого спросит вас.
- `talkbar_tools` перечисляет выключенные операции в поле `off`, чтобы ассистент мог подсказать, какой переключатель включить, а не решить, что такой операции нет.
- Когда переключатель меняет сам список инструментов (например, первое включённое изменение добавляет `talkbar_change`), TalkBar сообщает об этом приложению при следующем вызове, чтобы оно обновило список. См. [Изменения списка инструментов](/mcp/tools#изменения-списка-инструментов).

## Подтверждение удаления

Перед выполнением вызова `talkbar_delete` TalkBar просит вас подтвердить его через ваше ИИ-приложение — с помощью предусмотренного в MCP способа, которым сервер задаёт вопрос пользователю (в MCP он называется `elicitation`, используется режим формы). Это работает только в приложениях, которые это поддерживают; о приложениях, которые не умеют спрашивать, см. [Приложения, которые не умеют спрашивать](#приложения-которые-не-умеют-спрашивать). В вопросе перечислены все операции и их идентификаторы:

```text
An assistant wants TalkBar to run:
- notes.trash {"noteId":"note-k2v9w8x7c6b5n4m3l2j1h0g9"}
Confirm to run it, or decline to run nothing.
```

| Ваш ответ | Что происходит |
| --- | --- |
| Подтверждение | Вызов выполняется. |
| Отказ, отмена или нет ответа в течение 5 минут | Ничего не выполняется. Ассистент получает `declined`. |

Несколько подробностей:

- Вызов, который в любом случае будет отклонён (неизвестная или выключенная операция, отсутствующий или неверный аргумент), отклоняется сразу, без вопроса.
- О пакете спрашивают целиком, перечисляя все операции в нём. В том же пакете могут быть и другие изменения.
- Вопрос задаётся на английском языке.
- Командная строка никогда не спрашивает. Она выполняет только то, что вы ввели сами.

### Приложения, которые не умеют спрашивать

Некоторые ИИ-приложения не умеют показывать вопросы от сервера. Для них TalkBar отклоняет каждый вызов `talkbar_delete` с кодом `confirmation_unavailable`, и ничего не выполняется, — если только вы не включили **Разрешить удаление без подтверждения** в карточке **Настройки сервера**.

| Параметр | Что делает | По умолчанию |
| --- | --- | --- |
| **Разрешить удаление без подтверждения** | Позволяет ИИ-приложениям, которые не умеют спрашивать, перемещать элементы в корзину, архивировать или удалять их без вашего подтверждения. Приложение, которое умеет спрашивать, всё равно всегда спрашивает. | Выключено |


Когда этот параметр включён, приложение, которое не умеет спрашивать, выполняет любое включённое вами удаление без проверки у вас. Включайте только те операции удаления, в которых вы уверены, и помните, что элементы из корзины можно восстановить в приложении.


## Журнал аудита

**Журнал аудита** в карточке **Настройки сервера** (по умолчанию выключен) заставляет MCP-сервер записывать в свой поток ошибок (stderr) строку о каждом вызове инструмента — с операцией и её аргументами — и ещё одну, когда вызов завершается успешно. Обычно ИИ-приложение сохраняет этот вывод в своих журналах MCP. Используйте его для отладки или чтобы проверить, что сделал ассистент. Вызовы экспорта записываются без аргументов. Командная строка записей аудита не делает.

## Правила администратора

Если TalkBar на этом компьютере управляет ваша организация, администратор может ограничить MCP и командную строку. Это видно в разделе **Доступ по MCP**:

| Правило | Что вы видите | Результат |
| --- | --- | --- |
| MCP-сервер отключён | Переключатель MCP заблокирован, с сообщением «Ваша организация отключила MCP-сервер.» | `talkbar-cli serve` не запускается. Остальные команды командной строки работают. |
| Инструмент командной строки отключён | Переключатель MCP заблокирован, с сообщением «Ваша организация отключила инструмент командной строки.» | Любая команда `talkbar-cli` отклоняется, включая MCP-сервер. Работают только `--help` и `--version`. |
| Разрешённые MCP-инструменты ограничены | «Ваша организация ограничивает, какие инструменты могут использовать ИИ-ассистенты.» У заблокированных операций показан замок и надпись **Заблокировано вашей организацией**. | Заблокированные операции остаются выключенными, что бы ни показывали ваши переключатели, — и для MCP, и для командной строки. |

Администратор разрешает или блокирует операции группами:

| Группа | Что охватывает |
| --- | --- |
| Списки и счётчики | `workspace.list`, `workspace.stats`, `sessions.list`, `sessions.stats`, `sessions.recording`, `projects.list`, `plan.get`, а также чтение календаря и серий |
| Содержимое встреч | Любое другое чтение, включая поиск, транскрипты, `exports.preview` и `calendar.prep` |
| Экспорт | Операции экспорта, кроме `exports.preview` |
| Изменения расписания | Изменения календаря и серий |
| Фоновые задания | Операции `scheduler.*` |
| Изменения элементов | Любые другие изменения: сессии, заметки, проекты, задачи, база знаний, люди, темы, закладки, чаты, документы, пространство и профиль |

Заблокированная операция не попадает ни в список инструментов, ни в `talkbar_tools`. Если ассистент всё же вызовет её, он получит `failed` с сообщением о том, что этим параметром управляет ваша организация.

## Что игнорирует командная строка

`talkbar-cli tools call`, `tools batch` и `search` выполняют то, что вы ввели, от вашего имени. Они:

- **Игнорируют** переключатель MCP, все переключатели «Чтение» и «Изменение», а также **Разрешить удаление без подтверждения**. Командная строка никогда не запрашивает подтверждение.
- **Соблюдают** правила администратора, лимиты вашего тарифа и все проверки владельца: команда работает только с вашими собственными пространствами в этой папке данных, и ничего не удаляется навсегда.

`talkbar-cli serve` — это MCP-сервер, поэтому он подчиняется всем переключателям на этой странице. См. [talkbar-cli](/mcp/cli).

## См. также

- [Обзор MCP](/mcp/overview)
- [Настройка MCP](/mcp/setup)
- [Пять инструментов MCP](/mcp/tools)
- [Ошибки и ограничения](/mcp/errors-and-limits)
- [Настройки «Доступ по MCP»](/settings/mcp-access)
- [Справочник операций](/mcp/operations)