chiranj

@vibeads/mcp

ChatGPT、Claude、Claude Code、Cursor、または任意の MCP クライアントから、Google Ads アカウントに質問できます。

地域密着型サービス事業者向けに構築されています。35 のカテゴリに対応し、そのうち 32 カテゴリには調整済みのキーワード、CPC ベンチマーク、ファネルテンプレートが用意されています。

VibeAds の公式 Model Context Protocol サーバーです。「予算を無駄にしている検索語句はどれですか？」や「アカウントの健全性スコアはいくつですか？」などの質問をアシスタントに尋ねると、実際のキャンペーンデータに基づく回答が得られます。

一般的な Google Ads MCP サーバーとは異なり、地域密着型サービス事業者向けに事前調整されており、35 件以上の診断ルールを、6 つのディメンションにわたる 0〜100 の単一のアカウント健全性スコアに集約します。Pro／Max プランでは、キャンペーン戦略の作成、ガード機能付きの最適化の適用、キーワード・入札単価・予算の編集、広告グループの追加、公開もできます。費用が発生する操作は、すべてユーザーが確認してから実行されます。

接続方法は 2 通りあり、どちらも同じ 29 個のツールを利用できます。

• サインイン（OAuth）。 ホスト型サーバー https://getvibeads.com/api/mcp を ChatGPT、Claude、Meta AI、または Claude Code に追加し、求められたら VibeAds にサインインします。キーもインストールも不要です。
• API キー。 Cursor、Cline、Windsurf、およびサインインできないクライアントの場合は、vba_mcp_ キーを作成してこの npm パッケージを使用するか、ヘッダーでホスト型サーバーにキーを送信します。

---

機能

• 🎯 地域密着型サービスを第一に考えた設計： 住宅関連サービス 27 業種に加え、専門サービス／リード獲得関連 8 業種に対応。うち 32 業種には、それぞれ固有のキーワード候補、CPC ベンチマーク、オーディエンスセグメント、ファネルテンプレートがあります
• 📊 アカウント健全性スコア（0〜100）： 6 つのディメンション（トラッキング、キーワード、予算、クリエイティブ、ターゲティング、パフォーマンス）に基づいて加重算出します
• 🔍 検索語句の無駄を検出： コンバージョンがない検索語句に浪費されている費用をすべて見つけます
• 💡 診断結果の集約： VibeAds の最適化エンジンから得られる 35 件以上のルールを、深刻度順に表示します
• ✍️ 書き込みツール（Pro／Max）： 戦略の作成、最適化の適用、キーワード・入札単価・予算の編集、VibeAds ゲートウェイ経由での公開ができます
• 🔐 サインインまたはキーを使用： OAuth サインインに対応したアシスタントでは OAuth を、その他では取り消し可能な API キーを使用します。Google のログイン情報がアシスタントに渡ることはありません
• 🔒 安全を考慮した設計： 読み取りツールからは何も変更できません。書き込みツールは VibeAds の安全ガードレール内で実行され、ユーザーの確認なしに費用が発生することはありません
• ⚡ GAQL 不要： 自然な言葉で質問すると、Markdown 形式の回答が得られます

---

対応カテゴリ

地域密着型・住宅関連サービス（27）： 配管工 · HVAC · 電気工事 · 屋根工事 · 清掃 · 造園 · 害虫駆除 · 塗装 · 便利屋 · 鍵屋 · ガレージドア · 家電修理 · 樹木管理 · フェンス設置 · 窓・ドア · カーペット・床材 · 防水工事 · 高圧洗浄 · エアダクト・乾燥機の排気口清掃 · 商業施設清掃・清掃管理 · プールサービス · 不用品回収 · 引っ越し業者 · 自動車修理 · クリスマスイルミネーション · 歯科医 · 弁護士

専門サービス・リード獲得関連（8）： 不動産 · 保険 · 金融サービス · 教育 · 医療 · コンサルティング · SaaS · B2B サービス

コンサルティング、SaaS、B2B サービスでは汎用のデフォルト設定を使用します。また、調整済みのナレッジベースがないその他のカテゴリも同様です。

---

接続

	サインイン（OAuth）	API キー
対象	ChatGPT、Claude（claude.ai および Claude Desktop）、Meta AI、Claude Code	Cursor、Cline、Windsurf、およびその他の MCP クライアント（キーを使いたい場合は Claude Code も）
方法	https://getvibeads.com/api/mcp を追加します。アプリが VibeAds を開くので、サインインして アクセスを許可 を押します	vba_mcp_ キーを作成して、このパッケージを実行するか、ヘッダーでキーをホスト型サーバーに送信します
キャンペーンの公開または一時停止中のキャンペーンの再開	ChatGPT、Claude、Meta AI：チャットで予算を確認した後、アシスタントに許可した日次上限の範囲内で検索キャンペーンを実行します。それ以外はすべて承認リンクが発行されます。Claude Code：常に承認リンクが発行されます	VibeAds で開く承認リンクが常に発行されます
日予算の引き上げ	ChatGPT、Claude、Meta AI：チャットで最大 20％まで引き上げられます。それ以上は承認リンクが発行されます。Claude Code：常に承認リンクが発行されます	常に承認リンクが発行されます
停止方法	設定、接続済みアプリ：接続を解除	設定、MCP サーバーキー：取り消し
レート制限	1 時間あたり 60 回。サインインしたアプリ間で共有されます	キーごとに 1 時間あたり 60 回

承認リンクは、自分のサインイン済み VibeAds セッションでのみ機能するため、キーでも接続済みアプリでも承認できません。

オプション A：サインイン（キー不要、インストール不要）

ChatGPT、Claude、Meta AI

サーバーアドレスをカスタムコネクター（Claude、Meta AI）またはカスタム MCP サーバー（ChatGPT）として追加し、アシスタントに求められたら VibeAds にサインインします。

https://getvibeads.com/api/mcp

各サービスの手順については、ChatGPT、Claude、Meta AI を接続するをご覧ください。アプリがアカウントに接続されると、VibeAds からメールが届きます。

Claude Code

固定のコールバックポートを指定してサーバーを追加し、Claude Code で /mcp を開いて VibeAds を選択し、ブラウザーでサインインします。

claude mcp add --transport http --callback-port 31790 vibeads https://getvibeads.com/api/mcp

使用するポートは空いていればどれでも構いません。31790 は例です。ポートは固定してください。VibeAds は戻り先アドレスを完全一致で確認するため、後で別のポートを使ってサインインすると拒否されます（claude mcp remove vibeads を実行して、再度追加してください）。VibeAds のサインインページでは Claude Code は「このコンピューター上のアプリ」と表示されます。Claude Code から接続を開始した直後である場合にのみ、許可してください。

サインイン済みアプリは設定、接続済みアプリに一覧表示されます。ここで接続を解除したり、アシスタントが公開できる日次予算の上限を設定したりできます。

オプション B：API キー

ステップ 1：API キーを取得する

VibeAds アカウントにサインインし、API キーを生成します。

→ API キーを生成

キーは vba_mcp_ で始まり、表示されるのは一度だけで、アカウント専用です。ほかのキーに影響を与えずに個別に取り消せるよう、クライアントまたはマシンごとにキーを作成してください。

ステップ 2：MCP クライアントを設定する

このパッケージはコンピューター上で実行され、すべての呼び出しをキーとともに VibeAds に転送します。常に API キーを使用します。サインインする場合は、オプション A を使用してください。

Claude Desktop

設定ファイルを開きます。

OS	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

mcpServers ブロックに次の内容を追加します。

{
  "mcpServers": {
    "vibeads": {
      "command": "npx",
      "args": ["-y", "@vibeads/mcp"],
      "env": {
        "VIBEADS_API_KEY": "vba_mcp_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Desktop を再起動します。🔨 ツールメニューに VibeAds のツールが表示されます。（Claude Desktop では、カスタムコネクターを使ってサインインすることもできます。オプション A をご覧ください。）

Cursor

1. 設定 → MCP を開きます
2. サーバーを追加 をクリックします
3. 次のように設定します。
   • 名前： vibeads
   • コマンド： npx -y @vibeads/mcp
   • 環境変数： VIBEADS_API_KEY=vba_mcp_YOUR_KEY_HERE

Claude Code

claude mcp add vibeads -e VIBEADS_API_KEY=vba_mcp_YOUR_KEY_HERE -- npx -y @vibeads/mcp

Cline およびその他の MCP クライアント

上記の Claude Desktop と同じ設定を使用します。ほとんどの MCP クライアントは同じスキーマに対応しています。

npx -y @vibeads/mcp --init を実行すると、各クライアント用の、そのまま貼り付けられる設定が出力されます。

または、キーを使ったホスト型サーバー

インストールは不要です。ホストされたアドレスをクライアントに指定し、x-vibeads-api-key ヘッダーでキーを送信します。Claude Code の場合：

claude mcp add --transport http vibeads https://getvibeads.com/api/mcp --header "x-vibeads-api-key: vba_mcp_YOUR_KEY_HERE"

キーは Authorization: Bearer vba_mcp_... としても使用できます。ヘッダーを送信できないクライアントでは、アドレスにキーを含めることができます（https://getvibeads.com/api/mcp?key=vba_mcp_...）。このアドレスはパスワードのように機能するため、ヘッダーを使うか、サインインすることをおすすめします。Cursor、OpenAI Codex、Gemini CLI、GitHub Copilot を使った VS Code のガイドをご覧ください。

環境変数（このパッケージ）

設定に必要なのは環境変数 1 つだけです。すべてのツール（読み取りと書き込み）は、API キーを使ってサーバー側の VibeAds ゲートウェイ経由で実行されます。

変数	必須？	用途
VIBEADS_API_KEY	✅ 必須	お使いの vba_mcp_... キーです。このパッケージで必要な認証情報はこれだけです。
VIBEADS_SUPABASE_URL	任意	VibeAds バックエンドの URL を上書きします。既定値は本番エンドポイントです。

---

使い方

接続すると、アシスタントに次のような質問ができます。

📋 キャンペーンの調査

「VibeAds のすべてのキャンペーンを表示して」

「一時停止中のキャンペーンはどれ？」

「作成日時が新しいキャンペーンを 5 件教えて」

🔬 詳細な分析

「オースティンの配管工キャンペーンについて、すべて教えて」

「先週、空調キャンペーンの成果はどうだった？」

「キャンペーン abc12345 の CPA は？」

📈 任意の期間のレポート

「オースティンの配管工キャンペーンについて、9 月と 8 月を比較して」

「先月、アカウント全体でデバイス別の費用を教えて」

「過去 90 日間で最も費用がかかったキーワードはどれ？」

🔎 キーワード調査

「テキサス州オースティンで排水管清掃を検索する人は何人いる？」

「サービスページをもとに、ラウンドロックとフラッガービルのキーワード案を探して」

🧾 Google Ads アカウント全体の監査

Google Ads に接続すれば、何もインポートする前でもすぐに利用できます。

「Google Ads の予算はどこで無駄になっている？」

「Google Ads アカウントを監査して」

📊 アカウントの健全性

「VibeAds アカウントの健全性スコアは？」

「スコアを下げている指標はどれ？」

「キャンペーン xyz の健全性スコアだけ教えて」

💸 検索語句の分析

「予算を無駄にしている検索語句は？」

「過去 30 日間で成果の高かったキーワードを上位 10 件表示して」

「コンバージョンがゼロの検索語句に、いくら無駄遣いしている？」

🩺 診断と推奨事項

「最初に何を修正すべき？」

「重大な診断結果をすべて表示して」

「屋根工事キャンペーンの問題点は？」

---

利用可能なツール

読み取りツール

ツール	用途
list_campaigns	VibeAds 内のキャンペーン（公開済み、インポート済み、下書き）を、ステータス、予算、カテゴリとともに一覧表示します。Google Ads アカウント内にのみあるキャンペーンは、find_campaigns_to_import で一覧表示されます
get_campaign_details	1 件のキャンペーンを詳しく確認します。指標、広告グループ、ターゲティング、ランディングページ、診断情報を取得します
get_account_health_score	6 つの項目に基づく 0～100 のスコアとレターグレードを表示します。キャンペーンごとの表示も可能です
get_search_term_analysis	各キャンペーンで最後に同期された検索語句（同期前の 7 日間が対象、コストのしきい値は設定可能）から、無駄な支出と成果の高い語句を表示します
get_diagnostics	最新のエージェント最適化診断を、重要度と推奨される修正方法とともに表示します（最大 50 件）
find_campaigns_to_import	インポートする前に、Google Ads から読み込んだ Google Ads アカウント内のキャンペーンを一覧表示し、それぞれが VibeAds 内にあるかどうかを示します（VibeAds が管理するのは、VibeAds 内のキャンペーンのみです）。0.2.15 では list_google_ads_campaigns と呼ばれていました
get_performance_report	選択した期間（プリセット、または最大 90 日間の開始日と終了日）について、1 件のキャンペーンまたはアカウント全体の数値を Google Ads からリアルタイムで読み込みます。日別、デバイス別、時間別、広告グループ別、キーワード別、地域別の表示も可能です。金額はアカウントの通貨で表示されます。すべてのクエリは VibeAds が作成し、アシスタントは期間と内訳のみを選択します
audit_google_ads_account	接続済みの Google Ads アカウント 1 件を Google Ads からリアルタイムで監査します。VibeAds 内にあるかどうかを問わず、過去 30 日間の検索キャンペーンを最大 25 件対象とし、アカウントと各キャンペーンの健全性スコア（0～100）とグレード、チェック項目ごとにまとめた問題と Google Ads での修正方法、クリック数がありコンバージョンがない各キャンペーンのコストが最も高い検索語句を表示します。監査結果はアカウントごとに 1 件、24 時間保持されます
list_keywords	公開済みキャンペーン 1 件の広告グループ、キーワード、除外キーワードを Google Ads からリアルタイムで読み込みます。一致タイプ、ステータス、上限 CPC、過去 30 日間のクリック数、費用、コンバージョンを表示します
research_keywords	指定した地域を対象に、シードキーワード、ウェブページ、またはその両方から、Google のキーワード プランナーのキーワード候補を取得します。月間平均検索数、競合度、ページ上部への入札単価の範囲を表示します。Pro/Max が必要です。2 クレジット（90 日以内の再実行は無料）
list_google_ads_accounts	接続済みの Google Ads アカウントを、オンかどうかを問わずすべて一覧表示し、各クライアントアカウントが属する管理者アカウント（MCC）も表示します
list_google_recommendations	アカウントに対する Google 独自の推奨事項（Recommendations ページ）を、Google による見積もりと、各推奨事項をチャットから適用できるかどうかとともに表示します

読み取りツールは読み取り専用です。Google Ads アカウント内の項目を作成、変更、一時停止、削除することはできません。VibeAds ゲートウェイを介してサーバー側で実行されるため、サインインした場合もキーを使用した場合も同じように動作します。読み取りツールは無料プランを含むすべてのプランで利用できます。ただし、research_keywords の利用には Pro または Max が必要です。

書き込みツール（Pro/Max）

書き込みツールは、サインインまたは API キーだけを使って、サーバー側の VibeAds ゲートウェイで実行されます（Supabase や Google のキーは不要です）。すべての呼び出しにはレート制限が適用され、承認された最適化は実行後に測定されます（指標が悪化した場合、変更が小さければ自動的にロールバックされます）。また、費用が発生する操作は、必ずお客様の確認なしには実行されません。API キーを使用する場合、または Claude Code にサインインしている場合は、VibeAds で開く承認リンクが提供されます。ChatGPT、Claude、Meta AI は、チャットで予算を確認した後、アシスタントに許可した 1 日あたりの上限内でのみ公開します。

ツール	目的
generate_strategy	キーワード、広告文、3 つ以上の広告グループを含むキャンペーン戦略全体をサーバー側で作成します。ビジネス名で検索した場合に備えてブランド広告グループを設け、Max では指定した競合他社ごとに広告グループを作成します。13 クレジットを消費します。下書きのみです。公開されることも、費用が発生することもありません
get_strategy_status	戦略ジョブのステータス、フェーズ、完了後の作成済み広告グループを確認します
apply_strategy	完了したプレビューを実際の下書きキャンペーン（広告グループ、キーワード、ターゲティング、広告文、広告表示オプション）に変換します。画像生成には 6 クレジットと広告グループごとに 3 クレジットを消費します。下書きのみです。配信されることも、広告費が発生することもありません
list_recommendations	保留中の最適化の推奨事項を一覧表示します。各項目には、実行するツールと正確な引数（セッション ID と推奨事項 ID を含む）が示されます。変更を行うツールがない場合は、VibeAds で承認するためのリンクが表示されます
preview_ad_group	新しい広告グループ（キーワード、3 つの広告、ランディングページのプラン）を追加前に表示します。プレビューのみを作成します
add_ad_group	プレビューした広告グループを追加します。公開済みのキャンペーンの場合、キャンペーンの予算内ですぐに配信が始まります
request_publish	広告グループがあるキャンペーンを公開します。公開すると実際の費用が発生するため、API キーまたは Claude Code を使用している場合は、人間による承認 URL が返されます。ChatGPT、Claude、Meta AI では、チャットで予算を確認した後、アシスタントに許可した 1 日の上限内で検索キャンペーンが公開されます。それ以外の場合は承認 URL が返されます。Google Ads アカウントが複数ある場合は、どのアカウントを使うかを尋ね、そのアカウントでのみ公開します
import_campaigns	Google Ads アカウントから最大 3 件のキャンペーンを VibeAds に取り込み、オプティマイザーとレポートの対象にします。Google Ads 側には変更を加えません。1 件につき 1 クレジットです
pause_campaign	Google Ads で配信中のキャンペーンを一時停止します
resume_campaign	一時停止中のキャンペーンを再開します。公開時と同じルールが適用され、API キーまたは Claude Code を使用している場合は、人間による承認 URL が返されます
add_negative_keywords	キャンペーンまたは 1 つの広告グループに、除外キーワードを一度に最大 20 個追加します。キャンペーン自体のキーワードを除外してしまうものは追加されません
add_keywords	1 つの広告グループに、広告グループのデフォルトの上限クリック単価で、キーワードを一度に最大 20 個追加します
set_keyword_status	キーワードを一時停止するか、一時停止中のキーワードを再開します
set_max_cpc	手動 CPC キャンペーンの広告グループ、キーワード、またはキーワードのリストに上限クリック単価を設定します。一度に 2 倍まで、クリックあたり 50 ドルまで設定できます。それを超える場合は承認 URL が返されます
set_daily_budget	キャンペーンの日予算を設定します。減額はすぐに反映されます。API キーまたは Claude Code を使用している場合、増額では承認 URL が返されます。ChatGPT、Claude、Meta AI にサインインしている場合は、最大 20％まで即時反映されます
dismiss_google_recommendation	Google の推奨事項を 1 件、リストから削除します。キャンペーンは変更されません
check_approval	公開または変更の承認状況を確認します。保留中 → 承認済み → 実行中 → 実行済み（または却下／期限切れ／失敗）

キーワード、入札単価、予算、再開に関する変更はすべて、VibeAds のキャンペーンの［最適化］タブに記録され、取り消すことができます。VibeAds がこれらの変更を自動で取り消すことはありません。アシスタントはキャンペーンに対して 1 日に 20 件の変更を行えます。

アイデアからキャンペーンの配信開始まで：

1. generate_strategy がサーバー側で戦略の下書きを作成し、jobId を返します。この時点では、Google Ads に何も作成されていません。
2. get_strategy_status でジョブの状態を確認し、completed と報告されるまで待ちます。
3. apply_strategy が完成したプレビューを実際の下書きキャンペーンに変換し、campaignId を返します。まだ配信されず、費用も発生しません。
4. request_publish にその campaignId を渡します。API キーまたは Claude Code を使用している場合は、承認リンクが返されます。
5. ブラウザーでリンクを開き、VibeAds にサインインして、キャンペーンと予算を確認し、［承認］（または［却下］）をクリックします。
6. check_approval が承認状況を報告し、その後、公開ジョブの状況を報告します。ジョブが完了すると、キャンペーンの配信が始まります。 手順 1～3 では VibeAds 内に行を作成するだけで、VibeAds クレジットを消費します（手順 1 では 13、手順 3 では 6 ＋ 広告グループごとに 3）。API キーを使う場合、広告費用が発生するのは手順 5 のみで、実行できるのはブラウザー内だけです。キーだけで公開することは決してできないため、キーが漏洩しても費用は発生しません。

サインインして接続した ChatGPT、Claude、Meta AI は、アシスタントに許可した上限内の日予算で検索キャンペーンを実施する場合、承認リンクを省略できます（VibeAds の Settings の Connected apps で変更または無効にしない限り、1 日あたり $100 です）。手順 4 でアシスタントが日予算を伝え、チャットで確認した後にのみ公開します。キャンペーンが公開されると、VibeAds からメールが届きます。より大規模なキャンペーンでは承認リンクが表示されます。

---

セキュリティ

• 読み取りツールは読み取り専用です。 キャンペーン、Google Ads アカウント、VibeAds の設定を変更することはできません。
• 書き込みツールには保護措置があります。 すべての書き込み操作は VibeAds ゲートウェイを通じてサーバー側で実行され、1 時間あたり 60 回にレート制限されています。承認された最適化は実行後に効果を測定し、指標が悪化した場合は小規模な変更を自動的にロールバックします。アシスタントが行ったキーワード、入札単価、予算、再開に関する変更はすべて、VibeAds のキャンペーンの Optimize タブに表示され、元に戻すことができます。
• 費用の発生には本人の操作が必要です。 承認リンクは、ご本人がサインインした VibeAds セッションでのみ機能するため、キーや接続済みアプリから承認することはできません。API キーでも、サインイン済みの Claude Code でも、それだけで公開、キャンペーンの再開、予算の引き上げを行うことはできません。
• Google のログイン情報は VibeAds に保管されます。 Google Ads は、Google 独自のサインインを通じて一度だけ VibeAds に接続します。キーやサインイン済みアプリがアクセスするのは常に VibeAds のみです。Google のトークンがアシスタントやお使いのコンピューターに渡ることはありません。

サインイン（OAuth）

• PKCE を使用する OAuth 2.1 認可コードフローです。VibeAds のサインインページには、要求元のアプリと許可される操作が表示され、アクセスを許可をクリックします。
• これらのツール以外では、VibeAds はアカウントを変更する操作をサインイン済みアプリに許可せず、Google Ads のログイン情報を見せることもありません。
• アプリがアカウントに接続されると、VibeAds からメールが届きます。
• Settings, Connected apps で任意のアプリを接続解除できます。アプリは直ちにサインアウトされます。

API キー

• キーは保存前に SHA-256 でハッシュ化されます。完全なキーが表示されるのは作成時の一度だけです。
• Settings, MCP Server Keys からいつでも無効化できます。
• 使用状況はキーごとに記録されます。最終使用日とリクエスト数を確認できます。
• 各キーの対象は単一の VibeAds ユーザーに限定され、他のユーザーのデータを参照することはできません。

セキュリティを最大限に高めるには、デバイスの所有者が変わるときや利用が終了したときに、API キーを無効化して新しいキーに置き換えてください。

---

要件

• 有効な VibeAds アカウント：サインインとキーは無料プランを含むすべてのプランで利用できます
• Pro または Max プラン：書き込みツールを使うには必要です（読み取りツールはどのプランでも利用できます）
• VibeAds に接続された Google Ads：最新の数値の取得、インポート、公開に必要です。VibeAds Settings で接続するか、アシスタントが必要なときに提示するリンクから接続してください
• 公開済みまたはインポート済みのキャンペーンが 1 つ以上：診断には Google Ads から同期されたデータが必要です
• Node.js ≥ 20：この npm パッケージでのみ必要です（npx で実行します）。サインインやホスト型サーバーの利用に、インストールは必要ありません

---

比較

	VibeAds MCP	GoMarble MCP	Google Ads MCP（公式）
セットアップ時間	2 分	15 分	30 分
接続方法	VibeAds にサインイン（OAuth）するか、API キーを使用します。Google Ads への接続は VibeAds 内で一度だけ行います	Google OAuth	Google OAuth
GAQL の知識が必要	❌	✅	✅
ローカルサービス向けの最適化	✅	❌	❌
アカウントの健全性スコア	✅ 6 つの観点	❌	❌
事前構築済みの診断	✅ 35 以上のルール	❌	❌
複数アカウント対応	✅	✅	✅
確認付きの書き込み操作	✅ 費用が発生する操作はすべて確認します	❌	❌

VibeAds MCP の使用が適している場合： 地域密着型のサービス事業を運営している（またはその広告を管理している）場合で、GAQL を学ばずに最適化済みのインサイトを得たいときです。

GoMarble / Google Ads MCP の使用が適している場合： カスタム GAQL クエリを実行する必要がある場合や、サービス業以外のキャンペーン（EC、B2B SaaS など）を扱う場合です。

3 つは併用できます。ワークフローに合ったものをインストールしてください。

---

トラブルシューティング

「API キーが無効です」または「認証に失敗しました」

• キーが vba_mcp_ で始まっていることを確認してください
• https://getvibeads.com/app/settings/mcp で新しいキーを生成してください
• キーが取り消されていないことを確認してください

「VibeAds API キーがありません」（キーを指定したホスト型サーバー）

ヘッダー名は正確に x-vibeads-api-key とし、キーは vba_mcp_ で始まっている必要があります。または、ヘッダーを削除してサインインしてください。

アシスタントから再度サインインを求められる、または接続されていないと表示される

Settings の Connected apps でアプリの接続が解除されたか、サインインの有効期限が切れています。アシスタントから再接続してサインインしてください（ChatGPT：Settings、Plugins、VibeAds。Claude：Customize、Connectors。Claude Code：/mcp）。

Claude Code：サインインが拒否される

Claude Code が固定のコールバックポートを指定せずに追加されたか、別のポートを指定して追加されています。claude mcp remove vibeads を実行して削除し、--callback-port を指定して再度追加して（オプション A を参照）、/mcp からサインインしてください。

「最適化の診断はまだありません」

診断は、Google Ads のパフォーマンスが同期された後、VibeAds エージェントによって 12 時間ごとに生成されます。キャンペーンを公開したばかりの場合は、初回の実行まで最大 1 日お待ちください。

「検索語句のデータが見つかりません」

検索語句の同期は 6 時間ごとに実行されます。新しいキャンペーンでは、有意なデータが蓄積されるまで 24～48 時間お待ちください。

MCP クライアントがサーバーを見つけられない（npm パッケージ）

Node.js 20 以降がインストールされていることを node --version で確認してください。Claude Desktop と Cursor はどちらも npx をシェルから実行するため、Node が PATH に含まれている必要があります。

---

コントリビューション

これは MIT ライセンスのオープンソースパッケージです。Issue や PR は次の場所で歓迎します。 https://github.com/vibeads/mcp/issues

---

ライセンス

MIT © VibeAds