# Обзор MCP и CLI

Что MCP-сервер TalkBar и talkbar-cli позволяют ИИ-ассистенту делать с вашими сессиями, заметками и базой знаний и что всегда остаётся только в приложении.

Canonical URL: https://docs.talkbar.ru/mcp/overview


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, или убрать имя. Меняются только имена участников и связи с людьми; сказанное и голосовые данные остаются как есть.

Никакие действия ассистента не удаляют окончательно элементы, которые можно переместить в корзину. Элементы из корзины можно восстановить в приложении, а архивированные элементы остаются доступными для изменения. У задач, тем и закладок корзины нет: удалённый элемент удаляется так же, как в приложении.

Все операции описаны в [справочнике операций](/mcp/operations).

## Что всегда остаётся в приложении

Некоторые вещи ассистент не может сделать никогда, какие бы переключатели вы ни включили:

- Начать, приостановить или остановить запись либо управлять текущей сессией.
- Изменить транскрипт.
- Подвести итоги (в том числе заново) или запустить любую из ИИ-функций TalkBar.
- Изменить настройки, в том числе переключатели раздела «Доступ по MCP».
- Удалить что-либо навсегда или очистить корзину.
- Добавить документы или переиндексировать их.
- Создать, переключить или переместить в корзину рабочее пространство (переименовать можно).

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

## Конфиденциальность

- **Только локально.** MCP-сервер — это программа на вашем компьютере, которую запускает ваше ИИ-приложение. Она общается с этим приложением через стандартный ввод и вывод и не открывает сетевых портов. Данные читаются из папки данных TalkBar на этом компьютере.
- **Выключено, пока вы не включите.** После установки TalkBar доступ по MCP выключен. Пока он выключен, подключённое ИИ-приложение не видит инструментов TalkBar.
- **Что получает ассистент.** Ассистент получает то же, что TalkBar показывает вам, включая транскрипты. Сессии, отмеченные как «Приватный ИИ», возвращаются с `"private": true`, а участники, исключённые из обработки ИИ, помечаются `excludedFromAi`; они помечаются, а не скрываются. Всё, что читает ассистент, попадает в это ИИ-приложение и к его провайдеру модели на условиях их политики конфиденциальности. Если для какой-то сессии это важно, не включайте переключатели чтения или не подключайте облачное ИИ-приложение.
- **Решаете вы.** У каждой операции свой переключатель. Удаление подтверждается у вас, если ваше ИИ-приложение это поддерживает, а иначе отклоняется, если вы не включили **Разрешить удаление без подтверждения**. См. [Доступ и разрешения](/mcp/access-and-permissions).


Приватный режим ИИ оставляет собственный ИИ TalkBar на вашем компьютере. Он не мешает MCP-клиенту прочитать сессию. Модель ассистента работает там, где её запускает ИИ-приложение.


## Пять инструментов вкратце

MCP-клиент видит не по инструменту на каждую операцию, а не больше пяти инструментов, поэтому подключение TalkBar почти не расходует контекст ассистента:

| Инструмент | Что делает |
| --- | --- |
| [`talkbar_find`](/mcp/tools#talkbar_find) | Ищет по рабочему пространству по названию и содержимому. Обычно это первый шаг, чтобы получить идентификаторы. |
| [`talkbar_read`](/mcp/tools#talkbar_read) | Выполняет операции чтения — одну или пакет до 20. |
| [`talkbar_change`](/mcp/tools#talkbar_change) | Выполняет операции, которые создают или изменяют данные. |
| [`talkbar_delete`](/mcp/tools#talkbar_delete) | Выполняет операции перемещения в корзину, архивации и удаления. Каждый вызов вы подтверждаете. |
| [`talkbar_tools`](/mcp/tools#talkbar_tools) | Выводит список включённых вами операций или аргументы одной операции. |

При подключении TalkBar также передаёт ассистенту несколько строк инструкций: сначала найти идентификаторы, затем читать или изменять, объединять вызовы в пакет через `{"calls": [...]}` и просить вас включить операции в разделе **Настройки → Доступ по MCP**. Большинству ассистентов других подсказок не нужно.

## Рабочие пространства

Каждая операция работает в одном рабочем пространстве. Без `workspaceId` TalkBar использует пространство, открытое в приложении в этот момент, поэтому, если вы переключите пространство в приложении, ассистент последует за вами. Операция `workspace.list` выводит список ваших пространств и отмечает открытое. Ассистент может переименовать пространство (если вы разрешите), но создание, переключение и перемещение пространств в корзину остаются в приложении.

## См. также

- [Настройка MCP](/mcp/setup)
- [Доступ и разрешения](/mcp/access-and-permissions)
- [Пять инструментов MCP](/mcp/tools)
- [talkbar-cli](/mcp/cli)
- [Примеры](/mcp/examples)
- [Справочник операций](/mcp/operations)