MCP 連携ガイド
Model Context Protocol を使えば、Claude、Cursor、または独自の AI エージェントから、DEXUN AdWhiz のデータ（3 プラットフォームの連携済み広告アカウント、AI の提案、最近のアクティビティ）を参照できます。読み取り専用です。
MCP とは？
MCP（Model Context Protocol）は、Anthropic が 2024 年に発表したオープン標準で、AI アプリケーションが外部のデータやツールに安全にアクセスする方法を定めています。「AI 時代の USB-C」と考えるとわかりやすいでしょう —— 1 つの共通インターフェースで、あらゆる MCP クライアント（Claude Desktop、Cursor、独自エージェント）が、あらゆる MCP サーバー（DEXUN AdWhiz、Notion、GitHub など）を呼び出せます。
DEXUN AdWhiz の MCP サーバーは、読み取り専用のツールを 5 つ公開しています：連携済みの広告アカウント、AI の未対応の提案、節約額の概要、アカウントの最近のアクティビティ、API の利用枠です。広告アカウント内のものを変更・一時停止・作成することはできません。すべての呼び出しは API キーで認証され、REST API と同じプラン別のレート制限が適用されます。
クイックスタート
3 ステップ、約 5 分で、AI アシスタントに広告アカウントについて質問できるようになります。
Claude Desktop で設定する
claude_desktop_config.json（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）を編集し、以下を追加します：
# Claude Desktop config: ~/.../claude_desktop_config.json
{
"mcpServers": {
"dexun-adwhiz": {
"command": "npx",
"args": ["-y", "@dexun/adwhiz-mcp@latest"],
"env": {
"ADWHIZ_API_KEY": "dxk_live_..."
}
}
}
}Cursor で設定する
プロジェクト単位の .cursor/mcp.json、またはグローバル設定で：
# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
"mcpServers": {
"dexun-adwhiz": {
"command": "npx",
"args": ["-y", "@dexun/adwhiz-mcp@latest"],
"env": { "ADWHIZ_API_KEY": "dxk_live_..." }
}
}
}接続を確認する
Claude または Cursor を再起動し、次のプロンプトを試してください。AI が list_ad_accounts や list_recommendations を呼び出して実際のデータを返せば、連携は完了です。
Claude に聞く：
「連携している広告アカウントを一覧にして、AI の未対応の提案を要約してください。どのキャンペーンの変更を勧めていて、その理由は何ですか？」
ツール一覧
MCP サーバーが公開するツールは 5 つで、すべて読み取り専用です。各ツールには完全な JSON Schema があるため、どのツールをいつ呼び出すかは AI が自動で判断します。
list_ad_accounts
読み取り専用連携済みの Google Ads・Meta Ads・TikTok Ads アカウントと接続状態。
list_recommendations
読み取り専用AI の未対応の最適化提案（予算の増額・減額・一時停止）。理由、想定される効果、信頼度つき。
get_savings_summary
読み取り専用節約額の概要：ダッシュボード上の節約額の表示への案内と、ご利用中のプラン。
get_recent_activity
読み取り専用アカウントの最近のアクティビティ：ログイン、API キーの変更、広告アカウントの連携、サブスクリプションの変更。
get_quota
読み取り専用現在の API レート制限：1 分あたりのリクエスト数、残り回数、リセット時刻。
AI クライアントからは、MCP 標準の tools/list リクエストで同じツールとパラメーターを確認できます。
セッション例
読み取り専用アクセスのイメージを示す会話例です（データはサンプルです）：
AdWhiz に連携している広告アカウントはどれですか？
連携済みのアカウントは 3 つです。Google Ads、Meta Ads、TikTok Ads が 1 つずつで、いずれも接続済みです。
今、AI はどんな提案をしていますか？
未対応の提案が 2 件あります。① Meta キャンペーン「Lookalike 1%」の 1 日の予算を減額 —— 過去 1 週間、ROAS がアカウント平均を下回っています。② TikTok Spark Ads キャンペーンの予算を増額。いずれも理由と信頼度が付いています。適用する場合は広告プラットフォーム上で操作してください —— ここからは何も変更できません。
最近、アカウントに何か変化はありましたか？
過去 7 日間：ログイン 2 回、API キーの新規発行 1 件、TikTok Ads アカウントの再連携がありました。それ以外の記録はありません。
セキュリティと権限
- 5 つのツールはすべて読み取り専用です。AI はデータを参照できますが、予算の変更、広告の一時停止、キャンペーンの作成はできません
- MCP サーバーはローカルで動作します。dxk_ API キーが第三者に送信されることはありません
- 呼び出しは API キーで認証され、ご利用プランの REST API と同じレート制限が適用されます（get_quota で確認できます）
- キャンペーンの変更はお客さまご自身で行います。MCP 経由では行えません
- MCP のアクセス権は、ダッシュボードの「設定 → API Keys」でいつでも取り消せます