Notion MCP + Claude Code 完美结合教程 - 让大模型自动管理你的知识库

本文详细介绍了如何配置 Notion MCP 与 Claude Code 的结合使用，实现 Notion 工作区的自动化交互。内容包括获取 Notion API 密钥、安装配置 notion mcp、验证连接等步骤，以及将工作内容整理到 Notion、整理实验结果到多维表格等应用场景。作者还分享了 Claude Code + Notion 提升生产力的实用建议，并表达了对 AI 编程工具的认可与期待，认为这是程序员的最好时代。

最初开这个帖子的目的是因为我现在整理实验 Setting 和开会的 Note 要自己从工作区复制粘贴到 Notion

实验结果整理到多维数据表格也要自己贴来贴去

早就知道 Notion 开放了 MCP 但是没有尝试过

起初我以为实现目的需要 Skills

看过几个 Notion Skills 后发现我的任务不用这么复杂

在 Notion MCP 上加个简单的 md 工作流定义文件就行

Skills 可以做更大的事情

但是起点都要从 Notion MCP 开始

所以就有了这个小教程

💡

这个教程就是在 Claude Code + Notion MCP 的工作流交互辅助下完成

Notion MCP (Model Context Protocol) 允许 Claude Code 直接与你的 Notion 工作区交互，实现搜索、读取、创建和编辑页面等功能。

前置要求

•

拥有 Notion 账号和工作区

•

本地 Claude Code 正常可用

配置步骤:

Notion端准备: 获取 Notion API 密钥

访问 Notion Integrations (https://www.notion.so/my-integrations) 页面：

点击 + New integration

填写集成名称（例如：“Claude demo”）

选择你的工作区

点击 Submit

复制生成的 Internal Integration Token

就此 notion 端已经准备好

Claude Code 端准备

这里安装也有两种方式

Claude 官方模式: 本地机器适合这样安装 (服务器网址无法在本地验证)

Config 配置模式: 这种服务器和本地都可以 (我没配置顺畅，后面再补充)

我的本地配置是 ok 的，这里介绍本地机器的配置方式。

服务器虽然也配置成功了，但是 claude code 开启时就检测不到，只能指定到mcp.json 才勉强能用，原生支持很差。建议大家先用本地的配置方式。

本地机器配置 — 亲测可用

查看当前 mcp 的安装

claude mcp list# 这里会看到没有 notion 安装> No MCP servers configured. Use `claude mcp add` to add a server.

安装 notion mcp

claude mcp add --transport http notion https://mcp.notion.com/mcp# 可以看到修改> File modified: /Users/wushuai/.claude.json [project: /Users/wushuai/Documents/create/code/claude-remote/Claude-Code-Remote]

再看下

claude mcp list ## 这次就有了 Checking MCP server health...notion: https://mcp.notion.com/mcp (HTTP) - ✓ Connected

ok, 进入 claude code

输入 /mcp

进入验证

会吐出一个网址，复制浏览器打开，输入 notion token, 指定claude 的工作区就 ok （服务器配置不能用这种方式的原因就是不能跨设备验证这个网页，可能要转发下端口到本地）

验证回到 claude code 可以看到

这就可以用了, tools 下的功能可以进去看下，基本就是

•

页面的增删改查

•

数据库的增删改查

应用场景可以

把我们在 claude 的工作内容总结整理到 notion

帮我们整理实验结果到 notion 的多维数据表格

当然如果你用的是飞书，飞书也有提供相应的 MCP API

除了授权完整的工作区，我们还可以授权单个的页面（以及下面的层级项目）

简单测试下

我这个教程就在 claude 工作区

让他读取这个文件来帮我看看有没有改进的地方

主要改进建议： 1. 代码块语言标记不准确 文档中使用 python 标记 shell 命令，应该改为 bash 或 shell： # 应该使用 bash 而不是 python claude mcp list claude mcp add --transport http notion https://mcp.notion.com/mcp 2. 服务器配置部分不完整 "Config 配置模式"提到了但说"配置不成功，后面再补充"，建议： - 要么完善这部分内容 - 要么暂时移除，避免给读者造成困惑 3. 测试部分未完成 "简单测试下"这一节只是提到要测试，但没有实际结果。建议： - 补充实际的测试案例和结果 - 或者现在就让我帮你完成这部分测试 4. 缺少故障排除部分 建议增加常见问题排查，例如： - MCP 连接失败怎么办 - 认证失败的处理 - 如何验证配置是否成功 5. 应用场景可以更具体 当前只列举了两个场景，建议补充： - 具体的使用示例命令 - 实际的工作流程演示 - 常用操作的最佳实践 6. 缺少卸载/管理说明 建议增加： # 如何移除 MCP 服务器 claude mcp remove notion # 如何更新配置 claude mcp update notion 7. 权限设置说明不够详细 "授权单个页面"部分只有截图，建议补充： - 详细的操作步骤 - 权限范围的说明 - 最佳实践建议 8. 验证流程可以更详细 建议明确说明： - 验证 URL 的格式 - 验证页面会出现什么 - 如何确认验证成功 9. 飞书 MCP 提及但未展开 如果要提及飞书，建议提供： - 飞书 MCP 的官方文档链接 - 或者移除这个提及，保持文档专注 10. 增加更多资源链接的可访问性 底部的链接可以添加： - Notion MCP 官方文档 - 常见问题解答 - 社区讨论链接

建议很多，但是我不听👂

我让它向结尾的部分插入点 Claude code 使用 Notion 提升生产力的建议吧

Claude Code 生成开始

使用 Claude Code + Notion 提升生产力

提示：定期让 Claude 整理和归档信息，保持 Notion 工作区的整洁性。

代码项目管理

•

自动记录技术决策：让 Claude 将架构设计、技术选型等关键决策整理到 Notion

•

实验结果追踪：自动将测试结果、性能数据写入 Notion 数据库，便于对比分析

•

代码审查笔记：审查代码时，让 Claude 总结问题和改进建议到 Notion

知识管理

•

学习笔记整理：研究新技术时，让 Claude 将关键信息结构化保存到 Notion

•

Bug 追踪：记录 bug 的发现、分析、解决过程，建立知识库

•

代码片段库：将常用的代码模式、解决方案整理成可搜索的 Notion 页面

工作流自动化

•

每日工作总结：让 Claude 分析 git 日志，自动生成工作日报到 Notion

•

文档同步：将项目 README、API 文档同步到 Notion，方便团队协作

•

任务跟踪：从代码注释或 TODO 生成任务清单到 Notion 数据库

快速开始命令

# 搜索 Notion 中的技术文档"搜索我 Notion 中关于 React Hooks 的笔记"# 创建项目总结"分析当前项目的代码结构，整理到 Notion 的'项目文档'页面"# 记录实验结果"将这次性能测试的结果添加到 Notion 的实验数据库"

Claude Code 生成结束

安全提示

•

不要分享 API 密钥

•

定期轮换 API 密钥

•

只授予必要的页面访问权限

•

妥善保管配置文件，避免提交到版本控制系统