跳过主要内容
已上线产品

Codex 集成

从 Codex CLI 或桌面 Agent 搜索并草拟广告。

Codex 支持基于 HTTP 的 Model Context Protocol 服务器。用项目令牌将 Codex 指向 TexoAI 的 MCP 端点，六个工具即可在 Codex 会话中使用。所有操作都限定在单个项目内，不涉及广告账户。

连接方式

MCP可用

服务器通过 HTTPS POST 响应 initialize、notifications/initialized、tools/list 与 tools/call（JSON-RPC 2.0）。通知返回空的 202；同样的工具始终可作为普通 API 调用。

接入步骤

  1. 创建令牌
    在开发者设置中创建项目令牌并勾选所需权限范围（ads:read、boards:read、monitors:read、jobs:read、clones:submit），复制一次性 mad_ 值。
  2. 添加 MCP 服务器
    把服务器加入 Codex 配置，让 Codex 能访问该端点。
    Codex · 接入步骤
    [mcp_servers.meta-ads]
url = "https://<your-site>/api/developer/mcp"
http_headers = { Authorization = "Bearer mad_..." }
  3. 重启并测试
    重启 Codex 让服务器加载，然后让它列出可用工具或搜索广告库。

试一试

服务器连接成功后，快速冒烟检查：

codex exec "list the tools available through the meta-ads MCP server"
codex exec "search the ad library for running ads"

可用工具

ads.search
只读
ads:read
ads.get
只读
ads:read
ads.live_search_start
写入
ads:live
ads.live_search_get
只读
ads:read
boards.list
只读
boards:read
monitors.list
只读
monitors:read
jobs.get
只读
jobs:read
clones.submit
写入
仅限已批准的草稿静态任务；绝不会发布到广告账户。

常见错误

失败以 HTTP 400 加 JSON-RPC 错误对象（code + message）返回，而不是 HTTP 401/403/429。

-32001 — 令牌无效或缺失
tools/call 需要有效的 Authorization: Bearer mad_... 头。缺失与无效令牌均返回 JSON-RPC -32001（HTTP 400）。initialize、notifications/initialized 与 tools/list 不需要令牌。
-32003 — 权限范围不足
令牌有效但缺少该工具所需的权限范围，返回 JSON-RPC -32003（HTTP 400）。可在开发者设置中修改令牌范围，或改用只读工具。
-32003 — 超过速率限制
该令牌的一分钟窗口已用尽，同样返回 JSON-RPC -32003（HTTP 400）。等待重置，或在开发者设置中提高速率上限。
-32603 — 工具调用失败
服务端执行工具调用失败。HTTP 状态仍为 400；请根据 JSON-RPC id 与 message 排查。

常见问题

相关集成

Claude Code

从 Claude Code 终端搜索并草拟广告。

Cursor

从 Cursor 编辑器搜索并草拟广告。

API

所有集成背后的原始 JSON-RPC 能力。