MCP クイックスタート

Model Context Protocol を使って、5 分以内に IDE、agent framework、または独自 runtime を ASAPilot へ接続します。

MCP とは？

Model Context Protocol は AI アシスタントが外部ツールやデータソースへアクセスするためのオープン標準です。ASAPilot は chat、アカウント参照、自動化管理を MCP server として公開し、互換環境から Apple Search Ads ワークフローを利用できるようにします。

ステップ 1: MCP channel を provision する

1. app.asapilot.com にログインして Channels へ移動します。
2. MCP カードで Provision をクリックします。
3. 生成された MCP server URL と API key を控えます。次の手順で使います。

ステップ 2: MCP client を設定する

ASAPilot MCP server を client 設定へ追加します。形式はクライアントごとに異なりますが、Claude Desktop などでは以下のような設定が一般的です。

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

ステップ 3: 初期化して tools を確認する

設定後、MCP client は自動的に initialize と tools/list を呼び出します。利用可能な 5 つのツールとして chat.send、accounts.list、automations.list、automations.create、automations.run が見えるはずです。

ステップ 4: 最初の tool call を試す

まず接続済みアカウント一覧を取得してみます。

{
  "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"
    }
  }
}

次に読むもの