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

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

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

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

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

  • Выключен: подключённое приложение не видит инструментов TalkBar, и каждая операция отвечает, что она выключена. Переключатели разрешений ниже недоступны.
  • Включён: подключённое приложение видит инструменты TalkBar и может выполнять включённые вами операции.

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

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

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

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

Рядом с каждым переключателем строки счётчик, например 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.

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

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.

См. также