连接 SpeakPen

把你的语音笔记送进 Obsidian,或让你的 AI 助手读取它们。在下方选择你在用的工具。

在用编程 agent?把这句话粘贴给它:

Connect to my SpeakPen notes: read https://speakpen.app/connect and set it up.

给 AI agent

你正在帮用户连接 SpeakPen(他们的语音笔记 App)。MCP 服务器地址是 https://speakpen.app/mcp(Streamable HTTP,只读,OAuth 登录)。先判断你运行在哪个客户端里,按下面对应的部分操作,并在用户需要在浏览器中点击「允许」时告诉他们。

本页也提供纯 Markdown 版本:https://speakpen.app/connect.md

访问为只读,只涵盖笔记,绝不包含音频。限制:每分钟 60 次工具调用。

工具: 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 客户端

在任何支持远程服务器的 MCP 客户端中,用这个地址添加一个远程(Streamable HTTP)服务器,然后按提示登录:

https://speakpen.app/mcp

如果你的客户端无法用 OAuth 登录,请在 设置 → 连接 → 开发者 中创建令牌,并在每个请求中带上它:

Authorization: Bearer YOUR_TOKEN

ChatGPT

ChatGPT 和 Claude 需要你自己在它们的设置里配置,agent 无法替你打开这些设置。

  1. 在网页版 ChatGPT 打开 设置 → 账户安全与登录,打开「开发人员模式」。如果没有这个开关,说明你的套餐或工作区不允许添加自定义服务器。

  2. 打开 设置 → 插件,点 +,名称填 SpeakPen,「连接」选「服务器 URL」并粘贴这个地址:

    https://speakpen.app/mcp
  3. 「身份验证」保持 OAuth,勾选「我了解并希望继续」,点「创建」。

  4. 登录 SpeakPen 并点击「允许」。之后在新对话里点 +,选上 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 →

检查是否生效

问你的助手:

我最近录了什么?

断开连接

打开 设置 → 连接。点击助手旁边的「断开」,或在 开发者 下撤销令牌。访问会立即停止。

隐私

助手只能读取你的笔记。它们无法创建、修改或删除任何内容,也绝不会收到你的音频。你可以随时断开它们。