Notion MCP Server：让AI编程工具直连团队知识库

如果你使用 Claude、Cursor 或 Windsurf 做开发，想必已经饱受频繁切换上下文之苦：一边写代码，一边要查团队文档、对照架构决策，或拉取数据库记录——这些都意味着在浏览器标签页之间来回折腾。Notion MCP Server 填补了这个空白，它让你的 AI Agent 直连到 Notion 工作空间。

这也是最受欢迎的 productivity MCP Server 之一（GitHub 2,500+ 星），因为团队的知识库本来就沉淀在 Notion 里。你的文档不在什么小众 wiki 里，就在 Notion。现在你的 AI 可以直接读取、写入和搜索，无需你手动复制粘贴。

Notion MCP Server 为 AI Agent 提供了对 Notion 工作空间的完整读写能力。你可以：

• 编程式创建和更新页面——可用于生成报告、记录决策或同步数据
• 带筛选条件查询数据库——直接将需求、任务、架构笔记或客户反馈拉取到当前上下文中
• 用自然语言搜索整个工作空间——再也不会出现"我们把那个文档放哪儿了"的尴尬
• 管理各类块（文本、列表、代码、表格、标注块）——按团队需要组织内容结构
• 读写评论——保持讨论在 Notion 内部进行，而不是把上下文碎片化地散落在 Slack 各处

对开发者而言，这意味着 AI 可以在你编码的同时实时访问技术规格、ADR、API 文档和团队笔记。它能读到你系统的信息来源（source of truth），所以真正理解你的系统。

首先，在 notion.so/my-integrations 创建一个 Notion Integration Token，然后将这个 Integration 添加到你想让 AI 访问的页面或数据库。

npx -y @notionhq/notion-mcp-server

添加到 Claude Desktop 配置：

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx -y @notionhq/notion-mcp-server",
      "env": {
        "NOTION_API_KEY": "your-notion-integration-token"
      }
    }
  }
}

文档生成：让 Claude 在 Notion 中创建新的 RFC 或事故报告，包含格式化好的章节和嵌入的代码示例

需求上下文：在编码过程中查询产品数据库，拉取功能规格、验收标准或相关 issue，全程不离开编辑器

知识综合：搜索团队 wiki（架构决策、运维手册、事故报告），让 Claude 汇总答案，或推荐你可能遗漏的相关文档

CuratedMCP 上有面向 Claude Desktop、Cursor、Windsurf 等的完整安装指南。