Підключення ШІ-програм (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 servers». Кнопка Копіювати конфігурацію в рядку кожної програми копіює цей запис. На 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 нічого не надсилає в інтернет, коли ним користується ШІ-програма. Сервер відповідає лише програмі, яка його запустила, і ніколи не підключається до інтернету. Пошук використовує вашу модель пошуку, лише якщо вона працює в 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».