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

Перед началом

TalkBar установлен на этом компьютере.
Ваше ИИ-приложение поддерживает локальные MCP-серверы (такие, которые запускают программу на вашем компьютере; их часто называют серверами stdio).
Если TalkBar управляет ваша организация, MCP может быть для вас отключён. См. Правила администратора.

Включение MCP

Откройте Настройки → Доступ по MCP.
Включите переключатель в правом верхнем углу страницы. Надпись сменится с Отключено на Включено.
Посмотрите на значок рядом с заголовком страницы:

Значок	Что означает
Готово	TalkBar нашёл `talkbar-cli`, и программа ответила. Можно подключать приложение.
Отсутствует	TalkBar не нашёл `talkbar-cli`. Переустановите TalkBar.
Ошибка	`talkbar-cli` найден, но не запустился. Над страницей показано предупреждение с текстом ошибки.
Отключено	MCP выключен. Подключённые приложения не видят инструментов TalkBar.

Когда MCP включён, чтение разрешено, а большинство изменений — нет. Это можно изменить позже, см. Доступ и разрешения.

Скопируйте настройки для своего приложения

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

Все варианты настроек делают одно и то же: говорят приложению запускать talkbar-cli с аргументами serve --transport stdio и задают в TALKBAR_DATA_ROOT вашу папку данных TalkBar.

В примерах указаны условные пути к программе и папке данных. Замените их путями из раздела Доступ по MCP или скопируйте готовые настройки из TalkBar. Имя программы и пути зависят от операционной системы. В путях JSON экранируйте обратные косые черты или используйте прямые, если они поддерживаются.

Скопируйте JSON и добавьте его в файл конфигурации Claude Desktop claude_desktop_config.json (в Claude Desktop: Settings → Developer → Edit Config). Если в файле уже есть раздел mcpServers, добавьте запись talkbar внутрь него. Затем закройте и снова откройте Claude Desktop.

claude_desktop_config.json

{
  "mcpServers": {
    "talkbar": {
      "command": "PATH_TO_TALKBAR_CLI",
      "args": [
        "serve",
        "--transport",
        "stdio"
      ],
      "env": {
        "TALKBAR_DATA_ROOT": "PATH_TO_TALKBAR_DATA"
      }
    }
  }
}

Добавив TalkBar, перезапустите приложение или перезагрузите его MCP-серверы. Затем для проверки подключения спросите что-нибудь вроде «Какие сессии TalkBar были у меня на этой неделе?». Больше примеров — в разделе Примеры.

Копирование команды запуска сервера

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

После запуска сервер ждёт MCP-клиента на стандартном вводе. Чтобы остановить его, нажмите Ctrl+C.

Где установлен talkbar-cli

talkbar-cli устанавливается вместе с TalkBar. Карточка Настройки сервера в разделе Доступ по MCP показывает:

Параметр	Что показывает
Путь к исполняемому файлу	Полный путь к `talkbar-cli`. Копировать копирует его.
Добавить в PATH	Копирует команду для добавления папки программы в PATH. Выполните команду для вашей системы и откройте новый терминал, чтобы запускать `talkbar-cli` по имени.
Папка данных	Ваша папка данных TalkBar. Копировать копирует путь к ней.

TALKBAR_DATA_ROOT

TALKBAR_DATA_ROOT сообщает talkbar-cli, какую папку данных TalkBar открыть. Готовые настройки TalkBar всегда указывают в ней папку, которую использует приложение, — она показана в поле Папка данных.

Папка данных по умолчанию — %LOCALAPPDATA%\TalkBar. Текущий путь указан в поле Папка данных.

Указывайте в ней только папку данных TalkBar. В папке без данных TalkBar будет создана новая пустая база данных, и ассистент увидит пустое пространство.
Чтобы открыть файл базы данных напрямую из командной строки, используйте --db. См. talkbar-cli.

После обновления TalkBar

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

Устранение неполадок

Проблема	Что попробовать
Приложение не показывает инструментов TalkBar	Проверьте, что в разделе Доступ по MCP выбрано Включено. Если приложение подключилось, пока MCP был выключен, перезапустите приложение или заново подключите TalkBar.
Ассистент сообщает, что операция «is turned off in TalkBar»	Включите эту операцию в разделе Доступ по MCP. См. Доступ и разрешения.
Ассистент видит пустое пространство	Проверьте, что `TALKBAR_DATA_ROOT` в настройках приложения совпадает с полем Папка данных в разделе Доступ по MCP. Если вы перемещали данные, скопируйте настройки заново.
Удаление отклоняется с `confirmation_unavailable`	Ваше приложение не умеет запрашивать подтверждение. См. Подтверждение удаления.
Значок показывает Отсутствует	TalkBar не может найти `talkbar-cli`. Переустановите TalkBar.
Страница заблокирована с уведомлением от вашей организации	Администратор отключил MCP-сервер или инструмент командной строки на этом компьютере.

См. также

Обзор MCP и CLI

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

Пять инструментов MCP

Как работают talkbar_find, talkbar_read, talkbar_change, talkbar_delete и talkbar_tools: аргументы, пакеты, аннотации, страницы и сообщения.

Настройка MCP