Доступ и разрешения
Что может делать подключённый ИИ-ассистент, вы решаете сами — по одной операции — в разделе Настройки → Доступ по MCP. Чтение по умолчанию включено, изменение вашего содержимого выключено, а всё, что перемещает в корзину, архивирует или удаляет, подтверждается у вас, если ваше ИИ-приложение умеет задавать вопросы. Приложениям, которые не умеют, в этом отказывается, если вы не включили Разрешить удаление без подтверждения.
Переключатель MCP
Переключатель в правом верхнем углу раздела Доступ по MCP включает или выключает MCP для всех подключённых приложений. После установки TalkBar он выключен.
- Выключен: подключённое приложение не видит инструментов TalkBar, и каждая операция отвечает, что она выключена. Переключатели разрешений ниже недоступны.
- Включён: подключённое приложение видит инструменты TalkBar и может выполнять включённые вами операции.
Переключатели «Чтение» и «Изменение»
В карточке Разрешения по одной строке на каждый вид данных: Сессии, Заметки, Проекты, Задачи, База знаний, Команда (люди и компании), Темы, Закладки, Чаты, Документы, Календарь, Серии сессий, Планировщик, Экспорт, Пространство и Профиль.
В каждой строке два переключателя:
| Переключатель | Что разрешает | По умолчанию |
|---|---|---|
| Чтение | Вывод списков, поиск и чтение этого вида данных. Чтение никогда ничего не меняет. | Включено |
| Изменение | Создание, изменение, перемещение в корзину, архивацию и восстановление этого вида данных. Ничего не удаляется навсегда. | Выключено, кроме строк «Календарь», «Серии сессий», «Планировщик» и «Экспорт» |
Рядом с каждым переключателем строки счётчик, например 3/7, показывает, сколько её операций включено. Переключатель выглядит включённым, только когда включены все; если включить частично включённую строку, включатся все её операции. Операции, заблокированные вашей организацией, не учитываются ни в счётчике, ни в переключателе; если в строке заблокированы все операции, её переключатель показан заблокированным. Значки Чтение и Изменение в заголовке карточки показывают, сколько операций включено всего.
Отдельные операции
Откройте строку (нажмите на её название), чтобы увидеть каждую операцию с собственным переключателем, кратким описанием и идентификатором, например 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.
Когда изменения вступают в силу
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 сообщает об этом приложению при следующем вызове, чтобы оно обновило список. См. Изменения списка инструментов.
Подтверждение удаления
Перед выполнением вызова talkbar_delete TalkBar просит вас подтвердить его через ваше ИИ-приложение — с помощью предусмотренного в MCP способа, которым сервер задаёт вопрос пользователю (в MCP он называется elicitation, используется режим формы). Это работает только в приложениях, которые это поддерживают; о приложениях, которые не умеют спрашивать, см. Приложения, которые не умеют спрашивать. В вопросе перечислены все операции и их идентификаторы:
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.
См. также
Темы и ключевые слова
Отмечайте сессии и заметки своими темами, используйте ключевые слова, которые ИИ выбирает в каждой сессии, и превращайте полезные ключевые слова в темы.
talkbar-cli
Операции TalkBar из терминала и скриптов с talkbar-cli — той же программой, что обслуживает MCP: команды, параметры, ввод, вывод и коды завершения.