Обзор MCP и CLI
TalkBar может открыть ваше рабочее пространство ИИ-ассистентам, таким как Claude, ChatGPT и Codex, через MCP (Model Context Protocol). Ассистент может искать по вашим сессиям, читать итоги и транскрипты, а если вы разрешите — добавлять заметки, задачи и закладки. Всё работает на вашем компьютере, и вы сами выбираете, что может делать каждый ассистент, в разделе Настройки → Доступ по MCP.
Два способа подключения
Вместе с TalkBar поставляется небольшая программа talkbar-cli, которая устанавливается рядом с приложением. Она даёт два способа выполнять один и тот же набор операций:
| Способ | Кто пользуется | Как работает |
|---|---|---|
| MCP-сервер | ИИ-приложения, поддерживающие MCP. В разделе Доступ по MCP есть готовые настройки для ChatGPT, Claude Desktop, Claude Code, Codex, agy CLI, Grok CLI и OpenCode; для других клиентов, например Cursor, используйте Общий JSON. | ИИ-приложение запускает talkbar-cli serve --transport stdio и общается с ним через стандартный ввод и вывод. Сервер подчиняется всем переключателям в разделе Настройки → Доступ по MCP. |
| Командная строка | Вы, ваши скрипты и ИИ-агенты, которые умеют запускать команды | Вы запускаете talkbar-cli tools call, tools batch или search в терминале. Переключатели раздела «Доступ по MCP» здесь не действуют, потому что выполняется только то, что вы ввели сами. |
Оба способа используют одни и те же данные, одни и те же проверки владельца и одни и те же правила администратора. Оба работают независимо от того, открыто приложение TalkBar или нет. Если приложение открыто, оно обновляет экраны, на которых видно что-либо изменённое ассистентом или скриптом.
Что может ассистент
Ассистент работает со всем, что хранится в TalkBar: сессиями с итогами и транскриптами, заметками, проектами, задачами, карточками знаний, людьми и компаниями, темами, закладками, чатами, документами, запланированными встречами, сериями сессий и экспортом.
| Вид работы | Примеры | По умолчанию |
|---|---|---|
| Чтение | Искать по всему, выводить список сессий за прошлую неделю, читать итоги или полный транскрипт, читать заметку, выводить список открытых задач | Включено (после включения MCP) |
| Изменение | Создать заметку, добавить задачу или закладку (в том числе во время записи), переименовать сессию, отнести её к проекту, одобрить карточку знаний, дать имя участнику или связать участника с человеком, переименовать пространство, обновить имя, email или должность в профиле | Выключено, кроме операций календаря, серий, планировщика и экспорта |
| Удаление | Переместить заметку, сессию, проект или чат в корзину; архивировать карточку, человека, компанию или серию; удалить задачу, тему или закладку | Выключено для вашего содержимого. ИИ-приложение, которое умеет задавать вопросы, всегда просит вас подтвердить удаление; другим приложениям в нём отказывается, если вы не разрешили удаление без подтверждения. |
Изменять участников можно только после окончания записи сессии: ассистент может дать участнику имя, связать его с человеком, который уже есть в TalkBar, или убрать имя. Меняются только имена участников и связи с людьми; сказанное и голосовые данные остаются как есть.
Никакие действия ассистента не удаляют окончательно элементы, которые можно переместить в корзину. Элементы из корзины можно восстановить в приложении, а архивированные элементы остаются доступными для изменения. У задач, тем и закладок корзины нет: удалённый элемент удаляется так же, как в приложении.
Все операции описаны в справочнике операций.
Что всегда остаётся в приложении
Некоторые вещи ассистент не может сделать никогда, какие бы переключатели вы ни включили:
- Начать, приостановить или остановить запись либо управлять текущей сессией.
- Изменить транскрипт.
- Подвести итоги (в том числе заново) или запустить любую из ИИ-функций TalkBar.
- Изменить настройки, в том числе переключатели раздела «Доступ по MCP».
- Удалить что-либо навсегда или очистить корзину.
- Добавить документы или переиндексировать их.
- Создать, переключить или переместить в корзину рабочее пространство (переименовать можно).
При этом ассистент может работать параллельно с идущей записью: читать транскрипт по мере его пополнения и добавлять закладки, задачи и карточки знаний, которые сразу появляются на экране записи.
Конфиденциальность
- Только локально. MCP-сервер — это программа на вашем компьютере, которую запускает ваше ИИ-приложение. Она общается с этим приложением через стандартный ввод и вывод и не открывает сетевых портов. Данные читаются из папки данных TalkBar на этом компьютере.
- Выключено, пока вы не включите. После установки TalkBar доступ по MCP выключен. Пока он выключен, подключённое ИИ-приложение не видит инструментов TalkBar.
- Что получает ассистент. Ассистент получает то же, что TalkBar показывает вам, включая транскрипты. Сессии, отмеченные как «Приватный ИИ», возвращаются с
"private": true, а участники, исключённые из обработки ИИ, помечаютсяexcludedFromAi; они помечаются, а не скрываются. Всё, что читает ассистент, попадает в это ИИ-приложение и к его провайдеру модели на условиях их политики конфиденциальности. Если для какой-то сессии это важно, не включайте переключатели чтения или не подключайте облачное ИИ-приложение. - Решаете вы. У каждой операции свой переключатель. Удаление подтверждается у вас, если ваше ИИ-приложение это поддерживает, а иначе отклоняется, если вы не включили Разрешить удаление без подтверждения. См. Доступ и разрешения.
Пять инструментов вкратце
MCP-клиент видит не по инструменту на каждую операцию, а не больше пяти инструментов, поэтому подключение TalkBar почти не расходует контекст ассистента:
| Инструмент | Что делает |
|---|---|
talkbar_find | Ищет по рабочему пространству по названию и содержимому. Обычно это первый шаг, чтобы получить идентификаторы. |
talkbar_read | Выполняет операции чтения — одну или пакет до 20. |
talkbar_change | Выполняет операции, которые создают или изменяют данные. |
talkbar_delete | Выполняет операции перемещения в корзину, архивации и удаления. Каждый вызов вы подтверждаете. |
talkbar_tools | Выводит список включённых вами операций или аргументы одной операции. |
При подключении TalkBar также передаёт ассистенту несколько строк инструкций: сначала найти идентификаторы, затем читать или изменять, объединять вызовы в пакет через {"calls": [...]} и просить вас включить операции в разделе Настройки → Доступ по MCP. Большинству ассистентов других подсказок не нужно.
Рабочие пространства
Каждая операция работает в одном рабочем пространстве. Без workspaceId TalkBar использует пространство, открытое в приложении в этот момент, поэтому, если вы переключите пространство в приложении, ассистент последует за вами. Операция workspace.list выводит список ваших пространств и отмечает открытое. Ассистент может переименовать пространство (если вы разрешите), но создание, переключение и перемещение пространств в корзину остаются в приложении.