安心轉 MCP 設定：串接 Claude Code、Codex、Cursor 等 Agent

把提示詞傳給 Agent 自動完成安心轉 MCP 設定，或在 Claude Code、Codex、Cursor、VS Code 中手動加入本機語音轉文字服務。

安心轉 MCP 是在本機執行的 Streamable HTTP 服務。Agent 串接後，可以提交本機的錄音和影片檔，轉成文字並讀取結果。

讓 Agent 一鍵設定

在安心轉的 MCP 頁面，找到「Agent 接入提示詞」並點選「複製」，再貼到 Agent 的對話視窗，Agent 就會依照本文完成設定。用戶端產生的提示詞已包含目前的 MCP URL。

也可以複製下面的提示詞：

請閱讀 https://quiettypist.com/zh-hant/docs/mcp-setup.md 文件，按照步驟為我設定安心轉 MCP。

項目	值
服務名稱	`anxinzhuan`
傳輸方式	Streamable HTTP（部分用戶端顯示為 HTTP 或串流 HTTP）
MCP URL	`http://127.0.0.1:36158/mcp`
驗證	無

預設連接埠被占用時，安心轉會自動改用後面的空閒連接埠，請以 MCP 頁面顯示的 MCP URL 為準。下文範例使用預設網址，實際網址不同時請自行替換。使用期間請讓安心轉保持執行。

curl http://127.0.0.1:36158/health

回傳 {"status":"ok"} 代表服務正常。在 Windows PowerShell 中請改用 curl.exe。

claude mcp add --transport http --scope user anxinzhuan http://127.0.0.1:36158/mcp

加入後可以執行 claude mcp list 查看連線狀態。

codex mcp add anxinzhuan --url http://127.0.0.1:36158/mcp

也可以在 ~/.codex/config.toml 中手動加入：

[mcp_servers.anxinzhuan]
url = "http://127.0.0.1:36158/mcp"

在 Codex 應用程式中加入時，選擇串流 HTTP（Streamable HTTP）並填入 MCP URL，介面範例請見 MCP 使用方式。

在 ~/.cursor/mcp.json 中加入：

{
  "mcpServers": {
    "anxinzhuan": {
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

在使用者層級的 mcp.json（從命令選擇區執行「MCP: Open User Configuration」）或工作區的 .vscode/mcp.json 中加入：

{
  "servers": {
    "anxinzhuan": {
      "type": "http",
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

在用戶端的 MCP 設定中加入 Streamable HTTP 類型的服務（可能顯示為 HTTP、串流 HTTP 或 streamableHttp），名稱填 anxinzhuan，URL 填 MCP URL，不需要填驗證資訊。只支援 stdio 的用戶端目前無法直接連線。

儲存設定後，重新啟動用戶端或重新整理 MCP 連線。連線成功後會看到以下工具：

之後就可以直接對 Agent 說「用安心轉把這個檔案轉成文字」，並附上錄音或影片檔的完整路徑。