菜单

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

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

服务地址

平台 MCP Server URL（需替换{your_publisher_key}）
Taku https://open-mcp-api.anythinktech.com/mcp?open_api_publisher_key={your_publisher_key}

  • 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 查询参数）。

  3. 服务端要求 JWT 验证，在同一服务器配置中增加 HTTP Header：Authorization: Bearer YOUR_JWT_TOKEN（见上文「HTTP 鉴权（JWT）」）。

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

json 复制代码 
{
  "mcpServers": {
    "taku-open-api": {
      "url": "https://open-mcp-api.anythinktech.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 记录即可；若需 JWT，请按 Claude Code 文档为同一 MCP 配置 Authorization: Bearer YOUR_JWT_TOKEN（与上文「HTTP 鉴权（JWT）」一致）。

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

bash 复制代码 
claude mcp add --transport http taku-open-api \
  "https://open-mcp-api.anythinktech.com/mcp?open_api_publisher_key=YOUR_PUBLISHER_KEY"

验证：

bash 复制代码 
claude mcp list

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

Dify 集成

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

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

  2. 选择 Add MCP Server (HTTP)。

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

  4. 若 Dify 的 HTTP MCP 配置支持 自定义 Header（或等价项），添加 **Authorization**，值为 **Bearer YOUR_JWT_TOKEN**（见上文「HTTP 鉴权（JWT）」）。

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

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

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

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

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

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

应用

工具名 说明
open_api_app_list 应用 获取应用列表
open_api_app_create 应用 创建应用
open_api_app_update 应用 修改应用信息

广告位

工具名 说明
open_api_placement_list 广告位 获取广告位列表
open_api_placement_deal 广告位 批量创建和修改广告位
open_api_placement_status 广告位 批量开启/关闭广告位
open_api_placement_delete 广告位 批量删除广告位

广告平台（Network）

工具名 说明
open_api_network_list 广告平台 获取广告平台 Publisher、App 维度参数列表
open_api_network_set 广告平台 创建或修改广告平台 Publisher、App 维度参数
open_api_network_custom_list 广告平台 获取自定义广告平台 Publisher 维度信息列表
open_api_network_custom_set 广告平台 自定义广告平台的创建和修改
open_api_network_app_auths 广告平台 绑定平台账号的 App 维度参数。纯自定义平台传{} 即可。

广告源（Units）

工具名 说明
open_api_units_list 广告源 获取广告源列表
open_api_units_create 广告源 创建广告源。创建成功后默认为解绑+关闭状态，需再调用聚合管理相关接口在指定流量分组绑定和开启。
open_api_units_detail 广告源 获取广告源详情
open_api_units_update 广告源 修改广告源
open_api_units_delete 广告源 批量删除广告源。当前为 v1 接口，后续将升级 v3。

聚合 / 流量分组（Mediation）

工具名 说明
open_api_mediation_group_list 聚合/流量分组 获取指定广告位下的所有聚合分组
open_api_mediation_segment_list 聚合/流量分组 获取指定聚合分组下的所有流量分组
open_api_mediation_segment_create 聚合/流量分组 创建流量分组
open_api_mediation_segment_attributes 聚合/流量分组 批量修改流量分组在 waterfall 的属性（已过期，请使用 Api9 修改高级设置策略）
open_api_mediation_segment_delete 聚合/流量分组 删除流量分组。正在做实验的分组不可删除。
open_api_mediation_segment_priority 聚合/流量分组 调整流量分组优先级
open_api_mediation_segment_update 聚合/流量分组 更新流量分组
open_api_mediation_strategies_list 聚合/流量分组 获取广告位流量分组高级设置策略
open_api_mediation_strategies_update 聚合/流量分组 修改广告位流量分组高级设置策略。正在做实验的分组可能不生效。

聚合广告源 / Waterfall

工具名 说明
open_api_waterfall_units_list 聚合广告源 获取广告源所有 waterfall 属性。做实验时同一 segment_id 可能有多条。
open_api_waterfall_units_status 聚合广告源 批量开启/关闭 waterfall 广告源。仅能操作已绑定到该流量分组的广告源。
open_api_waterfall_units_update 聚合广告源 编辑（绑定+开启）广告源所有 waterfall 属性。未绑定的广告源会在修改时一并绑定。
open_api_waterfall_segment_units_list 聚合广告源 获取指定流量分组下所有广告源（不含 adx）。不支持有在做实验的流量分组，否则请用 API6。
open_api_waterfall_abtest_segment_units_list 聚合广告源 获取指定流量分组、A/B 测试分组下的所有广告源（不含 adx）。无实验时 abtest_group_item_id 传 0。
open_api_waterfall_segment_units_update 聚合广告源 批量修改指定流量分组下广告源在 waterfall 的属性（已过期，建议使用 Api5 编辑广告源所有 waterfall 属性）

A/B 测试

工具名 说明
open_api_abtest_list AB测试 获取 A/B 测试列表
open_api_abtest_create AB测试 创建 A/B 测试
open_api_abtest_detail AB测试 获取 A/B 测试详情
open_api_abtest_update AB测试 更新 A/B 测试
open_api_abtest_start_manual AB测试 手动开启 A/B 实验（仅对手动类型生效）
open_api_abtest_stop AB测试 停用 A/B 测试（指定广告位选定的实验分组）

服务端回调规则（激励）

工具名 说明
open_api_reward_rule_list 服务端回调规则 获取服务端激励回调规则
open_api_reward_rule_create 服务端回调规则 创建服务端激励回调规则
open_api_reward_rule_update 服务端回调规则 修改服务端激励回调规则
open_api_reward_rule_delete 服务端回调规则 删除服务端激励回调规则

数据报表

工具名 说明
open_api_report_full 数据报表 综合报表。支持多维度 group_by、多指标 metric，开通权限后约 2～3 小时可拉取数据，仅能获取开通日向前推 10 天及之后的数据。
open_api_report_tk_hour 数据报表 分小时报表。数据约每 5 分钟更新，仅支持查询日期跨度 10 天内的数据。
open_api_report_roi 数据报表 ROI 报表。按归因平台、投放平台等维度查询新增用户、成本、安装、ROI 等。
open_api_report_roi_ltv 数据报表 ROI LTV 报表。按归因与投放维度查询新增用户、成本、安装及 1～60 天 LTV。
open_api_report_retention 数据报表 留存价值报表 - 留存（2～60 天）。最多查询今天往前推 1 天数据，建议晚上 10 点后再拉昨日数据。
open_api_report_impnewuser 数据报表 留存价值报表 - 展示和新增用户（1～60 天）。对应后台展示模块，支持新增用户数；报表延迟一天。
open_api_report_ltv 数据报表 留存价值报表 - LTV（1～60 天）。仅支持 API 统计回传；最多查询今天往前推 1 天数据，建议晚上 10 点后再拉昨日数据。

设备层级报表

工具名 说明
open_api_devicereport_get 设备层级报表 获取展示、点击设备维度报表。返回报表文件下载链接，数据仅保留最近 30 天，仅支持 1 天前的日期；时区与更新点见文档说明。

关联工具：rag_flow_retrieve_open_api_doc

工具名 说明 入参
rag_flow_retrieve_open_api_doc 从 RagFlow 知识库中检索 Open API 相关接口文档 question（string，必填）：检索问题或查询文本
最近修改: 2026-03-27Powered by