Weft
简

Notion MCP：如何把 Notion 连接到 Claude、Cursor、Codex 和 ChatGPT

作者：Andrei Finogeev，Weft 创始人 ·

Notion 的官方 MCP 服务器托管在 https://mcp.notion.com/mcp（Streamable HTTP，带 SSE 备用），用 OAuth 登录；Business 和 Enterprise 工作区还可以使用 MCP 令牌。所有 Notion 方案都能用。打开助手的连接器或插件库，搜索 Notion 并登录，或者在 Claude Code、Cursor、VS Code 或 Codex 里添加地址。旧的开源本地服务器已不再维护。

Notion MCP 一览

服务器地址https://mcp.notion.com/mcp；SSE 备用在 /sse
登录方式OAuth；Business 和 Enterprise 上可用 MCP bearer 令牌
免费方案可以，“Notion MCP works on every plan”
速率限制每分钟 180 次请求（Business 和 Enterprise 上 600 次）；数据源查询约每秒 3 次
删除可以，页面和数据库进回收站
付费方案Plus 按年计费每成员每月 $10（按月 $12）；Business $20（$24）

“未说明”表示 Notion 没有写明。价格为美元标价，按每席位计；税费和地区价格会有差异。

如何在各个助手里设置 Notion MCP

Claude（网页版和桌面版）

Customize → Connectors（或在聊天里点“+”→ Connectors），从目录里选择 Notion 并登录。

Claude Code

添加服务器，然后在 Claude Code 里运行 /mcp 并登录。Notion 还提供一个 Claude Code 插件（makenotion/claude-code-notion-plugin）。

claude mcp add --transport http notion https://mcp.notion.com/mcp

Cursor

把 Notion 添加到 .cursor/mcp.json，启用它并完成登录。

{
  "mcpServers": {
    "notion": { "url": "https://mcp.notion.com/mcp" }
  }
}

VS Code（Copilot）

把服务器添加到 .vscode/mcp.json，设置 "type": "http"，然后运行“MCP: List Servers”并启动它。

Codex

添加到 ~/.codex/config.toml，然后登录。

[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"

# then: codex mcp login notion

ChatGPT

Notion 的文档没有给出 ChatGPT 的步骤或适用方案。OpenAI 在 ChatGPT 里提供了一个 Notion 应用；我们没能从 OpenAI 目前的页面确认它能写入什么。

你的 AI 在 Notion 里能做什么

  • 搜索和获取页面；创建页面（也可以从数据库模板创建），更新页面内容和属性。
  • 把数据库当任务清单用：创建行，更新行的属性，查询已保存的视图和数据源，创建视图。
  • 创建数据库和数据源；评论和建议编辑；移动、复制、删除和恢复页面。
  • 上传最大 20 MiB 的图片和文件；日历事件和会议纪要。

值得了解的限制

  • 只有工作区成员能连接，访客不行。
  • 速率限制适用于每一次工具调用：每分钟 180 次，Business 和 Enterprise 上 600 次。
  • SQL 风格的查询只有在 Business 或 Enterprise 且开通 Notion AI 时才不限次数；连接器搜索也有同样的要求。
  • 没有指定位置就创建的页面会变成私人页面。
  • Notion 数据库是一张由你搭成任务清单的表；它本身没有智能体认领任务或汇报进度的概念。

和 AI 一起工作，选 Notion 还是 Weft？

如果你的任务和文档、wiki 放在一起，而你想让一个助手同时处理两者，就选 Notion。它的 MCP 服务器覆盖面广，由 Notion 托管，所有方案都免费。

如果你想要一块由 AI 来运转的任务看板，而不是一个要你自己设计的数据库，就选 Weft。Weft 是现成的 Scrumban：Backlog、冲刺，以及等你审阅的已完成工作上限；它的工具是为助手直接干活而设计的：认领任务、汇报进度、向你提一个在收件箱里等你回答的问题、记录决策。它在所有 ChatGPT 方案上都能用，包括免费版。

手机上的 Weft 看板，Doing 列：AI 助手领走的三个任务，每个都标着 AI
助手会领走下一个任务；每张卡片都显示是谁在做。
一个由 AI 创建并已完成的 Weft 任务，带着助手记录的结果：修了什么，以及 40 次测试运行全部通过
助手完成任务时会留下回执：做了什么，以及是怎么核对的。
免费试用 Weft对比 12 款带 MCP 的任务管理器

设置 Weft： 在 ChatGPT 里用 Weft · 在 Claude 里用 Weft · 在 Claude Code 里用 Weft · 在 Cursor 里用 Weft · 在 Codex 里用 Weft

常见问题

Notion MCP 服务器的地址是什么？

https://mcp.notion.com/mcp。只有在客户端不支持 Streamable HTTP 时才用 https://mcp.notion.com/sse。

Notion MCP 服务器免费吗？

免费。Notion 说 Notion MCP 适用于所有方案；部分搜索功能需要 Business 或 Enterprise 并开通 Notion AI。

应该用开源的 notion-mcp-server 吗？

Notion 说 makenotion/notion-mcp-server 已不再积极维护，推荐使用托管服务器；它把本地服务器称为最后的选择。

AI 能管理 Notion 数据库里的任务吗？

能。通过托管服务器，它可以创建行、更新行的属性、查询已保存的视图，所以数据库可以当任务清单用。

资料来源

阅读于 2026年11月11日。

其他 MCP 设置指南