Adbutler

AdButler MCP サーバー

Claude、ChatGPT、Cursor、Windsurf、Cline など、あらゆる AI アシスタントから AdButler アカウント全体を管理できます。Model Context Protocol クライアントならどれでも利用できます。

この MCP サーバーは、AdButler v2 API の全機能を公開します。広告主、キャンペーン、ゾーン、クリエイティブ、プレースメント、VAST 動画広告、プログラマティック／RTB、レポート、ターゲティング、下書き、契約、製品カタログなどを網羅する 600 以上のツールに加え、キャンペーンの開始やリテールメディアの設定といった一般的なタスクを AI に順を追って案内する、事前構築済みのワークフロープロンプトを 9 つ備えています。

依頼できること

「カナダのユーザーをターゲットにした、生涯予算 5,000 ドルの新しいキャンペーンを Pepsi 向けに作成し、Homepage Banner ゾーンに割り当ててください。」

「過去 7 日間で CTR が低迷している広告アイテムの上位 10 件を表示してください。」

「30 秒のスキップ可能なクリエイティブと 3 つのコンパニオンバナーを使用して、VAST 4.2 のプレロールキャンペーンを設定してください。」

「新しいプログラマティック取引の作成手順を教えてください。」

「広告ユニットを監査してください。有効なプレースメントがないゾーンはどれですか？」

AI がこれらの依頼を適切な順序の AdButler API 呼び出しに変換して実行し、結果を表示します。

インストール

方法は 2 つあります。ほとんどのユーザーにはホスト版がおすすめです。セットアップは不要で、URL を貼り付けるだけです。

オプション A — ホスト版（推奨）

AdButler のホスト型 MCP サーバーを使用します。インストールも Node も npm も不要です。

ホスト型サーバーは、最新の Streamable HTTP（/mcp）と従来の SSE（/sse）の両方のトランスポートに対応しています。新しいクライアントでは Streamable HTTP を推奨します。SSE は後方互換性のために引き続き利用できます。

クライアント	設定
Claude Desktop / Code	URL https://mcp.adbutler.com/mcp（古いクライアントでは /sse）とヘッダー Authorization: Bearer YOUR_ADBUTLER_API_KEY を指定して、MCP サーバーを追加します
Cursor	Settings → Features → Model Context Protocol → 上記の URL と認証ヘッダーを指定してサーバーを追加します
任意の MCP クライアント	Streamable HTTP：https://mcp.adbutler.com/mcp  ·  SSE：https://mcp.adbutler.com/sse — API キーは Authorization: Bearer … または ?api_key=… で渡します

オプション B — ローカル stdio（npm）

サーバーを Node プロセスとしてローカルで実行します。API キーを外部サービスに渡さずに済ませたい場合や、セルフホスト型 AdButler に接続する場合に便利です。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "adbutler": {
      "command": "npx",
      "args": ["-y", "@adbutler/mcp-server"],
      "env": {
        "ADBUTLER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add adbutler --env ADBUTLER_API_KEY=your_api_key_here -- npx -y @adbutler/mcp-server

Cursor / Windsurf / Cline

クライアントの MCP 設定に追加します。

{
  "mcpServers": {
    "adbutler": {
      "command": "npx",
      "args": ["-y", "@adbutler/mcp-server"],
      "env": { "ADBUTLER_API_KEY": "your_api_key_here" }
    }
  }
}

AdButler API キーを取得する

AdButler Dashboard → Settings → API Keys → 新しいキーを作成します。これは AdButler v2 REST API で使用するものと同じキーです。

認証

AdButler MCP は、新規のお客様にも既存のお客様にもご利用いただけます。表示される内容は、API キーをすでに設定しているかどうかによって異なります。

すでにAdButlerをご利用のお客様（既存のAPIキーがある場合）

次のいずれかを使用してください。

オプション1 — 接続設定でAPIキーを設定する（推奨：セッションをまたいで保持されます）

接続時にキーを渡すと、すべてのセッションで自動的に認証されます。チャットでキーを共有する必要はありません。

• Claude Code — claude mcp add adbutler --transport http https://mcp.adbutler.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
• Claude Desktop — claude_desktop_config.jsonを編集し、サーバーURLの横にheaders: { "Authorization": "Bearer YOUR_API_KEY" }を追加します
• Cursor — MCPサーバー設定 → Headers → Authorization: Bearer YOUR_API_KEYを追加します
• claude.aiのカスタムコネクター（カスタムヘッダー非対応）— URL形式を使用します：https://mcp.adbutler.com/mcp?api_key=YOUR_API_KEY
• 任意のクライアント — /mcp（Streamable HTTP）または/sse（従来のSSE）で、Authorization: Bearer …ヘッダーまたは?api_key=…クエリパラメーターを使用します

再接続すると、600以上のツールがすぐに利用可能になります。

オプション2 — チャット内で設定する（ホスト型では現在のセッションのみ）

認証なしでホスト型MCPに接続すると、4つのオンボーディングツールが表示されます。その後、チャットで次のように入力してください。

「AdButlerのAPIキーを設定してください：your_api_key_here」

AIがsetup_api_keyツールを呼び出し、アカウントに対してキーを検証して、すべてのAdButlerツールを利用可能にします。クライアントのツール一覧を更新するために、いったん切断して再接続する必要がある場合があります。

⚠️ ホスト型サーバーでは、この方法で設定したキーはセッション終了までのみ有効です。新しいチャットの開始、クライアントの再起動、サーバー側での再接続を行うと、再びキーを求められます。チャットにキーを何度も貼り付けることになり（会話で秘密情報を共有しないようAIから警告される場合もあります）、その場合はオプション1に切り替えてください。接続設定で一度キーを設定すれば、その設定が保持されます。

トラブルシューティング：「APIキーの設定が保持されない」

これは、ホスト型サーバーに対してチャット内でキーを入力している（オプション2）ことを意味します。ホスト型サーバーでは意図的にセッション内のみで有効となり、マルチテナント構成のため、キーがディスクに書き込まれることはありません。解決するには、クライアントの接続設定で一度だけ設定してください（上記のオプション1）。Claude Code／Claude Desktop／Cursorではヘッダーを、claude.aiのカスタムコネクターでは?api_key= URLパラメーターを使用します。その後は、再接続時や新しいチャットでも自動的に認証されます。

AdButlerを初めて利用する場合（アカウントをまだお持ちでない場合）

認証なしでホスト型MCPに接続してください。チャットの案内に従って、create_trial_accountを使った無料トライアルへの登録を行い、メールを確認して、コードを使ってverify_trial_emailを実行します。APIキーは自動的に設定されます。

ローカルのstdioインストール

npxを使ってローカルで実行する場合は、クライアントのMCP設定のenvブロックにADBUTLER_API_KEYを設定してください（上記のオプションBを参照）。セットアップツールも利用でき、ローカルではキーがセッション間で保持されます。

含まれる内容

9つのワークフロープロンプト

AIを最初から最後までの完全なワークフローに沿って案内する、事前構築済みのスキルプロンプトです。クライアントからMCPプロンプト（/launch-campaignなど）として呼び出します。

プロンプト	内容
launch-campaign	広告主 → キャンペーン → 広告アイテム → クリエイティブ → ターゲティング → プレースメントまで、キャンペーンの立ち上げを最初から最後まで案内します
retail-media-setup	ECサイト向けのスポンサープロダクト／リテールメディアを設定します
reporting	適切なディメンションとフィルターを使ってカスタムレポートを生成します
vast-video	リニアとコンパニオンのクリエイティブを含むVAST動画広告を作成します
programmatic	プログラマティック取引、ビッダー、デマンドソースを設定します
targeting	地域／プラットフォーム／データキー／リストのターゲットを作成します
contracts	IO契約を作成し、キャンペーンに割り当てます
channels	ゾーンをチャンネルにまとめ、キャンペーンを割り当てます
drafts	公開前にキャンペーン全体を下書きとして準備します

3 つのフォールバック用メタツール（検索、説明、呼び出し）

特定のツールでラップされていないエンドポイントが必要な場合や、ユーザーがリソースではなく「優先度」「フリークエンシーキャップ」などの フィールド について尋ねた場合は、次の 3 つの補完用ツールで対応できます。

ツール	機能
search_adbutler_api	AdButler の OpenAPI 仕様全体をキーワード検索し、一致するエンドポイントを探します
describe_adbutler_api	1 つのエンドポイントのスキーマ全体（パラメーター、本文、レスポンス）を取得します
call_adbutler_api	セッションの認証情報を自動適用して、メソッドとパスを指定し、任意のエンドポイントを呼び出します

これらは以下の専用ツールを補完するものであり、置き換えるものではありません。明らかに一致する専用ツールがある場合、LLM は引き続きそちらを優先します。

AdButler API 全体をカバーする 600 以上のツール

領域	ツール数	例
ディスプレイ広告	100+	list_advertisers、create_campaign、create_image_ad_item、create_native_ad_item、create_placement、create_schedule、create_campaign_assignment
VAST 2/3/4 動画	156	vast_create_creative、vast_create_linear_media、vast_create_companion、vast_create_placement、vast_create_schedule、および VAST 4.2 のサブリソース全体のサポート
ゾーンとパブリッシング	50+	create_zone、create_zone_catalog、create_zone_email、create_native_template、create_publisher、ORTB ネイティブアセット
ターゲティング	37	create_geo_target、create_platform_target、create_data_key、create_data_list、create_postal_code_target
レポート	39	get_display_report、get_vast_report、get_event_logs、カスタムレポート設定、スケジュール済みレポート
プログラマティック／RTB	25	create_demand_source、create_demand_endpoint、create_bidder、create_pmp_deal
商品カタログ	20	create_product_db_catalog、bulk_upload_products、広告アイテムとカタログアイテムのリンク
下書き	48	キャンペーン／広告アイテム／プレースメント／スケジュールを下書きとして作成し、アトミックに公開します
契約	43	広告掲載申込書、契約書類、署名リクエスト、支払い
アカウントとセキュリティ	27	ユーザー、ロール、リダイレクトドメイン、ビーコン署名キー、SFTP 接続
広告配信	2	serve_ad、live_website_preview

AdButler v2 OpenAPI 仕様 の 100% をカバーしています（604/604 エンドポイント）。

テレメトリー

mcp.adbutler.com のホステッドサーバーは、人気のあるツールの把握、改善の優先順位付け、失敗の診断に役立てるため、使用状況の分析データを収集します。ツール呼び出しごとに、次の情報を記録します。

• ツール名（例：list_zones、create_campaign）。ツールの引数は記録しません
• アカウント ID（/self からセッションごとに一度導出）
• API キーのフィンガープリント（SHA-256、16 桁の 16 進数に切り詰め） — キーそのものを保存せずに、どのキーが使用されたかを識別します
• トランスポート（HTTP または SSE）、MCP クライアント名とバージョン（例：Claude Desktop）、呼び出し時間、成功／エラーのステータス
• エラー時：上流の HTTP ステータスコード、エラーの分類クラス（例：forbidden、network）、エラーメッセージ本文（1000 文字に切り詰め）

収集することはありません：ツールの引数、レスポンス本文、生の API キー、IP アドレス、リクエスト本文。計測機能が参照するのは、ツール名、所要時間、および（失敗時の）MCP サーバーまたは AdButler API が生成したエラーメッセージのみです。

npm パッケージ、stdio、ご自身のデプロイなど、セルフインストールしたコピーはデータを一切収集しません。 計測機能が動作するのは ANALYTICS_INGEST_URL 環境変数が設定されている場合のみで、この変数が設定されているのは mcp.adbutler.com のホステッドエンドポイントだけです。

ホステッドサーバーでの分析データの収集をオプトアウトする場合は、stdio 経由でご自身のコピーを実行するか、SSE/HTTP サーバーをセルフホストしてください。

開発

コントリビューター向けのローカルソース：

git clone https://github.com/adbutler/mcp-server
cd mcp-server
npm install
npm run build
ADBUTLER_API_KEY=your_key node dist/index.js

公式 MCP インスペクターで確認します：

npx @modelcontextprotocol/inspector node dist/index.js

Resources

• AdButler API documentation — https://api.adbutler.com/openapi.json
• MCP Protocol — https://modelcontextprotocol.io
• Hosted server status — https://mcp.adbutler.com/health
• Issues / feature requests — https://github.com/adbutler/mcp-server/issues

License

MIT