MCP ツールリファレンス
Apple Search Ads 管理向け ASAPilot MCP server が現在提供する 5 つのツールの完全リファレンスです。
開発者向け
ダッシュボードだけを使う場合は通常これらのツールを意識する必要はありません。MCP 対応クライアントや AI coding tools 向けの情報です。
ASAPilot は MCP server を通じて 5 つのツールを公開しています。広告データの読み取り、自動化の起動、自然言語ワークフローの統合に使えます。
Chat ツール
chat.send
ASAPilot にメッセージを送り、既存の外部会話を続けます。
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| message | string | 必須 | ASAPilot へ送るユーザーメッセージ。 |
| thread_id | string | 任意 | 安定した外部会話 ID。追加入力でも同じ ID を使います。 |
| mode | string | 任意 | free_talk や account_health などの任意モード上書き。 |
| connection_id | string | 任意 | 接続済み ASA アカウント ID。 |
| time_range | string | 任意 | 任意のレポート期間。 |
例
{
"name": "chat.send",
"arguments": {
"message": "Show me campaigns with CPI above $5",
"thread_id": "analysis-session-1",
"mode": "account_health",
"time_range": "last_7_days"
}
}アカウントツール
accounts.list
この ASAPilot ワークスペースで利用可能な Apple Search Ads 接続一覧を返します。
例
{
"name": "accounts.list",
"arguments": {}
}自動化ツール
automations.list
現在設定されている自動化一覧を返します。
例
{
"name": "automations.list",
"arguments": {}
}自動化ツール
automations.create
新しい ASAPilot 自動化を作成します。
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| name | string | 必須 | 自動化名。 |
| type | string | 必須 | daily_account_health や daily_budget_guard などの自動化タイプ。 |
| connectionId | string | 必須 | 接続済み ASA アカウント ID。 |
| agentName | string | 任意 | 任意のエージェント名上書き。 |
| configJson | string | 任意 | 任意の JSON 設定文字列。 |
| scheduleType | string | 任意 | スケジュール種別: hourly、daily、weekly。 |
| cronExpr | string | 任意 | スケジュール値。例: daily は 09:00、hourly は 6h、weekly は MON@09:00。 |
| timezone | string | 任意 | UTC や America/Los_Angeles などの IANA タイムゾーン。 |
例
{
"name": "automations.create",
"arguments": {
"name": "Daily Budget Alert",
"type": "daily_budget_guard",
"connectionId": "conn_abc123",
"scheduleType": "daily",
"cronExpr": "09:00",
"timezone": "America/Los_Angeles"
}
}自動化ツール
automations.run
自動化実行を即時キューに投入します。
パラメータ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| automationId | string | 必須 | 実行する自動化 ID。 |
例
{
"name": "automations.run",
"arguments": {
"automationId": "auto_xyz789"
}
}プロトコル詳細
認証
すべてのリクエストに API key が必要です。Authorization: Bearer YOUR_API_KEY または X-API-Key で渡します。
セッション管理
初期化後、server は Mcp-Session-Id ヘッダーを返します。後続リクエストでも同じ header を送ると session continuity を保てます。
スレッド継続性
chat.send では同じ thread_id を複数回使うことで、外部スレッドと ASAPilot 内部会話の紐付けを維持します。
よくある質問
ASAPilot は現在いくつの MCP ツールを公開していますか？
現在の MCP サーバーは chat、accounts、automations にまたがる 5 つのツールを公開しています。
MCP セッション継続性はどう保ちますか？
返された Mcp-Session-Id ヘッダーを後続リクエストでも再利用します。
外部会話を 1 つの ASAPilot スレッドに結びつけるには？
chat.send で同じ thread_id を継続して使います。