rocket_launch ASAPilot
开始使用

MCP 快速开始

用 Model Context Protocol 在 5 分钟内把 IDE、agent framework 或自定义 runtime 接到 ASAPilot。

面向开发者

如果你只使用 ASAPilot dashboard,其实不用了解这些工具。它们主要给 Claude Code、Cursor 这类 AI coding tools 使用。

什么是 MCP?

Model Context Protocol 是一个开放标准,让 AI assistant 可以访问外部工具和数据源。ASAPilot 把 chat、账户查询和自动化管理能力暴露成 MCP server,方便你在任意兼容环境里接入 Apple Search Ads 工作流。

步骤 1:Provision 一个 MCP channel

  1. 登录 app.asapilot.com,进入 Channels。
  2. 在 MCP 卡片上点击 Provision。
  3. 复制生成的 MCP server URL 和 API key,下一步会用到。

步骤 2:配置你的 MCP client

把 ASAPilot MCP server 加进你的 client 配置。不同 client 格式略有差异,下面是 Claude Desktop 或类似 MCP client 常见的配置方式。

{
  "mcpServers": {
    "asapilot": {
      "url": "https://api.asapilot.com/mcp/YOUR_WORKSPACE_ID",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

步骤 3:初始化并列出工具

配置完成后,MCP client 会自动调用 initialize 和 tools/list 来发现可用工具。你应该能看到 5 个工具:chat.send、accounts.list、automations.list、automations.create、automations.run。

步骤 4:发起第一次工具调用

先试着列出已连接账户:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounts.list",
    "arguments": {}
  }
}

或者直接发一条 chat 消息:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "chat.send",
    "arguments": {
      "message": "Show me my top spending campaigns this week",
      "thread_id": "my-first-thread"
    }
  }
}

下一步

常见问题

改客户端配置前要先准备什么?

先在 ASAPilot 里 provision MCP 通道,拿到 server URL 和 API key。

怎么判断 MCP 已经接通成功?

成功后客户端应该能看到五个工具,并建立可持续使用的 MCP 会话。

工具参数和示例去哪里看?

去 MCP 工具参考页查看工具名、参数、示例和协议行为。