文档目录

在 Codex (Desktop / CLI) 中使用 AdsCove

AdsCove 产品与工程团队 · 最后审核于 2026 年 8 月 5 日

已支持 · OAuth

Codex 原生支持远程 MCP 和 OAuth。建议使用命令添加服务器后登录,无需 API 密钥;授权页面会在浏览器中打开。

连接信息

连接所需的信息都在这里,你可以把任意一行复制到客户端或交给智能体:

MCP 端点:      https://adscove.com/api/mcp
传输方式:       Streamable HTTP
推荐授权:       OAuth 2.1(无需密钥)
备用授权:       HTTP 请求头 Authorization: Bearer sk_live_your_key(仅在 OAuth 不可用时)
REST 备用方式: POST https://adscove.com/api/v1/tools/{tool_name},使用相同的 Bearer 请求头
完整工具目录:   https://adscove.com/api/mcp?tools=full(可选;默认端点更快,并包含 run_adscove_tool)
验证工具:       list_connections(免费、只读)

安装步骤

  1. 运行下方命令
  2. 浏览器会打开 AdsCove 授权页 → 登录 → 点击授权
  3. 可选:安装 Codex Skills,增加本地 Meta 广告资料库采集和图片生成工作流
codex mcp add adscove --url https://adscove.com/api/mcp
codex mcp login adscove

mkdir -p ~/.codex/skills/adscove-meta-ad-library-capture ~/.codex/skills/adscove-ad-image-generation
curl -fsSL https://adscove.com/api/codex-skills/adscove-meta-ad-library-capture \
  -o ~/.codex/skills/adscove-meta-ad-library-capture/SKILL.md
curl -fsSL https://adscove.com/api/codex-skills/adscove-ad-image-generation \
  -o ~/.codex/skills/adscove-ad-image-generation/SKILL.md

或者:手动添加到 ~/.codex/config.toml

[mcp_servers.adscove]
url = "https://adscove.com/api/mcp"
http_headers = { Authorization = "Bearer sk_live_your_key" }

# Optional: list every low-level tool separately instead of the compact catalog.
# url = "https://adscove.com/api/mcp?tools=full"

或者:直接交给 AI 智能体

不想自己配置?把下面这段内容粘贴给正在使用的 AI 智能体(Claude、Cursor 或其他 MCP 智能体等),其中已经包含完成连接所需的全部信息。

在 Codex 中运行:codex mcp add adscove --url https://adscove.com/api/mcp && codex mcp login adscove。浏览器会打开 OAuth 授权页。如果需要本地广告资料库采集和图片生成工作流,可再从 /docs/skills 安装 AdsCove Codex Skills。最后调用 list_connections 验证。

验证连接

说:“检查我的平台连接状态。”

把 Meta Ads 和 Google Ads 连接到 Codex

如何把 Meta Ads 连接到 Codex?

运行 codex mcp add adscove --url https://adscove.com/api/mcp,再运行 codex mcp login adscove,在浏览器完成 OAuth。在 AdsCove 中连接你的 Meta 广告账户后,Codex 就能通过同一个 AdsCove 服务器访问它。让 Codex 检查平台连接状态即可确认。

Codex 有 Google Ads MCP 吗?

有,使用同一个 AdsCove 服务器,不需要再添加第二个地址:在 AdsCove 中连接 Google Ads 账户后,Codex 就能读取广告系列和搜索词,包括关联到该 Google Ads 客户的 Merchant Center 账户。

在 Codex 中使用 AdsCove 需要 API 密钥吗?

不需要。codex mcp login adscove 使用 OAuth,无需粘贴任何内容。只有上方手动写入 ~/.codex/config.toml 的备用方式才需要 AdsCove API 密钥,填在 http_headers 中。

连接 Meta 或 Google Ads 后,Codex 能直接修改我的广告吗?

读取会直接执行;预算、状态变更或新建草稿等写入操作会先返回待审批动作,由你批准或拒绝;新建广告系列默认为暂停状态,不会静默上线。

连接后可以做什么

查看业务报告、用真实 Shopify 订单核对平台 ROAS、创建暂停状态的广告草稿、提交预算变更;直接写入需要你的确认,另行启用的安全规则只能按设定自动暂停。可以试着问:“最近 7 天哪些广告在亏钱?”

开始使用