Syncpen

Syncpen MCP 服务

将 Claude Code（或任何 MCP 客户端）连接到你的 Syncpen 工作区——这是一个 AI 真正可以在其中写作的写作工作区。你的 Agent 可以在与你共同编辑的实时文档中搜索、阅读、起草、提出建议、评论、整理和发布内容。

还没有账号？ 前往 syncpen.io 免费创建一个。

Syncpen 擅长什么？

• 构建由 AI 维护的知识库——收集笔记、文档和剪藏内容，然后让你的 Agent 整理、建立交叉链接并持续更新。
• 在发布平台上撰写长篇内容——文章、文档、整本书；你的 Agent 起草，你审核，然后一次调用即可发布到 WordPress、Ghost 或 Sanity。
• 你和你的 Agent 协作完成同一个项目——所有人都在同一份实时文档中工作；每次编辑都会共享、清晰可读并标明来源。
• 每次编辑都有记录可查——Agent 会以带签名的建议形式提出修改，由你接受或拒绝。任何更改都不会悄然发生。
• 无需离开你的工具即可完成研究 → 起草 → 发布——剪藏资料来源，让 AI 据此起草并发布。

快速设置

1. 生成 API 密钥

1. 前往 Syncpen 账号中的 设置 → API 密钥
2. 启用 API 访问权限
3. 创建新的 API 密钥
4. 复制密钥（它只会显示一次！）

2. 配置 Claude Code

将以下内容添加到你的 MCP 配置文件（~/.mcp.json 或项目级 .mcp.json）：

{
  "mcpServers": {
    "syncpen": {
      "command": "npx",
      "args": ["-y", "syncpen-mcp"],
      "env": {
        "SYNCPEN_API_KEY": "sp_your_api_key_here"
      }
    }
  }
}

就是这样！Claude Code 将自动下载并运行 MCP 服务。

可用工具

工具	描述
syncpen_search	按标题和正文内容（全文）搜索文档
syncpen_read	以 Markdown 格式读取文档内容
syncpen_list_folders	列出所有文件夹
syncpen_list_documents	列出文档，可按文件夹筛选
syncpen_create	创建新文档——默认创建在个人空间，也可通过 teamId 创建在团队空间
syncpen_update	更新文档标题和/或内容
syncpen_suggest_edit	提交编辑建议，供人工接受或拒绝（接受前不会更改文档）
syncpen_list_suggestions	列出文档的待处理（或全部）建议
syncpen_list_comments	读取评论串（含回复、行号和作者）
syncpen_reply_comment	回复评论串（带签名，并通知 @提及对象）
syncpen_resolve_comment	将评论串标记为已解决
syncpen_move_document	将文档移入文件夹或移至根目录
syncpen_delete_document	删除文档（移至回收站）
syncpen_create_folder	创建文件夹（可嵌套）
syncpen_rename_folder	重命名文件夹
syncpen_move_folder	将文件夹移至新的上级文件夹或根目录
syncpen_delete_folder	删除文件夹及其内容（移至回收站）
syncpen_publish	将文档发布到 WordPress、Ghost 或 Sanity
syncpen_list_connections	列出已连接的 CMS 目标及其 connectionIds——默认列出个人空间，也可通过 teamId/documentId限定范围
syncpen_list_teams	列出你的团队空间（id、名称、角色、成员数）
syncpen_recent_changes	按时间排序的信息流，显示谁在何时创建、编辑或移入回收站了哪些文档
syncpen_related	根据一篇文档推荐其他可阅读内容——结合共同访问记录（共同处理过的文档）与 /editor 链接
syncpen_drive_list_files	列出/搜索用户已连接 Google Drive 中的文件
syncpen_drive_read_file	读取 Drive 文件内容（仅支持 Google 文档和纯文本文件）
syncpen_news_search	通过用户已连接的 World News API 密钥搜索近期全球新闻
syncpen_slack_list_channels	列出用户已连接的 Slack 工作区中的公开频道
syncpen_slack_read_channel	读取公开 Slack 频道近期的消息记录
syncpen_notion_search	搜索用户已连接的 Notion 工作区中的页面
syncpen_notion_read_page	读取 Notion 页面的顶层内容

使用示例

配置完成后，向 Claude Code 提问：

• “列出我的 Syncpen 文件夹”
• “搜索提及 authentication 的文档”
• “读取我标题为 ‘API Design Notes’ 的文档”
• “我的 ‘Projects’ 文件夹中有哪些文档？”
• “将我的 ‘Launch Post’ 文档作为草稿发布到 Ghost”
• “从昨天起，我的工作区有哪些变化？”

开发

有关贡献或从源代码运行：

git clone https://github.com/airbuzz/syncpen-mcp.git
cd syncpen-mcp
npm install
npm run build     # or: npm run dev  (watch mode)

将 MCP 配置指向构建后的入口文件（node /path/to/syncpen-mcp/dist/index.js）。默认使用生产 API；仅在要连接本地实例时设置 SYNCPEN_API_URL。

许可证

MIT