writespace-mcp

Writespace MCP Server

面向 Writespace 的托管远程 Model Context Protocol 服务。Writespace 是一款实时协作文档编辑器。让 Claude、ChatGPT、Gemini、Cursor 或任何支持 MCP 的 Agent 都能与你一起使用共享文档工作区，进行阅读、编写、整理和搜索。

端点： https://app.writespace.io/mcp（HTTP 传输，Bearer 身份验证） 免费套餐： 是 — 最多可创建 10 份文档，无需银行卡 → 注册

功能介绍

Writespace 是一款以 Markdown 为先的文档编辑器，面向人类用户，并内置供 Agent 使用的 MCP 服务。你在应用中可以执行的每项操作，都作为工具提供给模型调用：

• 阅读 — 浏览工作区目录树，以无损 JSON 或 Markdown 格式获取任意文档，执行带排名的全文搜索（可直接将结果用作 Agent 的 RAG 检索）
• 编写 — 创建文档、追加内容、按标题替换单个章节、浅合并结构化元数据
• 整理 — 创建／重命名／移动文件夹，移动文档，按元数据查询文档（{ status: "accepted" }）

Agent 的写入会通过 Realtime 广播，因此打开的编辑器会实时重新加载。人类和 Agent 在同一个画布上协作 — 无需导出，也无需协商格式。

快速开始

三步，只需两分钟：

1. 获取令牌 — 在 app.writespace.io 登录，打开 Settings → API tokens，创建令牌（仅显示一次，可随时撤销）。
2. 端点 — 所有账户共用一个托管端点：https://app.writespace.io/mcp
3. 配置客户端 — 参见下方示例。

Claude Code（CLI）

claude mcp add --transport http writespace \
  https://app.writespace.io/mcp \
  --header "Authorization: Bearer ws_pat_YOUR_TOKEN_HERE"

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop 的配置仅支持**本地（stdio）**服务，因此需通过 mcp-remote 桥接远程 HTTP 服务。Claude Desktop 会在本地启动它，由它转发请求到端点：

{
  "mcpServers": {
    "writespace": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.writespace.io/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ws_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}

注意：

• 令牌应放在 AUTH_HEADER 环境变量中（并在 --header Authorization:${AUTH_HEADER} 中使用冒号后不带空格的写法），因为 mcp-remote 无法正确处理 --header 参数中的空格。
• Claude Desktop 启动时使用精简的 PATH。如果找不到 npx，请使用其绝对路径（例如 /usr/local/bin/npx 或你的 nvm 路径）— 如果依赖带版本号的 node，还要在 env 中添加相应的 "PATH" 条目。
• 编辑后请完全退出并重新打开 Claude Desktop（Cmd-Q）— 配置只会在启动时读取。

Cursor

Settings → MCP → Add server

Type:    HTTP
URL:     https://app.writespace.io/mcp
Header:  Authorization: Bearer ws_pat_YOUR_TOKEN_HERE

Gemini CLI

~/.gemini/settings.json

{
  "mcpServers": {
    "writespace": {
      "httpUrl": "https://app.writespace.io/mcp",
      "headers": {
        "Authorization": "Bearer ws_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}

任何其他符合规范的 MCP 客户端也可采用相同方式：HTTP 传输 + Authorization: Bearer 标头。

工具

除 list_workspaces 外，每个工具都需要 workspace_id — 请先调用 list_workspaces 来查找工作区。

工具	描述
list_workspaces	列出你所属的所有工作区
list_folders	列出文件夹，可选择嵌套在某个父文件夹下
list_docs	列出文档，可限定在某个文件夹内；返回每行的元数据
get_doc	按 ID 获取文档 — 规范的 Tiptap JSON + Markdown 渲染内容 + 元数据
search	全文搜索并按相关度排序，包含 <<match>> 摘录
query_docs	查找元数据包含某个 JSON 对象的文档（Postgres JSONB @>）
create_doc	根据 Tiptap JSON 或 Markdown 创建文档
update_doc	更新标题、内容或元数据（浅层合并；null 会删除键）
upsert_doc	在可选文件夹中按标题创建或更新文档 — 幂等
append_to_doc	将 Markdown / Tiptap JSON 附加到现有文档
replace_section	按标题文本替换某个章节的正文 — 精准编辑
delete_doc	按 ID 删除文档
move_doc	将文档移至其他文件夹（folder_id: null → 根目录）
create_folder	创建文件夹，可选择嵌套
rename_folder	重命名文件夹 — ID 保持稳定，链接不会失效
delete_folder	删除文件夹及其内容

完整参考（含格式说明和故障排除）：writespace.io/connect

设计说明

• 无损内容，支持两种格式 — 读取时同时返回 content（Tiptap JSON）和 content_markdown；写入时可接受任一格式。Markdown 可往返转换，支持编辑器支持的所有内容，包括表格、任务列表和 mermaid 图表。
• 精简的写入响应 — 默认情况下，写入工具仅返回元数据，可将长文档的有效负载减少 80–95%。传入 include_content: true 可回显正文。
• 结构化元数据 — 每篇文档都带有 JSONB metadata 字段。可将其视为可查询的 frontmatter：写入、浅层合并，并按包含关系查询。
• 稳定的跨文档链接 — 使用 writespace://doc/<id> 引用文档；重命名和移动后 ID 仍保持不变。
• 实时重新加载 — MCP 写入会通过 Realtime 通知已打开的编辑器；编辑器会在同一标签页中重新获取内容。

使用场景

• MCP 文档服务 — 可供 Agent 作为工具使用的文档后端
• 适用于 Claude 的共享文档 — Claude 的持久记忆和笔记
• 适用于 ChatGPT 的共享文档 — 同一工作区，不同模型
• MCP 知识库 — 可供任何 Agent 查询的可搜索团队知识库

身份验证与安全

• 每个 Agent 都有个人访问令牌，可在 Settings 中签发和撤销 — 与你的账户绑定，便于轮换
• 令牌仅在创建时显示一次
• 标准 Authorization: Bearer ws_pat_… 标头；符合规范的 HTTP 传输

链接

• 网站：writespace.io
• 应用：app.writespace.io
• 设置与完整工具参考：writespace.io/connect
• 联系方式：[email protected]

---

© 2026 Writespace · Pro 每位用户每月 $5，提供免费套餐。