跳过主要内容
已上线产品

Claude Code 集成

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

Claude Code 通过 HTTP 连接 MCP 服务器。用 claude mcp add 或项目 .mcp.json 以项目令牌添加 TexoAI 端点,即可在任何 Claude Code 会话中使用六个工具。

连接方式

MCP可用

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

接入步骤

  1. 创建令牌
    在开发者设置中创建项目令牌,复制一次性 mad_ 值。
  2. 注册服务器
    用 claude mcp add 注册服务器,或加入项目 .mcp.json 以便团队共享。
    Claude Code · 接入步骤
    claude mcp add meta-ads \
      --transport http https://<your-site>/api/developer/mcp \
      --header "Authorization: Bearer mad_..."
    
    # or share it with a team in a project .mcp.json
    # {
    #   "mcpServers": {
    #     "meta-ads": {
    #       "type": "http",
    #       "url": "https://<your-site>/api/developer/mcp",
    #       "headers": { "Authorization": "Bearer mad_..." }
    #     }
    #   }
    # }
  3. 测试连接
    运行 claude mcp list 确认服务器已注册,然后让 Claude 搜索广告库。

试一试

服务器连接成功后,快速冒烟检查:

claude mcp list
claude -p "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 排查。

常见问题