Snapchat Ads MCP Server

Cesteral MCP サーバー

主要な広告プラットフォーム向けのセルフホスト可能な MCP コネクターです。

プラットフォームとの連携を透明性の高い方法で実現し、ローカルでの実験を行い、管理できるインフラストラクチャを使いたい場合は、このリポジトリをご利用ください。支出の確定前の承認、認証情報の仲介、監査可能性、統制された環境からのクロスプラットフォーム実行がチームに必要な場合は、Cesteral Intelligence をご利用ください。

Meta Ads MCP をローカルで試す（約10分） | OSS と Cesteral Intelligence を比較する | ワークフローのデモを予約する

                                

---

2つの利用方法

このリポジトリはオープンなコネクターレイヤーであり、製品全体ではありません。

• 認証情報、インフラストラクチャ、プラットフォームへのアクセスを透明性の高い方法で直接管理するには、コネクターをセルフホストしてください。
• ワークフローで統制された書き込み、チームの承認、認証情報の仲介、監査可能性、クロスプラットフォームの連携が必要な場合は、Cesteral Intelligence を利用してください。詳しくは、以下の必要となる場合をご覧ください。

---

主力コネクター

Google Ads MCP

Google Ads REST API v25 を介したキャンペーンの書き込み、GAQL レポート、入札単価の調整、プレビュー、検証に対応します。

パッケージのドキュメント | Cesteral Intelligence と連携する

Meta Ads MCP

Meta Marketing API v26.0 を介したキャンペーンの書き込み、インサイト、ターゲティングの検出、配信予測、プレビュー、一括操作に対応します。

パッケージのドキュメント | Cesteral Intelligence と連携する

DV360 MCP

DV360 API v4 を介したキャンペーンの書き込み、ターゲティング、カスタム入札、プレビュー、アップロード、スキーマ駆動の検証に対応します。

パッケージのドキュメント | Cesteral Intelligence と連携する

---

Cesteral Intelligence が必要な場合

OSS コネクターでは、サーバーごとのツール実行と監査ログを利用できます。Cesteral Intelligence は、その上にガバナンスとオーケストレーションを追加します。

• 認証情報の仲介 -- プラットフォームのシークレットをローカルのオペレーターワークフローから分離します
• 承認ワークフロー -- 破壊的な変更や高額な変更を行う前に、人によるレビューを必須にします
• 監査の集約 -- オペレーターの ID にひも付けられた、出所情報付きのサーバー横断アクティビティフィードを統合します
• クロスプラットフォームのオーケストレーション -- 複数のコネクターにまたがる、ガバナンスの効いた実行を調整します
• チーム運用 -- 共有ワークフロー、テナント分離、オペレーターの可視性を提供します

OSS コネクターと Cesteral Intelligence を比較

---

全サーバー一覧

サーバー	プラットフォーム	ツール数	認証
gads-mcp	Google Ads REST API v25	18	OAuth2 refresh token
meta-mcp	Meta Marketing API v26.0	27	Bearer token
dv360-mcp	DV360 API v4	26	Google OAuth2 / service account
ttd-mcp	The Trade Desk REST + GraphQL API	46	User token (TTD-Auth header)
linkedin-mcp	LinkedIn Marketing API (202608)	23	Bearer token
tiktok-mcp	TikTok Marketing API v1.3	25	Bearer token + advertiser ID
cm360-mcp	CM360 API v5	22	Google OAuth2
sa360-mcp	SA360 Reporting API v0 + DS v2	17	OAuth2 refresh token
pinterest-mcp	Pinterest Ads API v5	24	Bearer token
snapchat-mcp	Snapchat Ads API v1	25	Bearer token
amazon-dsp-mcp	Amazon Ads Unified API (DSP)	28	Bearer token
msads-mcp	Microsoft Advertising API v13	28	Access token + developer token
dbm-mcp	Bid Manager API v2	6	Google OAuth2

13 個のサーバーで、290 以上のツールを利用できます。ツール数は各サーバーに登録されている現在の合計で、該当する場合は *_search_tools 検出ツールも含みます。

すべてのサーバーに搭載されている機能

すべてのサーバーは、@modelcontextprotocol/sdk 1.31.0 が実装している 2025-03-26、2025-06-18、2025-11-25 の MCP プロトコルリビジョンに対応しています。Streamable HTTP トランスポートは、これ以外の MCP-Protocol-Version を拒否します。現在のリビジョンである 2026-07-28 には、まだ対応していません （#242）。

仕様のすべてに対応しているわけではありません。MCP 適合性テストスイート （@modelcontextprotocol/conformance 0.1.16）では、すべてのサーバーが有効なサーバーシナリオ30項目のうち18項目に合格します。対象は、初期化、ping、ログレベルとログ通知、ツール一覧と呼び出し、エリシテーション（フォーム、デフォルト値、列挙型）、リソース一覧、読み取り、テンプレート、プロンプト一覧と取得、並行するSSEストリーム、DNSリバインディング保護です。残りの12項目については、それぞれの理由が conformance/expected-failures.yaml に記載されています。未実装の機能は、補完、リソースサブスクリプション、サンプリング、進捗通知、画像／音声／埋め込みリソースのコンテンツ、SSEストリームの再開です。エリシテーションリクエスト（以下の破壊的操作の確認を含む）とログ通知は、呼び出し元の tools/call リクエストのレスポンスストリームで送信されるため、クライアントはこれらを受信するためにオプションのGETストリームを必要としません。ループバックアドレスにバインドされたサーバー（NODE_ENV=production 以外でのデフォルト）は、/mcp へのループバック Host ヘッダーと Origin ヘッダーのみを受け入れます。それ以外のアドレスにあるサーバーは、MCP_ALLOWED_HOSTS が設定されている場合に限り Host を確認します。

生のツール呼び出しに加えて、すべてのサーバーには以下が搭載されています。

• MCP プロンプト — キャンペーンの開始、レポート作成、トラブルシューティングなどのオンデマンドな複数ステップのワークフローガイダンスです。エージェントが各プラットフォームで必要な手順をいちいち調べ直す必要がなくなります。13台すべてのサーバーに搭載されています。
• MCP リソース — スキーマ、フィールドカタログ、サンプル、列挙型などの構造化されたアドレス指定可能なコンテキストを、すべてのツールスキーマに含めて肥大化させるのではなく、必要に応じて取得できます。13台すべてのサーバーに搭載されています。DV360ではこれを使い、1 MBを超える判別可能な共用体を通信経路に載せないようにしています（entity-schema://、entity-fields://、entity-examples://）。
• ツールの検出 — エージェントが一覧全体を順に見る代わりに、意図に基づいてサーバー独自のカタログを検索できる <platform>_search_tools ツールです。13台中10台のサーバーに搭載されています（小規模な gads-mcp と sa360-mcp、レポート専用の dbm-mcp を除く）。
• サーバー検出カード — すべてのサーバーで、すべての認証モードにおいて /.well-known/mcp/server-card.json にあるSEP-2127メタデータ（名前、バージョン、トランスポート、認証モード、機能）を提供します。
• OAuthリソース検出 — jwt 認証モードでは、RFC 9728 エンドポイント /.well-known/oauth-protected-resource を利用できます。
• レポートのCSVスピル — レスポンスのサイズに上限を設けるため、大きなレポート本文は署名付きURLを通じてGCSに保存されます。レポート処理の多い6台のサーバーで利用できます。ttd-mcp、tiktok-mcp、snapchat-mcp、amazon-dsp-mcp、pinterest-mcp、msads-mcp が対象です。

サーバー	検出	プロンプト	リソース	CSVスピル
gads-mcp		✅	✅
meta-mcp	✅	✅	✅
dv360-mcp	✅	✅	✅
ttd-mcp	✅	✅	✅	✅
linkedin-mcp	✅	✅	✅
tiktok-mcp	✅	✅	✅	✅
cm360-mcp	✅	✅	✅
sa360-mcp		✅	✅
pinterest-mcp	✅	✅	✅	✅
snapchat-mcp	✅	✅	✅	✅
amazon-dsp-mcp	✅	✅	✅	✅
msads-mcp	✅	✅	✅	✅
dbm-mcp		✅	✅

---

本番環境向け

広告費が実際に使われる AI エージェントをセルフホストする場合、まず問われるのは信頼性であり、機能はその次です。次の 2 つにより、ガードレールを一から実装することなく、このサーバー群を本番環境で運用できます。

• 監査に耐える可観測性。すべてのツール呼び出しを追記専用の JSONL として記録します。失敗時には、上流 HTTP 通信の全履歴（すべてのリクエスト、再試行、レスポンス）も追加で記録し、シークレットは発生元でマスキングします。ホスト型のデプロイでは BigQuery で直接クエリでき、セルフホストでは標準出力を既存のログスタックに送ることができます。 可観測性ガイドを読む。
• 破壊的操作に対する確認ゲート。書き込みに対応する 12 個のサーバー（dbm-mcp はレポート専用）に含まれる 51 個の破壊的なツールでは、削除、一括ステータス変更、入札額の調整、予算の変更、コンバージョンのアップロード、非同期 Workflows バッチジョブの実行前にユーザーへ確認を求めます。標準入出力や確認機能に対応していないクライアントでは、文書化された非対話型の契約にフォールバックします。10 件未満の一括変更では、機微なフィールド（ステータス／予算／入札額）に変更が加わる場合を除き、確認を省略します。
• 検証可能なリリースの来歴。ガバナンス対象のツールには、正規の SHA-256 definitionHash（@cesteral/contract-hash による）が付与され、パッケージごとの cesteral-manifest.json に出力されます。タグ付きリリースはビルド来歴情報とともに npm に公開され、tarball 内のマニフェストも推移的に署名されるため、下流のガバナンスシステムは、公開されたツール定義を正確に検証し、一致するツールを attested の信頼レベルに引き上げることができます。

セキュリティレビューで証拠が必要な場合は、マスキング対象の一覧、フィールドスキーマ、上流データの取得経路、コントラクトハッシュのすべてがこのリポジトリにあります。

---

クイックスタート

手順に沿った説明については、10 分で始めるクイックスタートをご覧ください。

前提条件

• Node.js >= 20.0.0
• pnpm >= 10.0.0 -- corepack enable を実行すると、packageManager で固定されたバージョンが使用されます（または npm install -g pnpm@10）
• Docker（コンテナ化に使用）
• Terraform >= 1.6.0 (デプロイに使用)

1. クローンしてインストール

git clone https://github.com/cesteral/mcp-open-advertising.git
cd mcp-open-advertising
pnpm install

2. ビルド

pnpm run build

3. サーバーをローカルで実行

# Start any server using the dev script
./scripts/dev-server.sh gads-mcp    # port 3004
./scripts/dev-server.sh meta-mcp    # port 3005
./scripts/dev-server.sh dv360-mcp   # port 3002

# See each package README for required environment variables

4. AI エージェントを設定

{
  "mcpServers": {
    "cesteral-gads": {
      "url": "https://gads.your-domain.com/mcp",
      "apiKey": "your-gads-api-key"
    },
    "cesteral-meta": {
      "url": "https://meta.your-domain.com/mcp",
      "apiKey": "your-meta-api-key"
    }
  }
}

必要な数だけサーバーを追加できます。それぞれ独立して実行され、個別にデプロイできます。

5. デプロイ

cd terraform
terraform init
terraform apply -var-file=dev.tfvars

本番環境のセットアップについては、デプロイガイドをご覧ください。

---

アーキテクチャ

Cesteral は、個別にデプロイできる 13 個の Cloud Run MCP サービスを備えた GCP ネイティブのアーキテクチャを採用しています。各サーバーは Cloud Run 上で HTTPS を介して MCP プロトコルを直接公開します。

主な設計上の判断：

• 単一のクラウドプロバイダー（GCP）：Cloud Run、BigQuery、Pub/Sub、Secret Manager を統合して監視でき、月額約 150～220 ドルです
• HTTP 直接トランスポート：エッジゲートウェイ層は不要です
• 個別デプロイ：各サーバーを個別にデプロイし、スケーリングできます
• 組み合わせ可能：1 つのサーバーでも 13 個すべてでも使用でき、それぞれ単独でも連携しても動作します

AI クライアントは HTTPS を介して 1 つ以上の MCP サーバーに直接接続するため、プロビジョニングが必要な共有ゲートウェイはありません。Cesteral Intelligence を使用する場合は、同じサーバー群の上にテナント管理、認証情報、承認、ガバナンスを重ねて提供します。

リポジトリの構成

mcp-open-advertising/
├── packages/
│   ├── gads-mcp/          # Google Ads
│   ├── meta-mcp/          # Meta Ads
│   ├── dv360-mcp/         # DV360
│   ├── ttd-mcp/           # The Trade Desk
│   ├── linkedin-mcp/      # LinkedIn Ads
│   ├── tiktok-mcp/        # TikTok Ads
│   ├── cm360-mcp/         # Campaign Manager 360
│   ├── sa360-mcp/         # Search Ads 360
│   ├── pinterest-mcp/     # Pinterest Ads
│   ├── snapchat-mcp/      # Snapchat Ads
│   ├── amazon-dsp-mcp/    # Amazon DSP
│   ├── msads-mcp/         # Microsoft Ads
│   ├── dbm-mcp/           # Bid Manager (reporting)
│   ├── contract-schema/   # Shared library -- canonical annotation + response schemas
│   ├── contract-hash/     # Shared library -- canonical tool-definition hash
│   └── shared/            # Shared auth, telemetry, utilities
├── terraform/             # Infrastructure as Code
├── scripts/               # Deployment and dev automation
└── docs/                  # Documentation and guides

---

開発

# Install dependencies
pnpm install

# Build all packages
pnpm run build

# Run tests
pnpm run test

# Type checking
pnpm run typecheck

# Lint
pnpm run lint

MCP ツールのテスト

# Use MCP Inspector
npx @modelcontextprotocol/inspector packages/gads-mcp

# Or use curl
curl -X POST http://localhost:3004/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

技術スタック

• ランタイム：TypeScript 5.0 以降、Node.js 22 LTS、Hono（HTTP および MCP トランスポート）
• バリデーション：Zod スキーマ
• インフラストラクチャ：GCP Cloud Run、BigQuery、Pub/Sub、Secret Manager、Terraform
• ビルド：Turborepo、pnpm ワークスペース、Docker

---

コントリビューション

コントリビューションを歓迎します。ガイドラインについてはCONTRIBUTING.mdをご覧ください。

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/your-feature
3. 変更を加え、テストを作成します
4. テストを実行します：pnpm run test
5. プルリクエストを送信します

こちらもご覧ください：CODE_OF_CONDUCT.md | SECURITY.md | ROADMAP.md

---

ライセンス

Apache License 2.0

---

サポート

• ウェブサイト: cesteral.com -- マネージドホスティングと商用機能
• ドキュメント: ガイドとアーキテクチャについては docs/ をご覧ください
• GitHub の Issue: バグの報告や機能のリクエスト
• メール: [email protected]