Clean Notes

Clean Notes MCP 服务

为 AI 客户端提供看板任务和项目笔记，并支持 OAuth 及按项目授予的读取或写入权限。

Clean Notes 是面向小型团队的项目工作区：包含支持列表和时间线视图的看板、与所说明任务并列的项目笔记，以及实时更新。其 MCP 服务可让 GitHub Copilot、ChatGPT、Claude 或任何 MCP 客户端读取和更新你批准的项目，不会访问其他内容。

此仓库介绍托管服务。无需在本地安装或运行任何内容：只需将客户端指向端点并登录。

端点	https://cleannotes.app/mcp
传输方式	Streamable HTTP，无状态
身份验证	OAuth 2.1，支持动态客户端注册和 PKCE。无需粘贴 API 密钥或令牌。
工具	11 个：六个读取工具、五个写入工具，不含删除工具
注册表名称	app.cleannotes/clean-notes

你需要拥有 Clean Notes 账户。免费方案包含 AI 访问权限。

配置

使用 GitHub Copilot 的 VS Code

使用上方的安装按钮，或将服务添加到工作区中的 .vscode/mcp.json（或用户级 mcp.json）：

{
  "servers": {
    "clean-notes": {
      "type": "http",
      "url": "https://cleannotes.app/mcp"
    }
  }
}

启动服务。VS Code 提示登录 Clean Notes 时，允许登录；浏览器会打开 Clean Notes，你可在其中登录并选择要共享的项目。随后，这些工具会以 Agent 模式显示在 Copilot Chat 中。

Claude Code

claude mcp add --transport http clean-notes --scope user https://cleannotes.app/mcp

然后在 Claude Code 中运行 /mcp，并选择 Clean Notes 旁边的 Authenticate。

Claude（应用和网页）

依次选择 Settings → Connectors → Add custom connector，粘贴 https://cleannotes.app/mcp，然后进行身份验证。

ChatGPT

打开 Clean Notes 插件，连接你的账户并授权访问项目。

其他 MCP 客户端

将 https://cleannotes.app/mcp 注册为 Streamable HTTP 服务，然后在浏览器中完成 OAuth 登录。客户端会从 https://cleannotes.app/.well-known/oauth-protected-resource 自动发现其他信息。

选择助手可访问的内容

登录用于证明你的身份，并不会自动开放工作区。登录后，Clean Notes 会询问此连接可访问哪些项目，以及每个项目是仅可读取还是也可进行更改。未获项目授权的连接无法读取任何内容。

• 在 Clean Notes 中每个项目的 AI tools 面板内授予或撤销权限。
• 项目所有者可决定是否允许成员连接自己的 AI 工具。
• 助手无法删除任何内容，也无法更改成员、设置或账单信息。

使用

你可以用自然语言提问，例如：

• “Launch 项目中有哪些任务已逾期或受阻？分别由谁负责？”
• “根据这些会议记录，在我的 Launch 项目中创建任务，并为每项任务指定负责人和截止日期。”
• “将定价页面任务标记为已完成，并记录一条项目笔记，写下今天做出的决定。”
• “自周一以来，Website 项目有哪些变更？”

工具

工具	访问权限	功能
clean_notes_list_projects	读取	列出此连接可访问的项目。
clean_notes_get_project	读取	返回项目及其按顺序排列的状态和可分配的成员。
clean_notes_list_tasks	读取	按状态、受指派人或最近更改筛选任务，并支持游标和数量限制。
clean_notes_get_task	读取	返回任务的完整详情。
clean_notes_list_notes	读取	列出笔记的简短预览，并支持游标。
clean_notes_get_note	读取	返回笔记的完整正文。
clean_notes_create_task	写入	创建任务：标题、详情、状态、优先级、受指派人和日期。
clean_notes_update_task	写入	更改任务字段。
clean_notes_complete_task	写入	将任务标记为已完成。
clean_notes_create_note	写入	创建包含标题和正文的笔记，也可选择置顶。
clean_notes_update_note	写入	编辑笔记的标题、正文或置顶状态。

写入工具仅适用于获准读取和更改的项目；对其他项目的调用 将被拒绝。

专为安全重试而构建

• 每次写入都需要一个幂等键，因此重复调用会返回首次调用的结果，而不会创建第二个任务或笔记。
• 更新和完成操作会携带记录的 expectedUpdatedAt。如果其他人先更改了记录，调用会因冲突而失败，不会覆盖对方的修改；助手会重新读取记录后再重试。
• 所有工具都限定在授权范围内：只读取和写入获准的项目，不会访问互联网。
• 每个项目都会保留 AI 更改的活动日志，其中记录客户端、工具、时间和结果。日志存储的是元数据，而非调用内容。

定价

所有套餐均支持 AI 访问。只有成功的更改会计入每月额度；读取、冲突和被拒绝的调用均免费。

套餐	价格	每月 AI 更改次数
Free	$0	50
Pro	每月 $4.90	5,000
Scale	每月 $14.90	25,000

费用根据你创建的项目计算，因此你邀请的人无需支付席位费用。请参阅定价。

链接

• 文档：cleannotes.app/en/ai/mcp
• 网站：cleannotes.app
• 支持：cleannotes.app/en/support，或发送邮件至 [email protected]
• 隐私政策 · 条款

Clean Notes 是一项专有托管服务。本仓库仅包含其公开文档；服务端源代码未在此处发布。