连接你的 AI 助手

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

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

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 月 13 日按官方文档核对。

{
  "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 工具执行。需要编排多个步骤或定时任务，查看Agent 工作流与验证。

03 / 先用只读查询验证

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

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

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

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

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

修改操作先选定账户与对象，查出当前值，再核对方案。下面的两条指令适用于 ActionKey MCP；使用 Meta Graph 时，将内部 ID 替换为实际 Meta 资产 ID。

“计划内部 ID”来自 ActionKey 广告计划列表；广告组使用查询返回的 Facebook 广告组 ID。完整对应关系见资产 ID 说明。金额按账户币种和工具字段要求填写。

读取广告计划【计划内部 ID】的账户、预算类型、币种和当前预算。
核对是否使用广告计划预算；如果预算在广告组层级，请先说明。
给出日预算调整到【目标金额与账户币种】的方案，
展示具体对象和调整前后金额，等待我确认。

我确认刚才展示的账户、对象、币种和金额。
请执行这一次预算调整，然后重新查询实际预算，
报告工具执行结果以及调整前后值。失败时说明原因，不要重复创建或修改。

查询广告表现

查询指定账户或广告计划的花费、点击、转化和 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 审核与账户风控约束。代理不会清除已有资产关联；中转接入可减少客户另备个户和维护操作环境的环节。