Використовуйте записи Vocatim у застосунках ШІ на своєму Mac

Спочатку у Vocatim

На Mac відкрийте Параметри → Дані та пристрої → Застосунки ШІ на цьому Mac і ввімкніть функцію. Прочитайте екран, який пояснює, що бачить застосунок ШІ, а потім натисніть Увімкнути. Далі виконайте кроки для свого застосунку ШІ.

Claude Desktop

1. Натисніть Установити в Claude Desktop і збережіть файл Vocatim.mcpb у будь-якому зручному місці, наприклад у папці Викачане. Щойно файл буде збережено, Vocatim скопіює ключ Vocatim.
2. Відкрийте файл Vocatim.mcpb. Claude Desktop покаже розширення Vocatim і запитає, чи встановити його.
3. Коли Claude Desktop попросить ключ, вставте його в поле Ключ Vocatim. Поле Програма vocatim-mcp залиште без змін.
4. У новому чаті запитайте, наприклад: «Що ми вирішили в моєму останньому записі у Vocatim?» Claude може попросити вас дозволити інструмент Vocatim.

Бажаєте змінити конфігурацію самостійно? Натисніть Скопіювати налаштування для Claude Desktop. У Claude Desktop відкрийте меню Claude на смузі меню macOS (не налаштування у вікні Claude) і виберіть Settings… → Developer → Edit Config. Якщо у файлі ще немає "mcpServers", замініть його вміст повним прикладом нижче. Якщо в ньому вже є сервери, вставте лише запис "vocatim" всередину "mcpServers", поставивши кому між ним і попереднім записом. Збережіть файл, повністю закрийте Claude Desktop і відкрийте його знову.

{
  "mcpServers": {
    "vocatim": { … paste from Vocatim … }
  }
}

ChatGPT і Codex

1. Натисніть Скопіювати налаштування для ChatGPT і Codex.
2. Відкрийте файл ~/.codex/config.toml у текстовому редакторі або створіть його, якщо його ще немає. ~/.codex — це прихована папка у вашій домашній папці: у Finder виберіть Перейти → Перейти до папки… і введіть ~/.codex.
3. Якщо у файлі немає розділу [mcp_servers.vocatim], вставте налаштування з нового рядка в кінці файлу. Якщо такий розділ уже є з попереднього налаштування, замініть увесь цей розділ новим. Розділ не повинен бути у файлі двічі.
4. Збережіть файл і перезапустіть ChatGPT або Codex.
5. У новому чаті запитайте, наприклад: «Що ми вирішили в моєму останньому записі у Vocatim?» У ChatGPT використовуйте Vocatim у розмові Codex, а не у звичайному чаті.

[mcp_servers.vocatim]
command = "/Applications/Vocatim.app/Contents/MacOS/vocatim-mcp"
args = ["--port", "…", "--token", "…"]

codex mcp list показує ключ Vocatim у стовпці Args. Ключ дозволяє читати Vocatim лише застосункам на цьому Mac і лише тоді, коли Vocatim відкритий. Не діліться результатом цієї команди; якщо ви вже це зробили, скористайтеся «Скинути ключ» у Vocatim.

VS Code, Cursor і LM Studio

1. Натисніть Установити в VS Code, Додати до Cursor або Додати до LM Studio. Vocatim відкриє цей застосунок із налаштуваннями для Vocatim.
2. У застосунку підтвердьте, що хочете додати Vocatim.
3. Для VS Code Vocatim скопіює ключ Vocatim: коли VS Code попросить Ключ Vocatim, вставте його. Cursor і LM Studio отримують ключ разом із налаштуваннями та зберігають його у власних параметрах.
4. У чаті ШІ цього застосунку запитайте, наприклад: «Що ми вирішили в моєму останньому записі у Vocatim?»

Інші застосунки: Cursor, LM Studio, JetBrains AI Assistant і Junie

1. Натисніть Скопіювати налаштування для інших застосунків.
2. Відкрийте параметри MCP застосунку: у Cursor — файл ~/.cursor/mcp.json, у LM Studio — його файл mcp.json, у JetBrains AI Assistant — Settings → Tools → AI Assistant → MCP і Add, у Junie — файл ~/.junie/mcp/mcp.json.
3. Якщо там ще немає "mcpServers", вставте налаштування повністю. Якщо сервери вже є, додайте лише запис "vocatim" всередину "mcpServers" або замініть ним старий запис "vocatim". Запис не повинен бути там двічі.
4. Збережіть і перезапустіть застосунок.

Zed

1. Натисніть Скопіювати налаштування для Zed.
2. У Zed виконайте команду zed: open settings file.
3. Вставте частину "context_servers" у зовнішні фігурні дужки цього файлу. Якщо "context_servers" там уже є, додайте в цю частину лише запис "vocatim" або замініть ним старий запис "vocatim". Запис не повинен бути там двічі.
4. Збережіть файл і перезапустіть Zed.

Vocatim у Терміналі (командний рядок)

Ви також можете читати свої записи в Терміналі на цьому Mac тими самими чотирма інструментами лише для читання, які отримують застосунки ШІ: список, пошук, транскрипція і підсумок. Командний рядок використовує той самий перемикач і той самий ключ Vocatim, що й ваші застосунки ШІ, і працює лише тоді, коли Vocatim відкритий, а перемикач увімкнено.

1. Скопіюйте цю команду й вставте її у вікно Терміналу, але поки що не натискайте клавішу Return:

   printf '\n%s\n' "$(pbpaste | grep -m 1 '^alias vocatim=')" >> ~/.zshrc

2. У Vocatim натисніть Скопіювати команду CLI. Vocatim копіює один рядок: псевдонім із назвою vocatim для zsh, стандартної оболонки macOS.
3. Поверніться до Терміналу й натисніть Return. Команда додає скопійований рядок у кінець файлу ~/.zshrc, який zsh читає щоразу, коли ви відкриваєте вікно Терміналу. Вона додає лише рядок, що починається з alias vocatim=, тож ніщо інше з буфера обміну не потрапляє у файл.
4. Відкрийте нове вікно Терміналу й введіть vocatim list. Псевдонім працює у вікнах, які ви відкриєте після кроку 3.

Чотири команди:

• vocatim list показує 20 ваших найновіших записів, по одному в рядку: ідентифікатор, дату й час, тривалість і назву. vocatim list --limit 50 показує до 50.
• vocatim search бюджет знаходить записи, у назві, транскрипції, підсумку, нотатках або перекладі яких є «бюджет». Запит із пробілами візьміть у лапки: vocatim search "щотижневий огляд". Команда показує до 10 результатів або до 20 з --limit 20.
• vocatim transcript <id> виводить повну транскрипцію одного запису. Ідентифікатор є в першому стовпці результату vocatim list і vocatim search.
• vocatim summary <id> виводить його підсумок.

Додайте --json до будь-якої команди, щоб отримати JSON для власних скриптів. vocatim help показує список команд.

Ваш ключ. Рядок vocatim у ~/.zshrc містить ваш ключ Vocatim. Якщо вставити цей рядок безпосередньо в Термінал, ключ також залишиться в історії Терміналу. Ключ дозволяє читати Vocatim лише застосункам на цьому Mac і лише тоді, коли Vocatim відкритий. Не діліться цим рядком чи файлом; якщо ви вже це зробили, скористайтеся «Скинути ключ» у Vocatim.

Після «Скинути ключ» або коли Vocatim показує «Налаштування змінилися: налаштуйте застосунки ШІ знову.», старий рядок перестає працювати. Повторіть кроки 1–4. Діє найновіший рядок vocatim у ~/.zshrc; старіші можна видалити.

Після команди пункт Застосунки ШІ на цьому Mac у Параметрах Vocatim показує vocatim-cli, так само як назву застосунку ШІ.

Командний рядок зв’язується лише з Vocatim на цьому Mac і виводить результат у вікні Терміналу. Якщо ви передасте цей результат далі, наприклад онлайн-сервісу ШІ, він потрапить туди.

Щоб його видалити, видаліть усі рядки vocatim з ~/.zshrc; після повторення кроків 1–4 їх може бути кілька. Він також перестає працювати, якщо вимкнути перемикач у Vocatim або скористатися «Скинути ключ».

Якщо не працює: повідомлення командного рядка Vocatim починаються з vocatim-mcp:.

• vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings. (Vocatim не відкритий на цьому Mac, або доступ застосунків ШІ вимкнено в Параметрах Vocatim): відкрийте Vocatim і перевірте перемикач. Після «Скинути ключ» або «Налаштування змінилися» повторіть кроки 1–4. Рядок над цим повідомленням, якщо він є, вказує технічну причину, наприклад vocatim-mcp: connect: Connection refused.
• zsh: command not found: vocatim: відкрийте нове вікно Терміналу. Якщо повідомлення не зникає, перевірте, чи є в ~/.zshrc рядок, що починається з alias vocatim=; якщо немає, повторіть кроки 1–4. Також перевірте, чи echo $SHELL показує /bin/zsh.
• zsh: no such file or directory зі шляхом до vocatim-mcp: рядок указує на місце, де Vocatim уже немає, наприклад після того, як ви перемістили застосунок. Повторіть кроки 1–4.
• vocatim-mcp: Too many requests, try again in a moment. (забагато запитів, спробуйте трохи пізніше): зачекайте трохи й запустіть команду знову.
• vocatim без команди, наприклад vocatim або vocatim --json, чекає й нічого не показує: натисніть Control-C, а потім введіть команду, наприклад vocatim list.

Для скриптів: дані потрапляють у стандартний вивід, повністю й лише тоді, коли команда виконується успішно; повідомлення потрапляють у стандартний потік помилок. З --json кожна відповідь Vocatim — це один рядок JSON, тож transcript виводить по одному рядку на кожну сторінку довгої транскрипції: читайте результат рядок за рядком, а не як один документ JSON. Коди завершення: 0 готово, 1 інша помилка, 2 неправильна команда чи параметр, 3 Vocatim не відкритий або доступ вимкнено, 4 забагато запитів.

Що виходить за межі вашого Mac

Доступ застосунків ШІ до ваших записів типово вимкнено. Ви вмикаєте його самі в Параметрах Vocatim, лише якщо вирішите поділитися своїми транскрипціями із застосунками ШІ на цьому Mac.

Сам Vocatim нічого не надсилає. Якщо застосунок ШІ використовує онлайн-модель, як зазвичай роблять Claude Desktop, ChatGPT і Codex, те, що він прочитає з Vocatim, надсилається цій компанії (Anthropic або OpenAI) під вашим обліковим записом у ній, так, ніби ви вставили це в чат.

Як це зупинити

Вимкніть перемикач у Vocatim. Кнопка Скинути ключ робить недійсними всі ключі, які ви скопіювали, і всі налаштування, які ви вставили. Щоб під’єднатися знову, налаштуйте застосунок ШІ ще раз. Для розширення в Claude Desktop знову натисніть Установити в Claude Desktop у Vocatim, збережіть файл і відкрийте його: щойно файл буде збережено, Vocatim скопіює новий ключ. Вставте його, коли Claude Desktop попросить, або в поле Ключ Vocatim розширення Vocatim у Claude Desktop. Для Cursor і LM Studio знову натисніть Додати до Cursor або Додати до LM Studio. Якщо ви вставляли налаштування вручну, скопіюйте їх знову й вставте замість старого запису чи розділу. Потім повністю закрийте застосунок ШІ (закрити його вікно недостатньо) і відкрийте його знову: доти він і далі використовує старий ключ. Ви також можете видалити Vocatim із застосунку ШІ: розширення Vocatim у Claude Desktop, запис "vocatim" у його конфігурації, у параметрах MCP іншого застосунку чи у файлі налаштувань Zed або розділ [mcp_servers.vocatim] у файлі ~/.codex/config.toml.

Якщо не працює

• «Vocatim не відкритий на цьому Mac, або доступ застосунків ШІ вимкнено в Параметрах Vocatim.»: відкрийте Vocatim і перевірте перемикач. Після «Скинути ключ» налаштуйте застосунок ШІ ще раз, потім повністю закрийте його (закрити його вікно недостатньо) і відкрийте знову.
• Vocatim показує «Налаштування змінилися: налаштуйте застосунки ШІ знову.»: налаштуйте кожен застосунок ШІ знову, як описано вище, замість старого запису чи розділу, і перезапустіть його.
• Vocatim показує «Програма не відкрилася. Чи встановлено її на цьому Mac?»: установіть цей застосунок на цей Mac. Для Cursor і LM Studio також можна скористатися кнопкою Скопіювати налаштування для інших застосунків.
• ChatGPT або Codex перестає працювати чи повідомляє про помилку в config.toml після того, як ви вставили налаштування вдруге: у файлі два розділи [mcp_servers.vocatim]. Залиште лише найновіший.
• Codex повідомляє, що інструмента Vocatim немає: почніть нову розмову в проєкті, папка якого є на цьому Mac (проєкт, синхронізований з іншого комп’ютера, може не мати тут папки).
• Ви відкрили застосунок ШІ раніше за Vocatim: перезапустіть застосунок ШІ, коли Vocatim відкритий.
• Бракує запису: записи в кошику та записи-приклади не показуються, а новий запис з’являється лише тоді, коли його транскрибування завершиться або буде зупинене. Запис, який транскрибовано не повністю, є у списку, але його транскрипція й підсумок недоступні, доки його не буде транскрибовано повністю.