連接 SpeakPen

給 AI agent

你正在協助使用者連接 SpeakPen（他們的語音筆記 App）。MCP 伺服器位址是 https://speakpen.app/mcp（Streamable HTTP，唯讀，OAuth 登入）。先判斷你執行在哪個用戶端裡，依照下方對應的部分操作，並在使用者需要在瀏覽器中點擊「允許」時告訴他們。

工具： searchfetchlist_recent_notes

Claude Code

1. 新增伺服器：

   claude mcp add --transport http speakpen https://speakpen.app/mcp

   複製

2. 接著在 Claude Code 中執行 /mcp，選擇 speakpen 並登入。瀏覽器會開啟：登入 SpeakPen 並點擊「允許」。

   /mcp

   複製

3. 選用：SpeakPen skill 會教 Claude Code 何時去查看你的筆記。該外掛同樣會新增 speakpen 伺服器，所以你可以安裝它來取代上面的指令：

   /plugin marketplace add Qumge/speakpen-skill
   /plugin install speakpen@speakpen

   複製

Codex CLI

1. 新增伺服器：

   codex mcp add speakpen --url https://speakpen.app/mcp

   複製

2. 登入。瀏覽器會開啟：登入 SpeakPen 並點擊「允許」。

   codex mcp login speakpen

   複製

Cursor

1. 把這段加入 ~/.cursor/mcp.json（或專案中的 .cursor/mcp.json）：

   {
     "mcpServers": {
       "speakpen": {
         "url": "https://speakpen.app/mcp"
       }
     }
   }

   複製

2. 當 Cursor 要求你登入 speakpen 時，在瀏覽器中登入 SpeakPen 並點擊「允許」。

VS Code

1. 把這段加入工作區中的 .vscode/mcp.json，並把 YOUR_TOKEN 換成你的權杖：

   {
     "servers": {
       "speakpen": {
         "type": "http",
         "url": "https://speakpen.app/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_TOKEN"
         }
       }
     }
   }

   複製

2. 在 設定 → 連接 → 開發者 中建立權杖。

Gemini CLI

1. 新增伺服器：

   gemini mcp add --transport http speakpen https://speakpen.app/mcp

   複製

2. 接著在 Gemini CLI 中登入。瀏覽器會開啟：登入 SpeakPen 並點擊「允許」。

   /mcp auth speakpen

   複製

其他 MCP 用戶端

https://speakpen.app/mcp

Authorization: Bearer YOUR_TOKEN

ChatGPT

ChatGPT 和 Claude 需要你自己在它們的設定裡設定，agent 無法替你開啟這些設定。

1. 在 ChatGPT 中新增自訂 MCP 伺服器（ChatGPT 的說明文件會說明入口在哪裡；部分方案和工作區不允許這樣做）。

2. 使用這個位址，並選擇 OAuth 登入：

   https://speakpen.app/mcp

   複製

3. 登入 SpeakPen 並點擊「允許」。

Claude.ai and Claude Desktop

1. 開啟 Customize → Connectors，點擊 + Add，再點擊 Add custom connector。

2. 命名為 SpeakPen，貼上這個位址並點擊 Continue。保持登入設定不變，再次點擊 Continue，然後點擊 Add：

   https://speakpen.app/mcp

   複製

3. 當 Claude 要求你登入時，登入 SpeakPen 並點擊「允許」。

在 Claude Desktop 中步驟相同。

Obsidian

1. 在 Obsidian 中：設定 → 第三方外掛 → 社群外掛市集 → 搜尋「SpeakPen Sync」→ 安裝並啟用。

2. 在 SpeakPen 中開啟 設定 → 連接，點擊 Obsidian 卡片上的「產生權杖」。複製權杖：它只會顯示一次。

3. 在 Obsidian 中開啟 SpeakPen Sync 設定，把權杖貼到「API token」欄位。

筆記單向同步：從 SpeakPen 到你的倉庫。

語音筆記如何同步到 Obsidian →

檢查是否生效

我最近錄了什麼？

中斷連接

隱私