连接 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 →

检查是否生效

我最近录了什么？

断开连接

隐私