Open API MCP — 工具说明与集成指南

使用本功能需要先找您的AM开白，否则MCP无法正常使用。

服务地址

• open_api_publisher_key 为开放平台下发的 Publisher Key，服务端据此进行签名请求（X-Up-Key、X-Up-Timestamp、X-Up-Signature）。

• 若该 MCP 启用了 RagFlow 能力，会暴露文档检索工具 rag_flow_retrieve_open_api_doc，与 Open API 工具配合使用（见下文）。

架构与调用流程

以下为与本组件实现一致的逻辑视图（传输层以 HTTP + JSON-RPC 为主）。

组件架构

调用时序图

工具行为说明（所有 Open API 工具共有）

在运行时，每个 Open API 工具的提示词描述末尾会自动追加以下内容：

当请求参数、返回值字段等有任何疑问时，须最大限度通过 rag_flow_retrieve_open_api_doc 工具检索相关文档。

所有创建、修改、更新类型的 Tool 调用都必须把改动友好的列出来提示用户。

Cursor 集成

1. 打开 Cursor Settings → MCP，或通过项目/用户目录下的 MCP 配置添加服务器。

2. 推荐使用 URL / Streamable HTTP 类远程 MCP，将 完整 URL 设为上述 Taku 地址（包含 open_api_publisher_key 查询参数）。

示例（~/.cursor/mcp.json 或项目 .cursor/mcp.json，以你当前 Cursor 版本文档为准；headers 字段名若与版本不符请按官方说明调整）：

{
  "mcpServers": {
    "taku-open-api": {
      "url": "https://open-mcp-api.takuad.com/mcp?open_api_publisher_key=YOUR_PUBLISHER_KEY",
      "headers": {}
    }
  }
}

保存后按 Cursor 要求 重启或重新加载 MCP；在聊天/Agent 中确认已列出 open_api_*

（及可选的 rag_flow_retrieve_open_api_doc）工具。

若你的 Cursor 版本区分 streamableHttp 与 sse，请按官方 MCP 文档 选择与本服务传输方式一致的类型（本仓库实现为 HTTP + SSE 传输层，以实际网关暴露为准）。

Claude Code 集成

Claude Code 支持为远程 MCP 指定 HTTP 传输。将完整 MCP URL（含 open_api_publisher_key）注册为一条 MCP 记录即可；

示例（命令行，名称可自定）：

claude mcp add --transport http taku-open-api \
  "https://open-mcp-api.takuad.com/mcp?open_api_publisher_key=YOUR_PUBLISHER_KEY"

验证：

claude mcp list

更多选项（如自定义 Header、作用域）见 Connect Claude Code to tools via MCP。

Codex 集成

本文介绍如何在 Codex 中配置 Taku Open API MCP Server。配置完成后，Codex 可通过 MCP 调用 Taku Open API 提供的工具能力。

前置条件

在开始配置前，请先准备好你的 PUBLISHER_KEY。

MCP Server 地址格式如下：

https://open-mcp-api.takuad.com/mcp?open_api_publisher_key=你的_PUBLISHER_KEY

请将 你的_PUBLISHER_KEY 替换为实际的 Publisher Key。

配置方式一：使用 Codex CLI 添加

推荐使用 Codex CLI 添加 MCP Server：

codex mcp add taku-open-api --url "https://open-mcp-api.takuad.com/mcp?open_api_publisher_key=你的_PUBLISHER_KEY"

添加完成后，重启 Codex，或新建一个 Codex 会话，使配置生效。

配置方式二：手动编辑配置文件

你也可以手动编辑 Codex 配置文件：

~/.codex/config.toml

在配置文件中添加以下内容：

[mcp_servers.taku-open-api]
url = "https://open-mcp-api.takuad.com/mcp?open_api_publisher_key=你的_PUBLISHER_KEY"

保存文件后，重启 Codex，或新建一个 Codex 会话，使配置生效。

QClaw 集成

对话框输入

帮我集成 https://open-mcp-api.takuad.com/mcp?open_api_publisher_key=你的_PUBLISHER_KEY 这个 mcp server

提供你的 Publisher Key 后，QClaw 会自动完成集成。

Workbuddy 集成

侧边栏点击「专家」 - 「连接器」 - 「自定义连接器」

点击右上角「配置 MCP」输入下方 MCP 配置后点击保存即可。

{
  "mcpServers": {
    "taku-open-api": {
      "url": "https://open-mcp-api.takuad.com/mcp?open_api_publisher_key=<YOUR_PUBLISHER_KEY>"
    }
  }
}

Dify 集成

Dify 当前仅支持通过 HTTP transport 连接外部 MCP Server（见 Using MCP Tools）。

1. 在工作空间进入 Tools → MCP。

2. 选择 Add MCP Server (HTTP)。

3. Server URL 填写完整地址，例如：https://open-mcp-api.takuad.com/mcp?open_api_publisher_key=YOUR_PUBLISHER_KEY

4. 设置 Name、Icon；Server ID 需为小写字母、数字、下划线或连字符，最多 24 字符，且 创建后不要改动（否则依赖该服务器的应用会异常）。

5. 保存后 Dify 会自动拉取工具列表；若工具有变更，在服务器卡片上使用 Update Tools。

在 Agent / 工作流 / Agent 节点 中即可选用来自该 MCP 的工具；可在工具上为参数设置 Fixed（固定值）或 Auto（由模型填写）。

导出使用 MCP 的应用时，请在文档中注明依赖的 MCP 地址与 一致的 Server ID，以便在其他环境复现。

Open API 工具一览（按业务域）

下列 名称 即 MCP tools/list 返回的 name。

应用

广告位

广告平台（Network）

广告源（Units）

聚合 / 流量分组（Mediation）

聚合广告源 / Waterfall

A/B 测试

服务端回调规则（激励）

数据报表

设备层级报表

关联工具：rag_flow_retrieve_open_api_doc