Подключение ИИ-приложений (MCP)

В Kimiko есть MCP-сервер: через него ИИ-приложения на вашем компьютере могут искать по встречам, читать заметки и расшифровки и работать с задачами. MCP (Model Context Protocol) — открытый стандарт, через который ИИ-приложения подключаются к инструментам.

Сервер kimiko-mcp входит в состав Kimiko и работает на вашем компьютере. ИИ-приложение запускает сервер, когда он нужен, а когда приложение закрывает соединение, сервер останавливается. Онлайн-версии сервера нет, поэтому подключиться могут только приложения на том же компьютере.

Что может ИИ-приложение

Подключенное приложение получает десять инструментов. Восемь из них читают вашу библиотеку, а два изменяют задачи.

Инструмент	Что делает
list_meetings	Выводит список встреч и заметок (сначала новые) с отбором по дате, проекту или типу
search_meetings	Ищет по расшифровкам, заметкам, сводкам и названиям и возвращает найденные моменты с отметками времени
get_meeting	Показывает сведения о встрече: кто был приглашен и кто говорил, а также последнюю сводку
get_notes	Читает то, что вы написали, доработанную версию, если вы ее создавали, и сводки в реальном времени
get_transcript	Читает расшифровку постранично, чтобы длинная встреча не перегружала приложение
get_screenshots	Читает текст, найденный Kimiko на снимках экрана со звонка, но никогда не сами изображения
list_tasks	Выводит список задач с их встречей и проектом; выполненные задачи — только по запросу приложения
list_projects	Выводит список проектов и число задач в каждом
create_task	Добавляет задачу
update_task	Изменяет задачу, переводит ее в другой статус или проект или отмечает выполненной

Поиск всегда идет по ключевым словам. Если ваша модель поиска работает в Ollama или на другом локальном сервере на вашем компьютере, поиск учитывает и смысл. Со встроенной конфигурацией ИИ-приложения ищут по ключевым словам. Подробнее — в разделе «Поиск в чате».

Готовые промпты

Kimiko также предлагает три готовых промпта. Приложения, которые поддерживают промпты MCP, показывают их в виде команд с косой чертой или в меню промптов.

• weekly_review: обзор прошедшей недели или более долгого периода, до 90 дней. В нем решения, обязательства, нерешенные вопросы и открытые задачи по проектам. Аргумент days задает период: от 1 до 90 дней (по умолчанию 7).
• meeting_prep: памятка для подготовки к встрече по человеку или теме — контекст, обязательства обеих сторон, нерешенные вопросы и то, о чем стоит спросить. Аргумент person_or_topic обязателен.
• open_loops: просроченные задачи, а также обязательства за последние две недели, которые так и не стали задачами. Необязательный аргумент project (название или идентификатор проекта) ограничивает промпт одним проектом. Этот промпт просит приложение создавать задачу только после вашего подтверждения.

В Claude Code введите / и выберите Kimiko:meeting_prep (MCP) или введите /mcp__Kimiko__meeting_prep Anna. Claude Code разделяет аргументы по пробелам, поэтому указывайте там человека или тему одним словом.

Чего приложение никогда не сможет

Kimiko не дает ИИ-приложениям возможности:

• начинать или останавливать запись;
• удалять задачи, встречи или заметки;
• создавать или удалять проекты;
• изменять ваши заметки;
• открывать аудио или изображения снимков экрана;
• читать ваши настройки или API-ключи.

Если параметр Разрешить изменять задачи включен, приложение все же может изменить задачу, в том числе стереть ее описание, исполнителя или даты.

Включите доступ

Доступ выключен, пока вы сами его не включите.

1. Откройте Настройки → Подключения.
2. В карточке MCP-сервер включите Разрешить доступ ИИ-приложениям.

Пока доступ включен, любое приложение на вашем компьютере, которое запускает MCP-сервер Kimiko, может читать ваши встречи. Любое действие добавления или копирования в разделе Настройки → Подключения само включает доступ, и Kimiko сообщает, когда это происходит.

Параметр Разрешить изменять задачи в карточке Что могут приложения по умолчанию включен. Он позволяет приложениям создавать и обновлять задачи. Если его выключить, приложения смогут читать задачи, но не изменять их: Kimiko сразу начнет отклонять create_task и update_task и не будет включать их в список инструментов, который приложение загрузит после этого.

Если выключить или включить Разрешить доступ ИИ-приложениям, изменение подействует со следующего запроса подключенного приложения. Если приложение пыталось запустить Kimiko, пока доступ был выключен, перезапустите это приложение. Изменение параметра Разрешить изменять задачи тоже действует со следующего запроса, но приложение продолжает использовать список инструментов, загруженный при подключении, пока вы его не перезапустите или не переподключите.

Подключите приложение

На Mac разрешите серверу Kimiko использовать связку ключей до первого подключения приложения, чтобы разовый запрос macOS не спрятался за окном приложения. В строке Доступ к связке ключей нажмите Разрешить сейчас, а затем — Разрешать всегда. Когда доступ включен, эта строка находится в карточке MCP-сервер, а иначе — в карточке Справка. Подробнее — в разделе «Запрос доступа к связке ключей в macOS».

Карточка ИИ-приложения в разделе Настройки → Подключения подключает эти приложения за вас:

• Claude (приложение для компьютера): нажмите Добавить в Claude. Kimiko покажет, что запишет в файл настроек Claude, сначала сохранит резервную копию и не тронет остальные ваши настройки. Нажмите Добавить, а затем полностью завершите Claude и откройте его снова: Claude читает настройки только при запуске. На Mac выберите Claude → Quit Claude, в Windows щелкните правой кнопкой мыши значок Claude в области уведомлений и выберите Quit. Просто закрыть окно недостаточно.
• Claude Code: нажмите Добавить в Claude Code, чтобы добавить Kimiko для всех ваших проектов, а затем начните новый сеанс Claude Code. Если Kimiko не находит команду claude, в строке вместо этого будет кнопка Копировать команду. Выполните команду в Терминале на Mac или в терминале в Windows.
• Cursor: нажмите Добавить в Cursor. Cursor откроет собственное окно установки с уже заполненными данными Kimiko — подтвердите установку там.
• VS Code: нажмите Добавить в VS Code, чтобы открыть в VS Code страницу установки Kimiko, а затем подтвердите установку. Инструменты Kimiko работают в режиме агента GitHub Copilot.
• LM Studio (версии 0.3.17 или новее): откройте Другие приложения и нажмите Добавить в LM Studio. LM Studio откроет собственное окно с уже заполненными данными Kimiko — подтвердите добавление там.

У остальных приложений в списке Другие приложения есть кнопка Копировать команду, Копировать конфиг или Копировать путь: это ChatGPT и Codex, Gemini CLI, Raycast, Zed, Windsurf и Warp. Каждая кнопка копирует готовый фрагмент с точным путем для вашего компьютера.

Добавьте Kimiko вручную

Все приложения ниже запускают один и тот же сервер с именем Kimiko, без аргументов и переменных окружения.

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

В примерах указан путь к серверу на Mac, когда Kimiko находится в папке «Программы»:

/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp

Если Kimiko находится в другом месте, возьмите вместо этого фрагмент из раздела Настройки → Подключения: в нем всегда правильный путь для запущенной у вас копии Kimiko. Чтобы скопировать только путь, откройте Другие приложения и нажмите Копировать путь в строке Raycast.

В Windows кнопки Добавить в Claude и Добавить в Cursor подставляют путь за вас. Чтобы настроить любое из этих приложений вручную, нажмите Копировать конфиг в строке Windsurf или Warp в списке Другие приложения: так копируется та же запись mcpServers с экранированным путем. У Zed есть своя кнопка Копировать конфиг, как и у строки ChatGPT и Codex — в ее меню ⋯. Если вы сами вводите путь Windows в JSON или TOML, удваивайте каждую обратную косую черту (C:\\Users\\…\\kimiko-mcp.exe). В Windows ~ в путях ниже означает вашу папку пользователя (%USERPROFILE%).

Claude (приложение для компьютера)

Добавьте эту запись в файл настроек Claude — ~/Library/Application Support/Claude/claude_desktop_config.json на Mac или %APPDATA%\Claude\claude_desktop_config.json в Windows, — сохранив другие серверы, которые у вас уже есть. На Mac запись выглядит так:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

В Windows сервер — это файл kimiko-mcp.exe рядом с kimiko-app.exe; скопируйте точный путь к нему в разделе Настройки → Подключения.

Затем полностью завершите Claude и откройте его снова: на Mac выберите Claude → Quit Claude, в Windows щелкните правой кнопкой мыши значок Claude в области уведомлений и выберите Quit. Просто закрыть окно недостаточно. После этого инструменты и промпты Kimiko появятся в Claude.

Claude Code

На Mac выполните в терминале:

claude mcp add --scope user --transport stdio Kimiko -- "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

--scope user добавляет Kimiko для всех проектов. Чтобы вместо этого добавить его в .mcp.json текущего проекта, используйте --scope project. Команда claude mcp list показывает, подключился ли сервер, а /mcp внутри сеанса выводит список инструментов.

Cursor

На Mac добавьте в ~/.cursor/mcp.json ту же запись mcpServers, что и для Claude:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

VS Code

Добавьте Kimiko в пользовательский файл mcp.json (~/Library/Application Support/Code/User/mcp.json или %APPDATA%\Code\User\mcp.json в Windows). На Mac запись выглядит так:

{
  "servers": {
    "Kimiko": {
      "type": "stdio",
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

Или на Mac добавьте его из терминала:

code --add-mcp '{"name":"Kimiko","command":"/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp","args":[]}'

ChatGPT и Codex

Codex в приложении ChatGPT для компьютера и Codex CLI используют общий файл ~/.codex/config.toml. Kimiko работает в Codex, но не в обычных чатах ChatGPT. На Mac запись выглядит так:

[mcp_servers.Kimiko]
command = "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Или на Mac выполните:

codex mcp add Kimiko -- "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Gemini CLI

На Mac эта команда добавит Kimiko в ~/.gemini/settings.json:

gemini mcp add -s user Kimiko "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"

Zed

Добавьте запись context_servers в файл настроек Zed (~/.config/zed/settings.json на Mac, %APPDATA%\Zed\settings.json в Windows). На Mac запись выглядит так:

{
  "context_servers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp",
      "args": []
    }
  }
}

Raycast

В Raycast выполните команду Install MCP Server, выберите транспорт Standard Input/Output (stdio) и вставьте путь к серверу в качестве команды. Путь копирует кнопка Другие приложения → Raycast → Копировать путь.

Windsurf и Warp

Оба приложения принимают ту же запись mcpServers, что и Claude. Для Windsurf добавьте ее в ~/.codeium/windsurf/mcp_config.json. Для Warp добавьте ее в настройках Warp: раздел AI, затем MCP-серверы. Скопировать запись можно кнопкой Копировать конфиг в строке каждого приложения. На Mac запись выглядит так:

{
  "mcpServers": {
    "Kimiko": {
      "command": "/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp"
    }
  }
}

Любое другое приложение

Добавьте локальный MCP-сервер с транспортом stdio и именем Kimiko, указав в качестве команды путь к серверу, без аргументов. Включите Разрешить доступ ИИ-приложениям, а затем на Mac разрешите доступ к связке ключей при первом подключении приложения (см. ниже).

Чтобы проверить сервер из терминала, запустите его с параметром --check. При проверке сервер открывает вашу библиотеку, но ничего не отдает приложениям, а на Mac может показать запрос доступа к связке ключей. На Mac выполните:

"/Applications/Kimiko.app/Contents/MacOS/kimiko-mcp" --check

В Windows выполните в PowerShell & "<path to kimiko-mcp.exe>" --check, подставив путь из раздела Настройки → Подключения.

Если Kimiko может прочитать вашу библиотеку, проверка выводит ok. Параметр Разрешить доступ ИИ-приложениям она не проверяет, а приложениям он все равно нужен. Если что-то не так, вместо этого выводится причина — например, проблема со связкой ключей или с базой данных.

Приложения, которые не могут подключиться

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

В приложении ChatGPT для компьютера Kimiko работает в Codex, но не в обычных чатах.

Запрос доступа к связке ключей в macOS

Kimiko хранит ключ шифрования вашей библиотеки в связке ключей macOS. Когда kimiko-mcp впервые читает его, macOS спрашивает, можно ли ему использовать вашу связку ключей. Выберите Разрешать всегда.

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

После обновления Kimiko macOS может спросить снова. Если вы выбрали Отказать, откройте приложение «Связка ключей», найдите app.kimiko.db, удалите kimiko-mcp на вкладке «Доступ», а затем нажмите Попробовать снова в этой строке.

Диспетчер учетных данных в Windows

В Windows ключ хранится в Диспетчере учетных данных для вашей учетной записи Windows, поэтому запроса нет. Кнопка Проверить сейчас в строке Диспетчер учетных данных в карточке Справка подтверждает, что приложения могут его прочитать.

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

Когда ИИ-приложение пользуется Kimiko, сам Kimiko ничего не отправляет в интернет. Сервер отвечает только приложению, которое его запустило, и никогда не подключается к интернету. Поиск использует вашу модель поиска, только если она работает в Ollama или на другом локальном сервере на вашем компьютере.

То, что читает приложение, обрабатывают это приложение и его провайдер ИИ. Облачное ИИ-приложение отправляет прочитанное, включая текст расшифровок, своему провайдеру моделей на условиях этого приложения. Приложение с локальной моделью может оставить эти данные на вашем компьютере. Режим «только локально» управляет собственными подключениями Kimiko; он не мешает подключенному приложению отправлять то, что оно прочитало.

Сведения о встрече могут включать данные из вашего календаря, например название события и приглашенных — с их именами и адресами электронной почты. Облачное ИИ-приложение отправляет их своему провайдеру, как и все остальное, что оно читает.

История подключений в карточке Справка показывает, какие приложения и когда использовали Kimiko. В ней хранятся только названия и версии приложений, время, количество обращений и последний использованный инструмент — и никогда не содержание запросов. Записи, которые не использовались 90 дней, удаляются.

Что Kimiko хранит и отправляет, описано в статье «Конфиденциальность и данные».

Содержимому встреч нельзя доверять

Любой участник встречи может произнести слова, обращенные к ИИ-приложению, например «игнорируй свои инструкции», а на демонстрируемом экране может появиться такой текст. Сводки встречи могут их повторить, а название встречи из чужого приглашения в календаре тоже может их содержать. Kimiko указывает приложению считать текст расшифровок, текст с экрана и сводки данными — и никогда инструкциями.

И все же проверяйте, что предлагает приложение, прежде чем действовать. Если ваше приложение умеет вызывать инструменты без подтверждения, оставьте подтверждение для create_task и update_task: изменение может переименовать задачу, перенести ее или стереть ее описание и даты. Удалять задачи Kimiko приложениям никогда не позволяет. Если хотите, чтобы приложения только читали, выключите Разрешить изменять задачи.

Отключите доступ ИИ-приложений

Выключите Разрешить доступ ИИ-приложениям в разделе Настройки → Подключения. Все приложения сразу потеряют доступ, а подключенное приложение при следующем запросе получит ошибку agent access is off.

Чтобы убрать Kimiko из приложения, удалите запись Kimiko из настроек этого приложения. Для Claude Code выполните:

claude mcp remove Kimiko

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

Самые частые из этих решений перечислены в пункте Справка → Не подключается? в разделе Настройки → Подключения.

Проблема	Решение
Приложение сообщает, что Kimiko не запустился или отключился, или показывает agent access is off	Включите Разрешить доступ ИИ-приложениям и перезапустите приложение. Если причина была в доступе, в журнале приложения будет agent access is off (где журнал Claude, указано ниже; для Claude Code выполните claude mcp get Kimiko).
Первое подключение на Mac зависает	Запрос доступа к связке ключей может прятаться за окном приложения. Выберите Разрешать всегда или заранее воспользуйтесь кнопкой Разрешить сейчас.
Claude Code прекращает попытки через 30 секунд	Запустите его командой MCP_TIMEOUT=60000 claude (в PowerShell — $env:MCP_TIMEOUT=60000; claude) или заранее воспользуйтесь кнопкой Разрешить сейчас. Сообщения сервера показывает claude mcp get Kimiko.
Kimiko не появляется в Claude	Полностью завершите Claude и откройте его снова: просто закрыть окно недостаточно. Журнал Claude: ~/Library/Logs/Claude/mcp-server-Kimiko.log (в Windows — %APPDATA%\Claude\logs\mcp-server-Kimiko.log).
Только восемь инструментов, без create_task и update_task	Включите Разрешить изменять задачи и перезапустите приложение (в Claude Code переподключите Kimiko через /mcp или начните новый сеанс).
Вы переместили Kimiko, или в строке Claude написано Требуется обновление	Нажмите Обновить в строке Claude, затем завершите Claude и откройте его снова. Для других приложений добавьте Kimiko заново или снова скопируйте фрагмент из раздела Настройки → Подключения.
Kimiko сообщает, что файл настроек Claude содержит ошибки	Исправьте или удалите файл, затем снова нажмите Добавить в Claude. Если вы правили файл вручную, поищите пропущенную запятую или одиночную обратную косую черту в пути Windows.
В разделе Настройки → Подключения сказано, что часть Kimiko отсутствует	Переустановите Kimiko.
Поиск ничего не находит	Попросите приложение расширить диапазон дат, выбрать другой проект или тип либо просмотреть встречи с помощью list_meetings.
Поиск пропускает встречу	Используйте слова, которые звучали на встрече. Приложения ищут по ключевым словам, если ваша модель поиска не работает на локальном сервере.
Сервер сразу останавливается и сообщает, что база данных не найдена	Откройте Kimiko хотя бы раз, чтобы он создал вашу библиотеку.
В строке Доступ к связке ключей написано «Отказано»	Выполните шаги из раздела «Запрос доступа к связке ключей в macOS».