连接器版本 1.0.0

Notion 官方 MCP 授权

通过 OAuth 授权 Notion 官方托管的 MCP 服务,以你自己的身份访问页面与数据库。平台在 Notion 的授权服务器上自动注册客户端,你只需在 Notion 的页面上同意授权。

商品介绍

该连接器只声明 Notion 官方 MCP 服务的地址。授权端点、令牌端点与客户端注册端点均在首次授权时从该服务公布的 OAuth 元数据中发现,未经真实环境验证。

价格

连接器本身不计费;使用它的商品按各自的价格计费。

接入指南

  1. 在控制台创建连接

    组织的所有者或管理员在控制台“连接”中选择此连接器。连接属于组织,不属于个人。

  2. 使用你的账号授权

    你会被带到服务方的授权页面登录并同意授权,不需要填写密钥。授权信息由平台加密保存,并由平台负责刷新。

  3. 开通并调用需要它的商品

    需要此连接器的商品会在卡片和详情页标明“需要连接”。连接建立后,这些商品的调用会使用你组织的授权。

  4. 创建凭证

    在控制台“凭证”中创建一个凭证。密钥只显示一次,请保存为环境变量;它代表你的组织,调用产生的费用记入组织钱包。

    export ZGI_MARKET_KEY=zgi_sk_...

  5. 在智能体客户端中接入

    把下面的 MCP 服务添加到支持 MCP 的客户端(Claude Code、Cursor 等)。客户端连接的是 ZGI 市场的网关,网关会带上你组织在此连接器上的授权去调用上游。

    Notion 官方 MCP
    https://market-api.zgi.im/v1/mcp/notion-official
    Claude Code
    claude mcp add --transport http notion-official \
      "https://market-api.zgi.im/v1/mcp/notion-official" \
      --header "Authorization: Bearer $ZGI_MARKET_KEY"
    其他客户端(mcpServers 配置)
    {
      "mcpServers": {
        "notion-official": {
          "type": "http",
          "url": "https://market-api.zgi.im/v1/mcp/notion-official",
          "headers": {
            "Authorization": "Bearer ${ZGI_MARKET_KEY}"
          }
        }
      }
    }
  6. 验证是否可用

    添加后,客户端应能列出下方“连接后可以使用的工具”。也可以直接用命令调用一个只读工具;返回“没有可用的连接”说明授权尚未完成或已失效。

    调用 notion_search
    curl "https://market-api.zgi.im/v1/mcp/notion-official" \
      -H "Authorization: Bearer $ZGI_MARKET_KEY" \
      -H "Content-Type: application/json" \
      -H "Accept: application/json, text/event-stream" \
      -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"notion_search","arguments":{}}}'

连接后可以使用的工具

连接器本身不提供功能。建立连接后,下列商品可以用你的账号调用这些工具;商品需要另行开通。

Notion 官方 MCP7 个工具

Notion 官方 MCP
工具用途风险等级
notion_search在已授权的 Notion 工作区中搜索只读
notion_fetch按链接或 ID 读取页面或数据库只读
notion_get_comments读取页面上的评论只读
notion_get_users列出工作区成员只读
notion_create_pages创建一个或多个页面写入
notion_create_comment在页面上发表评论写入
notion_update_page修改页面的属性或内容,可以替换或删除已有内容可删改

来源与审核

审核状态
审核中
许可证
未说明

审核状态是平台对上架信息的记录,不构成对上游服务质量或可用性的担保。