Ads MCP

🚀 Ads MCP

キャンペーンの計画、調査、およびクロスプラットフォーム広告作成のためのリモートモデルコンテキストプロトコル（MCP）サーバー。起動時にはGoogle Ads Search、Performance Max、TikTokをサポートし、追加のネットワークも予定されています。

🚀 クイックスタート

クイックリンク

• MCPリモートURL (SSE): https://mcp.adspirer.com/
• フォールバックURL: https://adspirer-mcp-596892545013.us-central1.run.app/
• レジストリID: com.adspirer/ads
• 認証: Adspirerを介したOAuth 2.1（有料階層とレート制限はサーバー側で適用）
• ウェブサイト: https://www.adspirer.com/
• サポート: abhi@adspirer.com

機能説明

• 構造化されたプロンプトを使用してキャンペーンを計画および検証します。
• クリエイティブバリエーションを生成し、規制に準拠したアセットバンドルを組み立てます。
• MCP対応クライアント内からGoogle Ads Search、Performance Maxキャンペーン、およびTikTokキャンペーンをエンドツーエンドで作成します。
• 長時間実行される操作（5 - 30秒）のリアルタイム進捗更新を提供します。

ツール

アセット管理

• help_user_upload — 取り込みに適した直接のメディアリンクを提供するための明確な指示を返します。
• validate_and_prepare_assets — 提供されたURLからメディアをダウンロードして検証し、asset_bundle_idを返します。クライアントがサポートする場合、進捗をストリーミングします（通常、5 - 10枚の画像で5 - 15秒）。

キャンペーン作成

• create_pmax_campaign — アトミックなPMax作成（検証後にコミットするパターンを使用）。サポートされる場合、進捗をストリーミングします（通常、15 - 30秒）。
• create_search_campaign — オプションのアセットを持つテキスト優先のSearchキャンペーン作成。

接続方法

ChatGPT

1. 設定 → コネクタ → 作成を開きます。
2. 名前: Ads MCP
3. URL: https://mcp.adspirer.com/
4. OAuth 2.1のサインインに従います。アプリケーションとしてAdspirerが表示されます。
5. 初回使用時に広告アカウントをリンクします。
6. 自然に質問することでツールを使用します（例: "create a PMAX campaign for..."）。

Claude

1. 設定 → コネクタ → カスタムを追加を開きます。
2. 名前: Ads MCP
3. URL: https://mcp.adspirer.com/
4. OAuth 2.1のサインインを完了します。
5. 必要に応じてツールを呼び出します。

主な機能

進捗ストリーミング (MCP 2025-03-26)

• クライアントとのプロトコルバージョン交渉
• notifications/progressを介したリアルタイム進捗更新
• 確定的な進捗フィールド: 段階、現在値、合計、メッセージ
• _meta.progressTokenを要求するクライアントで動作します。

セキュリティ

• HTTPS URLのみを許可し、リダイレクト制限を適用
• プライベートおよびルーティング不可能な宛先をブロック
• MIMEスニッフィングとコンテンツタイプチェックを適用
• リクエストごとにOAuth 2.1アクセストークンを検証
• 操作ごとに最小限の権限スコープを適用

ツールの安全性注釈

• すべてのツールにMCPの安全性メタデータ（_readOnlyHint、_destructiveHint、_title）が含まれています。
• 読み取り専用ツールは明確にマークされています（パフォーマンス分析、キーワード調査）。
• キャンペーン作成ツールは非破壊的としてマークされています（新規作成、既存の削除は行わない）。
• AIアシスタントがツールの安全性特性を理解するのに役立ちます。

制限と信頼性

• サーバー側のレート制限は有料階層によって異なります。
• 操作ごとに時間とサイズの制限を適用します。
• 画像ダウンロードのリトライロジック（404エラー時に2回試行）
• CDN互換性のためのUser-Agentヘッダー
• 価格と利用規約についてはhttps://www.adspirer.com/ を参照してください。

詳細ドキュメント

• クイックスタートガイド
• ChatGPTコネクタの設定
• Claudeコネクタの設定
• トラブルシューティング
• 変更履歴
• プライバシーポリシー
• 利用規約

技術詳細

• プロトコル: MCP 2025-03-26（フォールバックで2024-11-05）
• トランスポート: 進捗ストリーミング付きのHTTP+SSE
• OAuth: RFC 8252（認可コード + PKCE）とRFC 9728（保護されたリソースメタデータ）
• 進捗: 進捗トークンがなくても疎なステータスメッセージを提供
• 監視: トークン使用量と期間のメトリックを含む包括的なロギング

💻 使用例

基本的な使用法

curl -i -N https://mcp.adspirer.com/mcp/tools/call \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"validate_and_prepare_assets",
      "_meta":{"progressToken":"tok-123"},
      "arguments":{
        "marketing_images_square":["https://example.com/image.jpg"]
      }
    }
  }'

同じストリーム上でいくつかのevent: message進捗フレームが続き、最後にJSON-RPC結果が表示されるはずです。

サポート

• メール: abhi@adspirer.com
• ウェブサイト: https://www.adspirer.com/
• 問題報告: https://github.com/adspirer/ads-mcp/issues

セキュリティ

脆弱性報告とセキュリティポリシーについてはSECURITY.mdを参照してください。

📄 ライセンス

独自のライセンス - 使用条件については利用規約を参照してください。