通过 MCP 将 Letter.md 接入 AI

Letter.md 提供远程 MCP 服务，可以把你的文档接入 AI 工作流。连接后，支持 MCP 的客户端可以读取你选择的文档、理解当前选区，并创建可审阅的修改。

AI 提出修改时，正文不会自动改变。建议和评论会保持为待审阅状态，只有在你接受后才会写入文档。

1. 添加远程 MCP 服务器

在 ChatGPT、Codex、Cursor 或其他支持远程 HTTP MCP 与 OAuth 的客户端中，添加下面的服务器：

https://mcp.letter.md/mcp

客户端应当能够自动发现 Letter.md 的 OAuth 配置。

Cursor

把下面的配置加入 mcp.json：

{
  "mcpServers": {
    "letter.md": {
      "url": "https://mcp.letter.md/mcp"
    }
  }
}

2. 登录并授权

首次连接时会打开 Letter.md 登录页面。登录后确认授权即可。授权只属于当前 MCP 客户端；你可以随时在该客户端中移除 Letter.md 连接。

3. 打开文档并开始协作

在 MCP App 编辑器中打开一篇 Letter.md 文档，然后让宿主审阅文档、添加评论或提出修改。你可以逐项检查建议，只接受自己需要的修改。

权限范围

• documents:read — 检索和读取你有权访问的文档
• suggestions:write — 创建可审阅建议和 AI 评论
• documents:write — 仅在你明确要求时，在可写 Workspace 中新建或保存未发布文档；不会覆盖已有文档
• assets:write — 把生成的图片上传到可编辑文档

Letter.md 会按工作流申请最小权限。一个客户端的授权不会自动授权其他客户端。

连接问题排查

• 确认客户端支持远程 HTTP MCP 与 OAuth。
• MCP 服务地址必须以 /mcp 结尾；编辑器地址不是服务器地址。
• 如果授权卡住，在客户端中移除原来的 Letter.md 连接，再重新添加。
• 如果无法打开文档，确认当前登录账户拥有对应 Workspace 的访问权限。

在支持的 Chrome 中使用 WebMCP

在支持 WebMCP 的 Chrome 版本中，Letter.md 还会通过 document.modelContext 提供当前页面范围内的工具。正常打开 Letter.md 即可，不需要填写远程 MCP 地址，也不需要单独完成 OAuth 连接。

打开文档后，Agent 可以读取完整 Markdown、文档大纲或当前选区；查找并打开文档；查看文档中的素材；搜索素材和素材集；以及创建可审阅的建议。新建文档或创建建议时，Letter.md 一定会先要求确认。

可用工具会随当前页面、Workspace 成员身份和文档角色变化。WebMCP 不开放直接修改正文、删除素材、发布或分享工具。

要查看当前页面注册的工具，请打开 Chrome 开发者工具，然后进入 Application → WebMCP。WebMCP 仍是实验性浏览器能力；不支持它的浏览器会照常使用 Letter.md，只是不显示这些工具。