# Notion MCP

Notion官方托管模型上下文协议（MCP）服务器。将AI工具（如Claude、Cursor和ChatGPT）安全连接到您的Notion工作区，支持实时读取、搜索、创建和更新操作，采用OAuth认证—无需API密钥或自行托管。

Canonical URL: https://a2a-mcp.org/entry/notion-mcp-zh

Language: zh

Category: MCP Servers

Updated: 2026-03-21

## 概述

Notion MCP 是由 Notion 提供的 **官方托管 Model Context Protocol (MCP) 服务器**。它使 AI 助手和代理能够使用开放的 MCP 标准，安全高效地与 Notion 工作空间进行交互。

用户无需管理 API 密钥或自行托管服务器，只需通过简单的 OAuth 2.0（带 PKCE）进行连接。服务器运行地址为 `https://mcp.notion.com/mcp`（推荐的流式 HTTP 传输）和 `https://mcp.notion.com/sse`（备用方案）。

它由 Notion 积极维护，并为现代 AI 工作流程优化，替代了已不再积极维护的旧开源项目 `notion-mcp-server`。
![图片](https://cdn.a2a-mcp.org/blog/G3-NFZaElpXp2ZSBVQYZv.webp)

## 主要特性

- **安全的 OAuth 认证**：连接过程中进行细粒度权限范围划分 — 无长期暴露的令牌。
- **20+ AI 优化工具**：包括 `notion-search`（跨越工作空间及连接的来源，如 Slack、Google Drive、Jira）、数据库查询（已更新为 2025-09-03 API 数据源）、页面创建、块追加、属性更新、评论等。
- **实时双向访问**：读取富文本内容（自动转换为 Markdown 以提高令牌效率）、创建/更新页面和数据库、添加评论。
- **零基础设施**：完全托管并始终保持最新 — 无需 Docker、服务器或维护。
- **流式支持**：现代传输方式带来更快的响应和更好的代理体验。
- **广泛的客户端兼容性**：原生支持 Claude Desktop、Cursor、VS Code、ChatGPT（需调整工具名）和自定义 MCP 客户端。

## 工作原理

Notion 同时托管 MCP 服务器和底层的 Notion API。AI 工具中的 MCP 客户端会自动发现可用工具，通过自然语言调用它们，并接收结构化结果。代码生成管道将 Notion 的 OpenAPI 架构转换为经过验证的 MCP 工具（使用 Zod），确保高质量和一致性。

## 设置选项

- **推荐方案**：一键画廊连接或直接 URL 导入 (`https://mcp.notion.com/mcp`)。
- **Claude**：执行 `claude mcp add --transport http notion https://mcp.notion.com/mcp`，然后通过 `/mcp` 进行认证。
- **Cursor**：在设置中添加为全局 MCP 服务器。
- **自定义客户端**：遵循 Notion 的 OAuth + PKCE 指南来构建自己的集成。

## Notion MCP 与旧版开源服务器

旧版 GitHub 仓库 (`makenotion/notion-mcp-server`) 仍然可用，但 **不再积极维护**。Notion 强烈推荐使用托管版本，以获得更好的安全性、性能、易用性以及与最新 API 更改的兼容性。

## 使用场景

- 知识工作者总结笔记并自动创建行动项。
- 开发者在 Cursor 或 Claude 中编码时直接引用 Notion 规范/数据库。
- 团队构建自主代理来管理路线图、wiki、任务和评论。
- 内容创作者生成和维护具有实时交叉引用的动态文档。

## 支持工具（部分列表）

- `notion-search` — 支持筛选器的强大全文搜索功能。
- 数据库与数据源操作（查询、创建、更新）。
- 页面与块管理（追加、更新富文本）。
- 评论与工作区列表功能。

工具持续更新，与 Notion API 的演进保持同步。

## 快速开始

立即访问官方文档 [developers.notion.com/guides/mcp/mcp](https://developers.notion.com/guides/mcp/mcp)，连接您的 AI 工具。

Notion MCP 代表了无缝、安全的 AI 与生产力工具集成标准 —— 堪称 Notion 生态系统中“AI 智能体的 USB-C 接口”。

## Tags

- notion
- mcp
- 模型上下文协议
- ai集成
- 托管服务器
- oauth
- claude
- cursor
- 生产力
- 数据库
- 工作区

## Sources

- [Project website](https://developers.notion.com/guides/mcp/mcp)