Claude Code - Notion MCP服务接入与使用教程

作者：hangge | 2026-08-05 09:33

Claude Code 是 Anthropic 官方推出的强大 AI 编程助手，而 MCP（Model Context Protocol）协议则让 Claude Code 能够连接外部工具和服务。通过接入 Notion MCP，Claude Code 可以直接读取、写入和管理你的 Notion 工作区。本文将详细介绍如何在 Claude Code 中接入 Notion MCP 服务，包括环境准备、配置步骤、认证流程以及实际应用案例，帮助大家快速实现 Claude 与 Notion 的深度集成。

一、基本介绍

1，MCP 是什么

（1）MCP（Model Context Protocol）是 Anthropic 推出的开放协议，用于连接 AI 模型与外部工具和服务。

（2）MCP 的核心价值：

标准化接口：提供统一的方式连接不同的外部服务
安全可控：支持权限控制和 OAuth 认证
易于扩展：开发者可以轻松创建自定义 MCP 服务器

（3）MCP 的三大核心原语：

Tools：AI 可以调用的功能函数
Resources：AI 可以访问的数据资源
Prompts：预定义的提示模板

2，Notion MCP 简介

（1）Notion MCP 是 Notion 官方提供的 MCP 服务器，支持 Claude Code 直接操作 Notion 工作区。主要功能如下：

页面操作：创建、更新、删除和搜索 Notion 页面
数据库管理：查询、创建和更新数据库内容
内容搜索：在工作区中搜索特定内容
权限控制：精细化的访问权限设置

（2）支持的两种传输方式：

HTTP：推荐使用，适用于大多数工具（mcp.notion.com/mcp）
SSE：Server-Sent Events，适用于旧版客户端（mcp.notion.com/sse）

提示：Notion MCP 是远程服务器，无需在本地安装和配置。只需简单的命令即可完成接入，大大降低了使用门槛。

三、接入配置步骤

1，添加 Notion MCP 服务器

（1）打开终端，进入 Claude Code 环境。执行以下命令添加 Notion MCP：

提示：可通过 --scope 参数指定安装范围

--scope local（默认）：仅当前项目可用

--scope project：通过 .mcp.json 共享给团队项目

--scope user：当前用户的所有项目全局可用

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

（2）命令执行后会显示配置成功信息：

2，验证 MCP 连接状态

（1）在 Claude Code 中使用 /mcp 命令查看已安装的 MCP 服务器：

/mcp

（2）输出结果应显示 notion 服务器及其状态，可以看到目前 notion 还处于未授权状态。

3，完成 OAuth 认证

（1）选中 notion 后，按下回车进入授权操作。然后选中“Authenticate”后回车。

（2）此时便会自动跳转到浏览器的 Notion 登录页，如果浏览器没有反应我们因可以复制链接手动粘贴到浏览器中进行访问。

（3）在浏览器中登录 notion 后选择要授权的工作区，确认权限即可完成绑定。

（4）再次在 Claude Code 中执行 /mcp，若 notion 显示 connected 状态，即为接入成功。

四、实际应用案例

1，搜索 Notion 页面

（1）连接成功后，可以在 Claude Code 中使用自然语言操作 Notion。例如我们要搜索 Notion 工作区中的页面：

列出我的 Notion 工作区中的所有页面

Claude Code 会调用 Notion MCP 的搜索功能，返回页面列表。

（2）或者我们也可以搜索特定内容：

提示：Claude Code 能够理解自然语言指令，自动调用相应的 MCP 工具。我们无需记忆具体的函数名称，只需描述我们想做什么即可。

在 Notion 中搜索包含"TCP/IP协议"的页面

此时就会返回包含指定内容的页面列表：

2，创建和更新页面

（1）创建新页面：

在我的 Notion 工作区创建一个名为"技术笔记"的新页面，内容包含今天的日期和学习计划

待命令执行完毕后可以看到 notion 中已经出现了刚刚创建的新页面：

（2）更新现有页面：

在"技术笔记"页面中添加一个新的章节，标题为"Claude Code 使用心得"

待命令执行完毕后查看 notion，可以看到指定页面已经自动添加了相关内容：

3，数据库操作

（1）创建数据库：

创建一个“学习笔记”数据库

（2）查询数据库内容：

查询我的任务数据库，显示所有状态为"进行中"的任务

（3）向数据库添加新记录：

在任务数据库中添加一条新任务：
- 任务名称：学习 Notion MCP
- 状态：进行中
- 优先级：高
- 截止日期：本周五

（4）Notion MCP 支持 data source 作为数据库的主要抽象，提供以下功能：

query-data-source：查询数据源（支持过滤和排序）
create-a-data-source：创建新数据源
update-a-data-source：更新数据源

附：构建 AI 第二大脑

结合 Claude Code 和 Notion MCP，可以帮我我们构建强大的 AI 第二大脑系统。

1，自动整理学习笔记

（1）比如我们希望 AI 自动将我们学习的内容整理成笔记，并存入到 Notion 中的指定数据库：

将我刚才关于 MCP 协议的学习内容整理成结构化的笔记，保存到 Notion 的"学习笔记"数据库中，添加标签"MCP"、"Claude Code"

（2）最终效果如下：

2，项目管理自动化

（1）我们可以将一些日常比较机械琐碎的工作交由 AI 处理，例如工具工作计划自动创建相应的任务：

根据我本周的工作计划，在 Notion 项目数据库中创建相应的任务，设置优先级和截止日期，并关联到相关的项目页面