在 Mac 上的 AI 應用程式中使用你的 Vocatim 錄音

首先，在 Vocatim 中

在 Mac 上打開設定 → 資料與裝置 → 這台 Mac 上的 AI 應用程式並將其開啟。閱讀說明 AI 應用程式可以看到哪些內容的畫面，然後按一下開啟。接著依照你所用 AI 應用程式的步驟操作。

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 中，打開 macOS 選單列中的 Claude 選單（不是 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 中，請在 Codex 對話中使用 Vocatim，而不是在一般聊天中。

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

codex mcp list 會在 Args 欄中顯示 Vocatim 金鑰。這個金鑰只能讓這台 Mac 上的應用程式讀取 Vocatim，而且只在 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. 在該應用程式的 AI 聊天中提問，例如「在我 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"，請貼上整份設定。如果已列有伺服器，只要在 "mcpServers" 內加入 "vocatim" 項目，或用它取代舊的 "vocatim" 項目。同一個項目不能出現兩次。
4. 儲存後，重新啟動該應用程式。

Zed

1. 按一下拷貝 Zed 的設定。
2. 在 Zed 中執行 zed: open settings file。
3. 將 "context_servers" 這部分放進該檔案最外層的大括號內。如果 "context_servers" 已經存在，只要在其中加入 "vocatim" 項目，或用它取代舊的 "vocatim" 項目。同一個項目不能出現兩次。
4. 儲存檔案，然後重新啟動 Zed。

在「終端機」中使用 Vocatim（命令列）

你也可以在這台 Mac 的「終端機」中讀取錄音，使用的是與 AI 應用程式相同的四個唯讀工具：列表、搜尋、逐字稿和摘要。命令列使用與 AI 應用程式相同的開關和相同的 Vocatim 金鑰，而且只在 Vocatim 開啟且開關打開時才能使用。

1. 拷貝這個指令，然後貼到「終端機」視窗中，但先不要按下 Return 鍵：

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

2. 在 Vocatim 中按一下拷貝 CLI 指令。Vocatim 會拷貝一行內容：一個名為 vocatim 的 zsh 別名（zsh 是 macOS 的預設 shell）。
3. 回到「終端機」並按下 Return 鍵。這個指令會將拷貝的那一行加到 ~/.zshrc 的結尾；每次你打開「終端機」視窗時，zsh 都會讀取這個檔案。它只會加入以 alias vocatim= 開頭的那一行，因此剪貼板上的其他內容都不會進入這個檔案。
4. 打開新的「終端機」視窗並輸入 vocatim list。別名在步驟 3 之後打開的視窗中才能使用。

四個指令：

• vocatim list 會顯示你最新的 20 筆錄音，每行一筆：ID、日期和時間、長度及標題。vocatim list --limit 50 最多顯示 50 筆。
• vocatim search 預算 會尋找標題、逐字稿、摘要、筆記或翻譯中含有「預算」的錄音。含有空格的搜尋字詞要加上引號：vocatim search "weekly review"。最多顯示 10 筆結果，加上 --limit 20 則最多 20 筆。
• vocatim transcript <id> 會輸出一筆錄音的完整逐字稿。ID 位於 vocatim list 和 vocatim search 結果的第一欄。
• vocatim summary <id> 會輸出該錄音的摘要。

在任何指令後加上 --json，即可取得供你自己的腳本使用的 JSON。vocatim help 會列出所有指令。

你的金鑰：~/.zshrc 中的 vocatim 這一行含有你的 Vocatim 金鑰。如果你將這一行直接貼到「終端機」中，金鑰也會留在「終端機」的記錄中。這個金鑰只能讓這台 Mac 上的應用程式讀取 Vocatim，而且只在 Vocatim 開啟時有效。請勿分享這一行或這個檔案；如果已經分享，請在 Vocatim 中使用「重設金鑰」。

使用「重設金鑰」後，或 Vocatim 顯示「設定已變更：請重新設定你的 AI 應用程式。」時，舊的那一行就會失效。請重新執行步驟 1 到 4。有效的是 ~/.zshrc 中最新的 vocatim 那一行；較舊的可以刪除。

執行指令後，Vocatim「設定」中的這台 Mac 上的 AI 應用程式會顯示 vocatim-cli，就像顯示 AI 應用程式的名稱一樣。

命令列只會與這台 Mac 上的 Vocatim 通訊，並在你的「終端機」視窗中輸出結果。如果你將輸出內容轉交出去，例如交給線上 AI 服務，內容就會送到那裡。

若要移除，請從 ~/.zshrc 刪除所有 vocatim 行；重新執行步驟 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 上開啟，或 AI 應用程式的存取權限已在 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

AI 應用程式存取你錄音的權限預設為關閉。只有在你決定與這台 Mac 上的 AI 應用程式分享逐字稿時，才由你自己在 Vocatim 的「設定」中開啟。

Vocatim 本身不會傳送任何內容。如果 AI 應用程式使用線上模型（Claude Desktop、ChatGPT 和 Codex 通常都是如此），它從 Vocatim 讀取的內容會以你在該公司（Anthropic 或 OpenAI）的帳號傳送給該公司，就像你把這些內容貼到聊天中一樣。

如何停止

在 Vocatim 中關閉開關。重設金鑰會讓你拷貝過的每個金鑰和貼上過的每份設定都失效。若要重新連接，請重新設定 AI 應用程式。若是 Claude Desktop 延伸功能，請在 Vocatim 中再按一下安裝到 Claude Desktop，儲存檔案並打開它：檔案儲存後，Vocatim 會拷貝新的金鑰。請在 Claude Desktop 要求時貼上，或貼到 Claude Desktop 中 Vocatim 延伸功能的 Vocatim 金鑰欄位。若是 Cursor 和 LM Studio，請再按一下加入 Cursor 或加入 LM Studio。若是你貼上的設定，請重新拷貝設定，並貼上取代舊的項目或區段。接著完全結束 AI 應用程式（只關閉視窗是不夠的），然後重新打開：在此之前，它會繼續使用舊的金鑰。你也可以從 AI 應用程式中移除 Vocatim：Claude Desktop 中的 Vocatim 延伸功能、其設定檔中、其他應用程式的 MCP 設定中或 Zed 設定檔中的 "vocatim" 項目，或 ~/.codex/config.toml 中的 [mcp_servers.vocatim] 區段。

如果無法運作

• 出現「Vocatim 未在這台 Mac 上開啟，或 AI 應用程式的存取權限已在 Vocatim 的『設定』中關閉。」：打開 Vocatim 並檢查開關。「重設金鑰」後，請重新設定 AI 應用程式，然後將它完全結束（只關閉視窗是不夠的）再重新打開。
• Vocatim 顯示「設定已變更：請重新設定你的 AI 應用程式。」：請如上所述，取代舊的項目或區段，重新設定每個 AI 應用程式，然後重新啟動它。
• Vocatim 顯示「應用程式沒有打開。它是否已安裝在這台 Mac 上？」：請在這台 Mac 上安裝該應用程式。若是 Cursor 和 LM Studio，你也可以使用拷貝其他應用程式的設定。
• 第二次貼上設定後，ChatGPT 或 Codex 停止運作，或回報 config.toml 中有錯誤：檔案中有兩個 [mcp_servers.vocatim] 區段。只保留最新的那一個。
• Codex 表示沒有 Vocatim 工具：請在檔案夾位於這台 Mac 上的專案中開始新的對話（從其他電腦同步過來的專案，在這裡可能沒有檔案夾）。
• 你在打開 Vocatim 之前就打開了 AI 應用程式：請在 Vocatim 開啟的情況下重新啟動 AI 應用程式。
• 缺少某段錄音：垃圾桶中的錄音和範例錄音不會顯示，而新的錄音要等到轉錄完成或停止後才會出現。尚未完全轉錄的錄音會列出，但在轉錄完成之前，無法取得其逐字稿和摘要。