AI导哈

Notion MCP服务器

一个Model Context Protocol (MCP)服务器，通过官方Notion SDK使AI模型能够与Notion工作区交互。

  • by ramidecodes
  • TypeScript
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 ramidecodes/mcp-server-notion

使用说明

MCP服务器概念

一个模型上下文协议（MCP）服务器，它公开了官方的Notion SDK，允许AI模型与Notion工作区进行交互。

快速开始

1.设置您的Notion集成

  1. 首选 https://www.notion.so/my-integrations
  2. 创建新的集成
  3. 复制API密钥

2.将您的Notion页面连接到集成

为了使您的集成能够访问Notion内容，您需要明确地与它共享您的页面或数据库：

  1. 导航到要通过集成访问的Notion页面或数据库
  2. 点击右上角的“分享”按钮
  3. 在“添加人员、组或集成”字段中，从下拉列表中选择您的集成
  4. 点击“邀请”
  5. 对要访问的每个页面或数据库重复此操作

注： 集成只能访问与其显式共享的页面和数据库。子页面会自动继承父页面的访问权限。

3.添加到您的AI助手

您可以使用以下任一配置格式将此MCP服务器添加到Claude Desktop、Cursor AI或Claude.AI：

命令行格式

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON配置格式

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

替换 your-notion-integration-key 使用步骤1中的API密钥。

安装说明

  • 克劳德桌面：设置>高级>模型上下文协议
  • 光标AI：设置>AI>MCP服务器
  • Claude.ai（网络版）：配置文件>设置>API和集成>模型上下文协议

可用工具

服务器提供与Notion交互的工具：

  • 搜索：查找页面或数据库
  • 数据库：查询和检索数据库条目
  • 页面：创建、检索和更新页面
  • 积木：管理内容块（段落、列表等）
  • 用户：列出用户并获取用户信息
  • 评论：创建并列出评论
  • 链接预览：为URL创建链接预览

替代设置方法

使用环境变量

您可以使用 .env 文件：

  1. 创建一个 .env 文件包含：
NOTION_API_KEY=your-notion-integration-key
  1. 运行服务器：
npx @ramidecodes/mcp-server-notion@latest -y

带环境变量的JSON配置（适用于Claude Desktop）

您还可以使用JSON配置格式的环境变量：

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

命令行选项

OPTIONS:
  -h, --help              Show help message
  -v, --version           Show version information
  --verbose               Enable verbose logging
  --env-path <path>       Path to .env file
  --api-key <key>         Notion API key
  -y                      Skip confirmation prompts

故障排除

如果遇到“创建客户端失败”错误：

  • 在Windows上，尝试使用 cmd /c 在npx命令之前
  • 在macOS/Linux上，尝试使用npx的完整路径
  • 在将命令添加到AI助手之前，先在终端中测试该命令

常见问题

  • “无法访问资源”错误：确保您已将特定的Notion页面或数据库与您的集成共享（请参阅步骤2）
  • 集成未出现在共享菜单中：尝试刷新页面或重新启动浏览器
  • 能力有限：检查您的集成是否在Notion集成设置中启用了相应的功能

特性

  • 通过官方SDK提供完整的Notion API支持
  • 符合MCP标准，实现无缝AI集成
  • 适用于所有Notion操作的综合工具
  • 具有详细消息的稳健错误处理
  • 轻松配置环境变量

有关每个工具的详细文档，请参阅 工具文档.

许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP