跳过主要内容
已上线产品

Cursor 集成

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

Cursor 支持在 .cursor/mcp.json 中配置 MCP 服务器。用项目令牌添加 TexoAI 端点,在 Cursor 设置中启用服务器,六个工具即可供 Cursor 的 Agent 使用。

连接方式

MCP可用

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

接入步骤

  1. 创建令牌
    在开发者设置中创建项目令牌,复制一次性 mad_ 值。
  2. 添加 .cursor/mcp.json
    把服务器加入项目 .cursor/mcp.json(或全局配置),让 Cursor 可以访问。
    Cursor · 接入步骤
    {
      "mcpServers": {
        "meta-ads": {
          "url": "https://<your-site>/api/developer/mcp",
          "headers": { "Authorization": "Bearer mad_..." }
        }
      }
    }
  3. 启用并测试
    打开 Cursor 设置 → MCP,确认服务器已启用,然后让 Cursor 搜索广告库。

可用工具

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 排查。

常见问题