通过聊天调用 ActionKey

01 / 先确认你拿到哪种凭证

Claude Code、Codex、Gemini CLI 等支持工具调用的助手可以连接广告接口。开始前，先区分凭证来源，选对接入方式。

1. 确认账户与资产授权。使用 ActionKey 中转服务时，广告户完成 BM 分享和相应授权，客户无需另外准备个户。使用 System User 时，同时核对广告户和主页权限。
2. 准备已安装并登录的助手。本页提供 Claude Code、Codex CLI、Gemini CLI 的配置，也介绍 Grok 连接器和 API 接入入口。
3. 准备 ActionKey 连接凭证。只在客户端凭证设置或运行环境中保存。CLI 用户先完成环境变量设置，再复制对应配置。

02 / 选择你的 AI 助手

MCP 是助手调用外部工具的连接方式。下面三个 CLI 配置都连接同一个 ActionKey 服务；选择你已在使用的助手即可。

配置里的 yuri 与 YURI_TOKEN 是本教程使用的本地标识，产品名称为 ActionKey；沿用已有配置即可。

https://baiz.ai/mcp

接口说明文件 ↗ 用于了解能力；连接服务器时填写上面的 MCP 地址。客户端版本与设置可能变化，下述配置已于 2026 年 10 月 14 日按官方文档核对；这是配置核验，仍需用你自己的有效凭证实测连接。

{
  "mcpServers": {
    "yuri": {
      "type": "http",
      "url": "https://baiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${YURI_TOKEN}"
      }
    }
  }
}

claude

codex mcp add yuri --url https://baiz.ai/mcp --bearer-token-env-var YURI_TOKEN

[mcp_servers.yuri]
url = "https://baiz.ai/mcp"
bearer_token_env_var = "YURI_TOKEN"
default_tools_approval_mode = "prompt"

codex

{
  "mcpServers": {
    "yuri": {
      "httpUrl": "https://baiz.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${YURI_TOKEN}"
      },
      "trust": false
    }
  }
}

gemini

import os

# 合并到 xAI Responses API 请求的 tools 列表。
# 将占位工具名替换为服务实际返回的只读工具名。
yuri_tool = {
    "type": "mcp",
    "server_label": "yuri",
    "server_url": "https://baiz.ai/mcp",
    "authorization": f"Bearer {os.environ['YURI_TOKEN']}",
    "allowed_tools": ["替换为实际账户查询工具名"],
}

set_yuri_token() {
  printf '请输入 ActionKey 连接凭证：'
  IFS= read -r -s YURI_TOKEN
  printf '\n'
  export YURI_TOKEN
}
set_yuri_token

$yuriSecureToken = Read-Host '请输入 ActionKey 连接凭证' -AsSecureString
$env:YURI_TOKEN = [System.Net.NetworkCredential]::new('', $yuriSecureToken).Password
Remove-Variable yuriSecureToken

拿到 System User Token 时，直接查看Meta Graph API 接入，通过 Agent 的代码工具或你自己提供的 API 工具执行。需要编排多个步骤或定时任务，查看AI Agent 调用。

03 / 先用只读查询验证

确认服务工具已加载后，将这条指令发送给你选择的助手：

请使用 yuri 的查询工具，列出当前 ActionKey 凭证可访问的 Facebook 广告账户。
分别展示账户名称、ActionKey 内部 ID 和 Facebook 广告账户 ID。
检查实际工具结果中的成功状态与错误；本次只查询，不修改广告。

核对工具实际调用、返回的成功状态和账户列表。列表应与开通范围一致；空列表需核对资产授权，不能只凭助手说“连接成功”判断接入完成。

报表返回 errors 时，可能存在部分账户拉取失败，要求助手注明缺失范围。服务接口查询与 Meta 原生 Graph 查询采用不同 ID 和返回格式，按选定路线解析。

04 / 查询、确认、执行、回读

修改操作先选定账户与对象，查出当前值，再核对方案。下面的预算指令适用于 ActionKey 的预算调整工具；使用 Meta Graph 时，需按实际端点核对操作对象、字段与影响范围。

“计划内部 ID”来自 ActionKey 广告计划列表；广告组使用查询返回的 Facebook 广告组 ID。完整对应关系见资产 ID 说明。Graph 路线的金额字段与单位按具体端点确认。

用【计划内部 ID】定位并核对关联广告账户，读取账户实际预算字段、当前值、预算类型和币种。
给出把关联账户日预算设为【目标美元金额 USD】的方案：action 为 set，budget_field 为 limit_daily_amount，amount 为该目标金额。
核对 USD 与账户币种的换算及同步规则，说明对同一账户其他投放的影响范围。
查询缺少关联账户、实际预算字段或币种时停止，不猜测；联系团队确认查询方式。
展示定位计划 ID、关联账户、预算字段、调整前后值与影响范围，等待我确认。

我确认定位计划 ID、关联账户、预算字段、USD 金额、币种与换算规则，并接受对同户其他投放的影响范围。
请通过该计划 ID 执行这一次关联广告账户预算调整，再查询对应计划和关联账户的实际预算字段。
报告接口结果与调整前后值。回读无法核对实际账户预算时，说明未确认成功。
不要仅凭接口 success 宣称完成；失败、超时或回读不一致时说明原因，不重复修改。

查询广告表现

查询指定账户或广告计划的花费、点击、转化和 CPA。
注明实际返回的数据时间范围、账户币种和缺失账户，列出需要关注的广告。

准备创建广告时

让助手核对广告户、主页、素材、文案、受众、落地页和投放目标，整理预算与时间后再执行。ActionKey 接口创建广告计划会触发发布流程；完成后还需查询发布结果和实际状态。

常见问题

服务怎么收费？

固定服务费 ¥5,000 / 月，不限制请求数。广告消耗、AI 助手或模型服务及运行环境费用另行承担。具体授权资产和操作范围在开通时确认，Meta 及模型服务自身的接口限制仍适用。

已经有 System User Token，还要配置 MCP 吗？

可以通过 Agent 的代码 / API 工具直接调用 Meta Graph API，参照系统用户路线。如果要用 ActionKey MCP，需要单独开通 ActionKey 服务凭证。

为什么把中转 access_token 填入 Facebook 域名会失败？

尤里改内部中转凭证用于代理域名 facebook-graph.baiz.ai。现有代码需同时修改请求域名和凭证；接口路径、版本与字段按业务需要确认。查看Graph 中转配置。

连接失败或资产缺失怎么办？

先确认凭证类型、环境变量、服务地址与工具是否加载。System User 路线还要核对 App 权限以及广告户和主页分配。联系微信 76762 时提供助手版本、错误信息和时间，截图隐藏完整凭证。

能规避 Facebook 风控吗？

所有操作仍受 Facebook 审核与账户风控约束。代理不会清除已有资产关联；中转接入可减少客户另备个户和维护操作环境的环节。