---
title: "通过 MCP 将 Letter.md 接入 AI"
author: "Letter.md Official Content"
canonical: "https://letter-official-source.letter.pub/official-docs-index-zh"
published_at: "2026-08-26T06:21:12Z"
updated_at: "2026-08-29T07:08:45Z"
description: "Letter.md: A quiet, local-first Markdown editor for writing, organizing, and publishing. Write anonymously in the browser or save to the cloud for collaboration."
---

# 通过 MCP 将 Letter.md 接入 AI

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

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

## 1. 添加远程 MCP 服务器

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

```text
https://mcp.letter.md/mcp
```

客户端应当能够自动发现 [Letter.md](http://Letter.md) 的 OAuth 配置。

### Cursor

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

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

## 2. 登录并授权

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

## 3. 打开文档并开始协作

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

## 权限范围

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

[Letter.md](http://Letter.md) 会按工作流申请最小权限。一个客户端的授权不会自动授权其他客户端。

## 连接问题排查

- 确认客户端支持远程 HTTP MCP 与 OAuth。
- MCP 服务地址必须以 `/mcp` 结尾；编辑器地址不是服务器地址。
- 如果授权卡住，在客户端中移除原来的 [Letter.md](http://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，只是不显示这些工具。