Camberstack: Google Ads

Camberstack：Google Ads MCP サーバー

Google Ads（および任意で Search Console）をClaude、ChatGPT、Cursor、または任意のMCPクライアントに接続できます。AIは読み取り専用ツールでアカウントを確認し、除外キーワードからキャンペーン全体まで、変更を提案できます。具体的な提案を承認するまで、アカウントに変更が加えられることはなく、適用した変更はすべて取り消せます。

ホスト型：**https://camberstack.io/mcp**（無料：Google Adsアカウント1つ、すべてのツール、変更回数無制限。Pro 月額$15：最大10アカウント）。

スクリーンショットとトラブルシューティング付きのセットアップガイド： ClaudeにGoogle Adsを接続 · ChatGPTにGoogle Adsを接続 · すべてのツール · Cursor、VS Codeなど

ツール

ツール	書き込みを行うか	機能
list_accounts	いいえ	ログインでアクセスできるすべてのアカウント。マネージャー（MCC）配下のクライアントアカウントも含みます
account_overview	いいえ	キャンペーンごとの費用、コンバージョン数、コンバージョン単価
keyword_ideas	いいえ	シードキーワードや URL からキーワード プランナーの候補を取得します。月間検索数、競合状況、ページ上部の入札単価の範囲を表示し、アカウントがすでにターゲットにしている候補や除外している候補を示します
keyword_metrics	いいえ	指定したキーワード一覧のキーワード プランナーの数値と、過去 12 か月分の検索数
run_gaql	いいえ	任意の読み取り専用 GAQL SELECT
search_console_sites	いいえ	ログインで読み取り可能なウェブサイト（Search Console プロパティ）
search_console_summary	いいえ	指定期間とその直前の期間を比較した、サイト全体のクリック数、表示回数、CTR、掲載順位
search_console_performance	いいえ	クエリ、ページ、国、デバイス、日付別のオーガニッククリック数、表示回数、CTR、掲載順位。テキストまたは RE2 正規表現によるフィルターに対応
search_console_trend	いいえ	指定期間とその直前の期間を比較し、クエリ別、ページ別に、上昇、下降、新規、消失、および掲載順位が下がっている上昇中の検索を表示します
search_console_opportunities	いいえ	予測クリック増加数付きの掲載順位 4～20 位のクエリ、CTR の低いトップ 5 クエリ、質問形式のクエリ
search_console_inspect_urls	いいえ	最大 20 ページの URL 検査。インデックス登録の有無と未登録の理由、最終クロール日時、選択された正規 URL と申告された正規 URL の比較、構造化データのエラーを表示します
search_console_sitemaps	いいえ	送信済みのサイトマップ。最終ダウンロード日時、URL 数、エラー、警告を表示します

Search Console ツールでは、days または正確な start_date／end_date を指定できます。また、fresh: true を指定すると、Google がまだデータを反映中の直近 2～3 日分も含められます。インデックス登録のリクエストとサイトマップの送信は利用できません。Camberstack が保持する権限は読み取り専用のスコープのみです。 | paid_organic_overlap | いいえ | Ads アカウントの検索語句とサイトのオーガニック検索クエリを照合します。すでに上位にランクインしている有料検索と、広告が表示されていない 2 ページ目以降の検索を特定します | | propose_changes | いいえ | 変更をライブアカウントに照らして解決し、Google でドライラン（validateOnly）を実行して、平易な英語の概要付きで提案を保存します | | apply_changes | はい | 保存済みの提案（ユーザー本人が作成し、未適用で、作成から 24 時間以内のもの）を適用し、各変更の逆操作を記録します | | undo_changes | いいえ | 適用済みの提案を取り消すための提案を作成します | | billing | いいえ | プラン、利用中の Google Ads アカウント数（直近 30 日間）とプランの上限、および個人向けのアップグレードまたは請求管理リンク | | discard_proposal、change_history、disconnect | | |

提案で実行できる操作：

• 管理： 除外キーワードの追加、キャンペーン、広告グループ、キーワード、広告の一時停止または有効化、キャンペーンの日予算（共有予算は不可）または終了日の設定。
• 作成： 検索キャンペーン全体（広告グループ、キーワード、レスポンシブ検索広告、ターゲティング、除外キーワード、サイトリンク）の作成。常に一時停止状態で作成されます。既存キャンペーンへの広告グループ、キーワード、広告、サイトリンクの追加。
• 調整： キーワードと広告グループの入札単価、入札戦略、地域と言語のターゲティング、所在地のみを対象とするモード、最終ページ URL のサフィックス。
• 計測： コンバージョン アクションの作成、カウント方法の設定、キャンペーンのコンバージョン目標を 1 つに設定。

リスクの高い変更には、提案概要に ⚠ の行が表示されます。キャンペーンの有効化、予算または入札単価の 2 倍を超える増額、入札戦略の切り替え、最後の地域の削除、新しいメインのコンバージョン アクションが該当します。取り消しで削除されるのは、Camberstack 自身が作成したものだけです。ユーザーが作成したものが削除されることはありません。Search Console は読み取り専用です。

認証の仕組み

Camberstack は、MCP クライアント向けの OAuth 2.1 認可サーバーです（動的クライアント登録、PKCE）。/authorize ではユーザーを Google に誘導し、adwords と openid email に加えて、ユーザーがチェックを外せる Search Console 用の webmasters.readonly を要求します。必須なのは adwords のみです。Google のリフレッシュトークンは AES-256-GCM で暗号化して保存され、サーバーの外に出ることはありません。MCP クライアントには Camberstack 独自のトークンが発行され、保存されるのは SHA-256 ハッシュのみです。

意図的に 2 種類の MCP SDK を使用しています。/mcp は SDK v2（@modelcontextprotocol/server と /node）で提供され、2026-07-28 のクライアント（server/discover）と、JSON レスポンストランスポートを維持している 2025 年ごろのクライアント（initialize）の両方に応答します。認可サーバー（mcpAuthRouter、requireBearerAuth）は、v2 がリソースサーバー側のみを提供しているため、@modelcontextprotocol/sdk 1.x のままです。v2（または関連パッケージ）で /authorize、/token、/register が提供されるまでは、1.x を削除しないでください。

実行方法

npm ci && npm test
ENCRYPTION_KEY=$(openssl rand -hex 32) \
GOOGLE_CLIENT_ID=… GOOGLE_CLIENT_SECRET=… GOOGLE_ADS_DEVELOPER_TOKEN=… \
BASE_URL=https://your.host npm run dev

env
ENCRYPTION_KEY	32 バイトの 16 進数または Base64。紛失した場合、ユーザーは再接続が必要になるだけです。漏洩すると、保存されている Google トークンが露出します
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET	Google Ads API へのアクセス権を持つ専用の Google Cloud プロジェクトの OAuth クライアント。リダイレクト URI：<BASE_URL>/oauth/google/callback。未設定の場合はページのみが表示され、サインイン時に「まだ利用できません」と表示されます
GOOGLE_ADS_DEVELOPER_TOKEN	設定されている場合に送信されます
BASE_URL	公開オリジンであり、OAuth 発行者です（デフォルト：https://camberstack.io）
DATA_DIR	SQLite の保存場所（デフォルト：./data）
FREE_ACCOUNTS / PRO_ACCOUNTS / PRO_EMAILS	各プランで利用できる Google Ads アカウント数。直近 30 日間に使用された別個のアカウントとして数え、管理者アカウントとデモアカウントは除外します（デフォルトは 1 / 10）。Pro として扱うメールアドレス
STRIPE_SECRET_KEY / STRIPE_PRO_PRICE_ID	Stripe Checkout による Pro サブスクリプション。未設定の場合、アップグレードリンクは表示されません

scripts/try-account.ts は、既存のリフレッシュトークンを使って実際のアカウントに対して読み取りツールを実行し、OAuth をスキップします。実際に試す際に使用してください。

ライセンス

MIT