连接器版本 1.0.0

Notion 连接器

用 Notion 内部集成(Internal integration)的令牌连接你自己的工作区,供工具访问已共享给该集成的页面与数据库。

商品介绍

Notion API 要求每个请求携带 Notion-Version 请求头,因此连接时需要填写一个 API 版本。

价格

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

接入指南

  1. 在控制台创建连接

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

  2. 填写你自己的凭据

    创建连接时需要填写下列信息,保存后加密存储:

    • 内部集成令牌必填 · 保密
    • Notion API 版本必填
  3. 开通并调用需要它的商品

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

  4. 创建凭证

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

    export ZGI_MARKET_KEY=zgi_sk_...

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

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

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

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

    调用 search
    curl "https://market-api.zgi.im/v1/mcp/notion-tools" \
      -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":"search","arguments":{}}}'

连接后可以使用的工具

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

Notion 工具4 个工具

Notion 工具
工具用途风险等级
search按标题搜索已共享给集成的页面与数据库只读
get_page读取一个页面的属性只读
query_database按筛选与排序条件查询一个数据库只读
append_blocks向页面或内容块追加子内容块写入

来源与审核

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

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