カテゴリーを見る

MCP経由でClaude/Cursorを使用してGoogle広告にクエリを実行する方法(Google広告MCPサーバーの設定)

25分で読める

MCPサーバー Google広告

Google広告を検索する クロードまたはカーソル Google広告MCPサーバー経由。

わずか5分でGoogle広告MCPをセットアップでき、AIツールがキャンペーン、広告グループ、検索語句について平易な英語で質問できるようになります。Query StreamsエージェントはGoogle広告APIをローカルSQLサーフェスにキャッシュするため、LLMはRESTエンドポイントではなく実際のテーブルを参照できます。また、Schema Intelligenceがメトリックの語彙(マイクロ単位のコスト、ステータス列挙型、デバイス分割など)を処理するため、SQLは初回から正しく実行されます。

ファイアウォールに穴はありません キー1つで、すべてのコネクタが接続可能 リアルタイムデータ、キャッシュ遅延なし ご自身のAIツールをご持参ください

Query Streamsは、安全なリアルタイムデータ統合プラットフォームであり、ファイアウォールの変更なしに単一のMCPキーを介して、アカウント内のすべてのデータベースとSaaS APIをClaude、Cursor、ChatGPT、およびGrokに統合します。 このガイドでは、 Google広告MCP パスを具体的に指定することで、Google Ads UI からレポートをエクスポートしたり、広告エディタで別の GAQL クエリを作成したりすることなく、AI ツールがキャンペーン、広告グループ、検索語句、コンバージョンに関する平易な英語の質問に答えることができます。ネットワーク エージェントは広告 API データをローカルの DuckDB キャッシュに取り込むため、LLM は生の REST や GAQL ではなく、クリーンな SQL サーフェス (キャンペーン、キーワード、検索語句、コンバージョン) を参照できます。 詳細についてはQueryStreams.comをご覧ください そして 無料で登録する AIツールにGoogle広告に関する実際の質問を投げかけてみましょう。

Query Streams Google Ads MCPサーバーが提供するもの

オープンソース環境にある他の「Google Ads MCP」サーバーは、AIツールを広告APIに直接接続し、生のGAQLを送信します。これは機能しますが、Google OAuthトークンをAIクライアントの設定にプッシュし、LLMがSQLではなくRESTリソースとフィールドセレクターを見つめることになり、AIツールのスコープがGoogle広告のみに限定され、AIが実際に何を要求したかの監査証跡が得られません。Query StreamsのGoogle広告MCPサーバーは、より広範な問題を解決します。1つのキーですべてのコネクタが動作し、完全な監査証跡が得られ、エージェントが広告データをSQLサーフェスに正規化し、AIツールがGoogle認証情報を保持することはありません。

受信ファイアウォールの穴はゼロ

ネットワークエージェントは、クエリストリームへの単一の暗号化されたクラウドリンクを開きます。AIクライアントはクラウドに接続し、Google広告OAuthやネットワークには接続しません。ポートを開放する必要も、IPアドレスを許可リストに追加する必要も、VPNを使用する必要もありません。

キー1つで、すべてのコネクタが接続可能

同じ MCP キーが、アカウントに接続されている他のすべてのデータベースや SaaS API と共に Google 広告に送信されます。明日 Stripe や PostgreSQL のコネクタを追加すれば、AI ツールはキーを再入力することなく、キャンペーンと並べて表示します。

スキーマインテリジェンスが組み込まれています

AI は、すべての Google Ads フィールドに対して、GAQL フィールド名だけでなく、AI がキュレーションした説明、意味タイプ (マイクロ単位の通貨、ステータス列挙型、デバイス分割)、サンプル値、および発見された外部キーを認識します。最初の試行で正確な SQL を書き込み、 cost_micros / 1000000 ベアスキーマLLMでは見落とされる変換。

エージェントで読み取り専用が強制されます

たとえ幻覚を見ているLLMであっても、Query Streams MCPを介してキャンペーンを一時停止したり、入札額を変更したり、広告グループを変更したりすることはできません。ネットワークエージェントは、それ以外のものを拒否します。 セレクト, 、または 説明する キャッシュされた広告テーブルに到達する前に、Google 広告の変更操作はそもそも MCP の表面に公開されることはありません。

キーごとの料金制限

デフォルトでは1分あたり60件のリクエストと1分あたり10件の実行呼び出しが設定されており、キーごとに設定可能です。AIツールの呼び出しループが暴走した場合、トークンバケットが消費されます。これは、Google広告APIの割り当て量、開発者トークンの制限、またはウォレット容量を消費するものではありません。

ファイアウォールポートを開放せずに動作する方法

Query Streams Network Agent は、インターネットにアクセスできる任意のホストに一度インストールされ (Ads API はどこからでもアクセス可能)、クラウドへの 1 つのアウトバウンド TLS リンクをダイヤルします。内部では GAQL を使用して Google Ads API を呼び出し、応答をローカルの DuckDB にキャッシュして、AI がクリーンな SQL サーフェスを参照できるようにします (google_ads_performance, キーワード, 検索語句, 変換, 観客REST エンベロープの代わりに ) を使用し、AI ツールは Google OAuth トークン、顧客 ID、または開発者トークンを見ることはありません。 発信専用接続の仕組み →

AIクライアント

カーソル、クロード、
ChatGPT、Grok

QS MCPサーバー

ストリーミング可能なHTTP
X-MCPキー認証

ネットワーク・エージェント

あなたのネットワーク上で
クラウドリンクアウト

Google広告API

SQLとしてキャッシュ
DuckDB経由

着信ポートは不要です。エージェントが発信するだけで、その逆はありません。

CursorまたはClaudeに与えるMCPキーはスコープ付きです(読む / 分析する / 実行する)、いつでも取り消し可能で、キーごとにレート制限が設けられています。AIツールは、以下のMCPツールを呼び出して処理を実行します。

querystreams-mcp · ツールカタログ
qs_list_organizations読む
呼び出し元のキーにバインドされている組織を返します。
qs_list_agents読む
ネットワークエージェントとオンライン状態を一覧表示します。
qs_list_connectors読む
データコネクタの一覧を表示します(データベースサーバーまたはAPIごとに1つのエントリ)。
qs_get_connector_schema読む
AIがクエリできるキャッシュされたGoogle広告テーブルと列(キャンペーン、広告グループ、検索語句、コンバージョン、オーディエンス)を返します。利用可能な場合は、スキーマインテリジェンスによるエンリッチメントも含まれます。
qs_profile_table分析する
サンプル値、分布、列挙型検出、意味型など、ご要望に応じて提供いたします。
qs_list_saved_queries読む
チームが信頼する、事前に構築されたパラメータ付きSQLテンプレート。AIはSQL文を見ることなく、これらのテンプレートを実行します。
qs_run_saved_query実行する
保存されたクエリを実行します パターンキー オプションのパラメータ上書き機能付き。
qs_run_query実行する
コネクタに対してSELECT文を実行します。読み取り専用バリデーターは、データベースがSQL文を認識する前に、エージェント上で実行されます。

スキーマインテリジェンスがQuery Streams MCPを他と差別化する理由

オープンソース環境にあるほとんどの「Google広告用MCP」サーバーは、Googleが開発者向けに公開しているのと同じGAQLフィールド参照、あるいはさらに悪いことに、生のGAQLフィールド参照をAIツールに渡します。 情報スキーマ キャッシュの内容。フィールド名。データ型。おそらく主キー。LLM は推測するしかない。 コストマイクロ 1,000,000で割る必要がある、 キャンペーンステータス は列挙型です 有効 / 一時停止 / 削除済みあるいは、 セグメント日付 は「過去 30 日」の正しいパーティション列です。そのため、ほとんどの LLM が、むき出しの Ads スキーマに対して最初に書く SQL は間違っています。これは LLM が悪いからではなく、正しく動作するために必要なデータがないためです (そして、コストが 1,000,000 もずれているような間違いは、Slack メッセージになるような種類の間違いです)。

クエリ ストリーム MCP は、私たちが スキーマインテリジェンス(SI) — AI がキュレーションしたメタデータは、あなたの 実際 AIクライアントが要求する前にGoogle広告データを取得します。Google広告コネクタでSIが有効になっている場合、AIが呼び出すすべてのスキーマツール(qs_get_connector_schema, qs_get_table_schema, qs_profile_table, qs_get_relationships) は、キャッシュされたスキーマと、厳選された知識の 6 層を返します。LLM は推測を停止します。

これを具体的に示すために、AIクライアントが単一のデータから何を受け取るかを以下に示します。 qs_get_table_schema Google広告コネクタに対する異議申し立て google_ads_performance テーブル — レポートに関する質問の 90% を占める、非正規化されたキャンペーン + 広告グループ + 日付ビュー — 最初はスキーマ インテリジェンスなし、次にスキーマ インテリジェンスありで比較します。

スキーマインテリジェンスなし データソース: キャプチャされたスキーマ
// LLMが見るもの == テーブル: google_ads_performance == 列: – 顧客ID bigint NOT NULL – キャンペーンID bigint NOT NULL – キャンペーン名 varchar(500) – キャンペーンステータス varchar(20) – ad_group_id ビギント – 広告グループ名 varchar(500) - デバイス varchar(20) – セグメント日付 日付がNULLでない – クリック bigint NOT NULL – 感想 bigint NOT NULL – コストマイクロ bigint NOT NULL – 変換 decimal(18,4) 索引: ix_segments_date、ix_campaign_id 外部キー: (キャッシュに宣言されていません) si_推奨事項: 州: 「実行しない」 この通話に必要な情報: – cost_micros セマンティックタイプ(通貨単位:マイクロ) – campaign_status / device 列挙値リスト – サンプル値 + ビジネスドメインのタグ付け – テーブルと列の説明 – キャッシュされた広告テーブル間の AI が発見した関係
スキーマインテリジェンスを使用 データソース: スキーマインテリジェンス
// LLMが見るもの == テーブル: google_ads_performance [FACT、ドメイン:マーケティング] == 「顧客、キャンペーン、広告グループ、デバイス、日付ごとの、日次非正規化Google広告パフォーマンス。cost_microsはマイクロ単位の通貨です(1,000,000 = 1ドル)。」 ai_analyzed_at: 2026-05-05 · 約512,840行 列: – 顧客ID ビギント 識別子 FK -> ad_accounts.customer_id (100%、信頼度 0.99) – キャンペーンID ビギント 識別子 – キャンペーン名 varchar(500) テキストコンテンツ サンプル:「ブランド – 米国 – 検索」、「パフォーマンスマックス – ホリデー」 – キャンペーンステータス varchar(20) ステータスコード(列挙型) 有効(78%)|一時停止(19%)|削除済み(3%) - デバイス varchar(20) ステータスコード(列挙型) モバイル(54%)|デスクトップ(38%)|タブレット(8%) – セグメント日付 日付 日付ISO サンプル:2026年5月5日、2026年5月4日、2026年5月3日 – クリック ビギント カウンタ 範囲:0~18,744 – 感想 ビギント カウンタ 範囲:0~412,338 – コストマイクロ ビギント 通貨マイクロ ⚠ 1,000,000で割ると米ドルになります サンプル:56640000(=56.64ドル)、1284000(=1.28ドル) – 変換 decimal(18,4) カウンター(分数) 範囲:0.00~184.50 平均1.84

スキーマインテリジェンスが追加する6つのレイヤー

各層は、LLMが推測しなければならない特定の種類の質問に対応します。SIはオプトインです。 (コネクタ、データベース) これはペアリングして、データに対して一度限りのプロファイリング処理を実行します。スキーマを変更したり、データベースに書き込んだりすることはなく、スキーマが変更された場合は段階的に更新されます。

AIが厳選した説明文

すべてのデータベース、スキーマ、テーブル、列の目的を平易な英語で記述します。一度生成すれば、スキーマが変更されるたびに自動的に更新されます。信頼性スコア付きで、ユーザーが作成した説明が常に優先されます。

google_ads_performance: 「日次非正規化
キャンペーン別+デバイス別の広告パフォーマンス。

表の分類

各テーブルには、FACT(トランザクションイベント)、DIM(記述参照)、またはLOOKUP(小さなコードマップ)のタグが付けられており、さらにマーケティング、営業、人事、SEO、財務、サポートなど、14種類以上のビジネスドメインが関連付けられています。

google_ads_performance [FACT、ドメイン:マーケティング]
ad_accounts [DIM、ドメイン:マーケティング]

列ごとの意味型

18種類のタイプ - currency、currency_micros、email、date_iso、status_code、percentage、ranking_position、identifier、urlなど。AIは、各タイプに適した方言に正しいSQLを生成します。 cost_micros / 1000000 ベアスキーマLLMでは正しく変換できない。

cost_micros: currency_micros
変換: カウンター · セグメント日付: date_iso

実データからのサンプル値

LLMにはランダムな行が表示されるため、スキーマでは表示できないパターン(書式規則、エンコードされた値、命名スタイル、キャンペーン名の実際の構造など)を認識できます。

キャンペーン名: [“ブランド – 米国 – 検索”,
「パフォーマンスマックス – ホリデー」、「RLSA – 高LTV」

分布を用いた列挙型検出

カーディナリティの低い列(一意の値が50個以下、行の5%以下が一意)は、行数とともに値のリスト全体にマッピングされます。AIは、Google広告の列挙型において、大文字小文字やスペルを推測することはありません。

キャンペーンステータス: 有効 (78%) |
一時停止中(19%)|削除済み(3%)

暗黙的な外部キーの発見

テーブル間のデータ重複分析では、DDL制約として宣言されていない結合が見つかります。信頼度スコア付きの正式なFKとともに保存され、 qs_get_relationships.

google_ads_performance.customer_id ->
ad_accounts.customer_id(重複率100%、信頼度0.99)

同じプロンプトだが、SQLが異なる

その証拠は、AIツールが実際に書き出すSQLにある。同じカーソルセッション、同じクロードモデル、同じプロンプト―― 「過去30日間で最も多くの費用を費やしたキャンペーンはどれですか?コンバージョン率も併せて示してください。有効なキャンペーンのみを対象としています。」 スキーマインテリジェンスがない場合、LLMは推測するしかありません。スキーマインテリジェンスがあれば、LLMはコストがマイクロ単位であること、ステータス列挙型にフィルタリングが必要であること、NULLIFガードが必要であることを認識できます。

スキーマインテリジェンスなし
— LLMによるベアスキーマに対する最初の試み: セレクト キャンペーン名、 合計(コストマイクロ) AS 料金、 合計(変換) AS 会話、 合計(変換)/ 合計(クリック) AS コンバージョン率 フロム google_ads_performance どこ segments_date >= 2026年4月6日 GROUP BY キャンペーン名 ORDER BY 料金 DESC リミット 10 費用は5664万ドルと報告されたが、実際は100万ドルの誤差があった。 cost_microsはマイクロ単位で格納されます(1M = 1ドル)。 campaign_statusフィルターなし — PAUSED + REMOVEDを含む クリックのない行におけるゼロ除算リスク 日付がハードコードされている — 「過去30日間」は動的であるべき
スキーマインテリジェンスを使用
— LLMがSIを有効にして初めて試みた方法: セレクト キャンペーン名、 合計(コストマイクロ) / 1000000 AS コスト_米ドル、 合計(変換) AS 会話、 ラウンド(合計(変換) * 100.0 / ヌライフ(合計(クリック) 0), 2) AS 変換率(%) フロム google_ads_performance どこ segments_date >= 日付('今', -30日) アンド キャンペーンステータス = 「有効」 GROUP BY キャンペーン名 ORDER BY 費用(米ドル) DESC リミット 10 10行。初回で正解。 cost_micros は意味タイプ = currency_micros を確認しました campaign_status を列挙値「ENABLED」にフィルタリングしました NULLIFはゼロクリックキャンペーンから保護します DATE('now', '-30 days') は方言的に正しい
スキーマインテリジェンスを実行したくないですか? MCP は依然として機能しています — スキーマ ツールは、ベア メタデータ (型、主キー、正式な外部キー、インデックス) を返し、すべての劣化レスポンスには、 si_推奨事項 AIに何が不足しているかを伝えるブロック、会話の途中でSIを有効にするワンコールオプションを含む qs_request_si_analysis. スキーマインテリジェンスの実行方法と所要時間 →
ノヴァAI

MCPが合わない場合は、Nova AIをお試しください。

JSON設定を完全にスキップする: Nova AIはQuery Streamsウェブポータルに組み込まれています。 そして、同じ平易な英語で Google 広告の質問をします(今月、どのキーワードが予算を無駄にしているでしょうか?追加したすべてのコネクタで同じエージェント、同じ読み取り専用の強制、同じスキーマ インテリジェンス、MCP の配管は不要です。

Nova AIをご紹介します

前提条件

始める前に、以下のものを用意してください。

  1. 無料のQuery Streamsアカウントは my.querystreams.com.
  2. インターネットアクセス可能なマシンにインストールされたクエリ ストリーム ネットワーク エージェントについては、以下を参照してください。 クエリストリームエージェントをダウンロードしてくださいGoogle広告APIはどこからでもアクセスできるため、エージェントは特定のネットワーク上に存在する必要はありません。
  3. エージェントに対して構成された Google 広告コネクタ - 既存の APIコネクタのセットアップ OAuthペアリング(シングルアカウントまたはMCCマネージャー)に関するガイド。エージェントはGoogle OAuthトークン、顧客ID、および開発者トークンを保持します。AIツールはこれらの情報に一切アクセスしません。
  4. MCP対応のAIクライアントであればどれでも使用できます。このガイドでは、Cursor、Claude Desktop、ChatGPT、Grokを例に説明しますが、Windsurf、Zed、Continue、Cline、VS Code Copilot、Codex、Gooseを使用する場合でも、設定ブロックは基本的に同じです。
  5. 5分。
エージェントの設定は一度だけで済みます。 Query StreamsのExcelおよびGoogle Sheetsアドオン、Webクエリビルダー、Nova AIを支えるのと同じエージェントがMCPにも使用されています。既存のQuery StreamsアカウントにMCPを追加するには、キーを生成するだけで済みます。エージェントとコネクタは既に稼働しています。
1

MCPキーを生成する

から /mcp クエリ ストリームのページで、必要なスコープを持つキーを作成します。

2

AIクライアントにドロップしてください

Cursor、Claude、ChatGPT、Grokのいずれにも使用できるJSONスニペットは1つだけです。キーはどこでも同じです。

3

質問する

「今月、最も投資対効果の高いキャンペーンはどれですか?」—AIが適切なツールを呼び出し、答えが得られます。

ステップ1:クエリストリームでMCPキーを生成する

クエリ ストリームにサインインして、 MCPページ (または最初にサインインしてください) my.querystreams.com そしてクリック MCP 左側のナビゲーションでクリックします。 キーを生成するキーに分かりやすい名前を付けます(例: カーソルラップトップ または クロード・デスクトップ)、そしてこのキーに適用したいスコープを選択します。

  • 読む — AIはコネクタを閲覧し、スキーマを読み取ることができる。他のすべての機能には必須である。
  • 分析する AIはテーブルのプロファイリングを行い、関係性(サンプル値、分布、意味タイプ)を検出できます。有料検索広告では、キャンペーンデータの構造や指標の意味(マイクロ単位のコスト、ステータス列挙型など)を理解することが重要なため、この機能はオプションですが強く推奨されます。
  • 実行する — AIは実際にSQLを実行できる。これがなければ、AIはスキーマメタデータに対してのみ読み取り専用となる。

典型的な「クロードにGoogle広告データを分析してもらう」ワークフローでは、3つのスコープすべてが適切です。チームメイトや信頼度の低いクライアントに渡すキーの場合は、 実行する そして閲覧のみを許可します。同じページからいつでも任意のキーを取り消すことができます。AIクライアントはそれを認識します。 MCP_KEY_REVOKED 次の呼び出し時に動作を停止し、すぐに通信を終了します。伝播遅延はありません。

キーを今すぐコピーしてください。Query Streams はキーを一度表示した後、ハッシュのみを保存します。キーを紛失した場合は、新しいキーを生成してください。キーは次のようになります。 qsmcp_ 続いて48個のランダムな文字があり、これはAIクライアントが送信するものです。 X-MCPキー リクエストヘッダー。

ステップ2:AIクライアントにQuery Streams MCPを追加する

構成は、MCP 対応クライアントすべてで同じ形状です。MCP サーバーのエントリは、 https://mcp.querystreams.com キーを X-MCPキー ヘッダー。下記からクライアントを選択してください。

カーソル
カーソル ~/.cursor/mcp.json
// ~/.cursor/mcp.json を編集する
{
  「mcpServers」: {
    「クエリストリーム」: {
      「url」: 「https://mcp.querystreams.com」,
      「ヘッダー」: {
        「X-MCPキー」: "qsmcp_PASTE_KEY_HERE"
      }
    }
  }
}
クロード・デスクトップ
クロード・デスクトップ claude_desktop_config.json
// 設定 → 開発者向け → 設定の編集
{
  「mcpServers」: {
    「クエリストリーム」: {
      「url」: 「https://mcp.querystreams.com」,
      「ヘッダー」: {
        「X-MCPキー」: "qsmcp_PASTE_KEY_HERE"
      }
    }
  }
}
チャットGPT
チャットGPT アプリとコネクタ
// 設定 → アプリとコネクタ → MCP を追加
サーバーURL  https://mcp.querystreams.com
認証ヘッダー X-MCPキー
ヘッダー値 qsmcp_ここにキーを貼り付けてください

// ChatGPTの有料プランが必要です
// (プラス / プロ / チーム / エンタープライズ)
グロック
グロック リモート MCP ツール
// Grok → 設定 → ツール
{
  「mcp_servers」: [{
    "名前": 「クエリストリーム」,
    「url」: 「https://mcp.querystreams.com」,
    「auth_header」: 「X-MCPキー」,
    「認証値」: 「qsmcp_...」
  }]
}

AIクライアントを再起動してください。次回起動時に、上記にリストされている8つのクエリストリームMCPツールが検出され、ツールパレットに表示されます。CursorおよびClaude Desktopでは、次のように入力して確認できます。 「リストコネクタ」 — AIは電話すべき qs_list_connectors そして、Google広告コネクタ(またはMCCとペアリングしている場合は各子アカウント)と、その他設定済みのすべてのものを返却してください。

ステップ3:AIにGoogle広告に関する質問をする

SQL文を書く必要はありません。AIが書きます。質問をすると、AIが適切なMCPツールを選択し、エージェントがキャッシュされたGoogle広告データに対してクエリを実行し、テキストと表形式で回答が返されます。まず試していただきたい3つの例文を以下に示します。

「過去30日間で最も高いROI(投資対効果)を達成したキャンペーンはどれですか?(コスト対コンバージョン数、有効になっているキャンペーンのみ)」
投資対効果(ROI)
AIが電話をかけます qs_get_connector_schema キャッシュされた広告テーブルを見つけるには、 qs_run_query SELECT文で google_ads_performance 分裂させる コストマイクロ 1,000,000 倍、コンバージョンと収益を合計、フィルター campaign_status = '有効' そして セグメント日付 過去30日間のデータに基づいて、キャンペーンごとのROASまたはCPAを計算します。結果テーブルがインラインで表示され、どのキャンペーンが効率的にスケールアップしているか、現在の支出で非効率なキャンペーンはどれか、そしてSchema Intelligenceの列挙型検出によってエージェントがフィルタリングした「低コスト、低コンバージョン」ゾーンに留まっているキャンペーンはどれか、といった解釈がテキストで表示されます。 一時停止 + 削除済み 自動的に。
「コンバージョンにつながったが、まだキーワードになっていない検索語句を教えてください。それらをキーワードに追加しましょう。」
ネガティブキーワードの発見
AI はキャッシュされた 検索語句 テーブルに キーワード 検索語句のテキストに基づいて、過去 30 日間にコンバージョンがあり、完全一致キーワードがない用語をフィルタリングし、コンバージョンの降順で並べ替えます。表の下には、通常、AI がどの用語が高品質の意図 (ロングテール、ブランド、問題に焦点を当てたもの) のように見えるかを注釈付けし、それらを完全一致キーワードとして追加することを提案します。反対のクエリは — 「50ドル以上費やしてもコンバージョンがゼロで、予算を無駄にしている検索語句はどれですか?」 — は同じワークフローの否定キーワードの部分であり、AI は同じように処理します。
「今四半期における広告グループ別、デバイス別の顧客獲得単価はいくらですか?」
デバイスCPA
ピボット 広告グループ名 そして デバイス 費用(米ドル)、コンバージョン数、CPA(費用/コンバージョン数)が表示されます。AIツールは通常、キャンペーン平均から最も乖離しているデバイス別内訳(パフォーマンスマックスや部分一致キーワードグループではモバイルCPAの異常値がよく見られます)を強調表示し、フォローアップを提案します。 「最もパフォーマンスの低い広告グループについて、時間帯別に分析してみましょうか?」 Schema Intelligenceのenum検出 デバイス Google Ads が「Mobile」/「mobile」/「mobile_phones」の分割を生成しない場合、AI がそのような分割を生成しないことを保証します。 携帯, デスクトップ, 錠剤.

AIが初めてツールを呼び出す際、クライアントにツール呼び出しの承認を求める確認プロンプトが表示される場合があります。これはMCPの標準的な同意フローであり、Query Streamsが追加するものではありません。一度承認すれば、AIはその後の会話を自由に進めます。同意内容は、クライアントの設定でいつでも変更できます。

正直な料金請求に関するお知らせ:MCPの使用料金は非圧縮バイト数に基づいて課金されます

Query StreamsのExcelアドイン、Google Sheetsアドオン、Webクエリビルダー、Nova AIはすべて、当社の圧縮クラウドリンク上で動作します。当社は計測と課金を行っています。 圧縮バイト お客様のデータ領域に対して。MCPトランスポート(公式MCP仕様に基づくStreamable HTTP)は、すべてのクライアントと中間プロキシ間でエンドツーエンドの圧縮を確実にサポートするわけではないため、計測と課金を行います。 非圧縮バイト MCPトラフィックの場合。

  • これはどういう意味か: Google Ads の 2 MB 日次集計クエリ (キャンペーン + 広告グループ + 日別、90 日間、すべてのアカウント) は、MCP 経由で取得するとデータ領域を約 2 MB 消費しますが、Excel / Sheets / Nova / クエリ ビルダー経由で取得すると約 300~400 KB で済みます。Google Ads データは圧縮率が高く、キャンペーン名、ステータス列挙型、デバイス ラベルが行をまたいで繰り返されるため、クラウド リンク経由の LZ4 は、通常、他のトランスポートよりも 5~7 倍の削減を実現します。同じデータでも、トランスポートが異なると、課金対象サイズも異なります。
  • これは何ではないか: MCPを使用することに対する上乗せ料金やペナルティはありません。実際に送信されるバイト数はそのまま渡されます。他のクライアントの方が安価なのは、それらのトランスポートでは圧縮が確実に機能するからです。プロトコルの選択によってペナルティを課すことはありません。ただし、コスト構造については透明性を確保する必要があります。
  • あなたができること: 非常に大規模な定期的なエクスポート(例:複数年にわたるキャンペーン+キーワード+検索語句のクロス集計)の場合は、Excel/Sheets/Nova を使用することをお勧めします。インタラクティブな AI ツール呼び出し(LLM のコンテキストに適合する典型的な 100 ~ 5,000 行の Google 広告集計)の場合は、MCP が最適な選択肢であり、コスト差はわずか数セントです。

よくある質問

これを使うには、ポートを開放したり、VPNを実行したりする必要がありますか? +
いいえ、ネットワークエージェントは1つのアウトバウンドTLS接続(ポート443)をダイヤルし、AIクライアントは https://mcp.querystreams.com パブリックインターネットから発信されるため、エージェントホストで発信HTTPSが機能していれば、MCPは受信ルール、ポートフォワーディング、VPNなしで動作します。 発信専用接続の仕組みをご覧ください →
Query Streams MCPで使用できるAIツールはどれですか? +
オープンなモデルコンテキストプロトコルに対応したクライアントであればどれでも利用可能です。Claude Desktop、Claude Code、Cursor、ChatGPT(有料)、Grok、Gemini CLI、Windsurf、Zedなど、500種類以上が対応しています。ご自身のAIツールをお持ち込みください。切り替える必要はありません。 サポートされているAIクライアントの全リスト →
MCPキーを失効させることはできますか? +
はい、3 つの独立したキルスイッチ (キーごとに /mcp ページ、プラン設定による組織ごと、およびプラットフォームレベル)のいずれも、データベースのパスワードのローテーションやエージェントの再起動を必要としません。 MCPキーセキュリティに関する詳細はこちら →
MCPの使用料金は、私のデータ領域に対してどのように課金されますか? +
MCP の実行呼び出しは、Excel、Google スプレッドシート、Web クエリ ビルダー、および Nova AI の使用が既に利用しているのと同じデータ領域の予算から消費します。つまり、すべてのアクセス方法で共通の消費予算が使用されます。 MCPの測定サイズは異なる。 他のクライアントは、圧縮されたクラウドリンクを介して実行されます( 圧縮バイトMCPはStreamable HTTP上で動作しますが、すべてのクライアントとプロキシでエンドツーエンドの圧縮を確実にサポートするわけではないため、課金されます。 非圧縮バイトGoogle広告の2MBの日次集計データをExcelに返す場合、通常、データ領域は約300~400KBになります(キャンペーン名とステータス列挙が繰り返される広告データは、LZ4で5~7倍圧縮されます)。一方、同じ2MBのデータをMCP経由でCursorに返す場合、データ量は約2MBになります。請求期間の終わりに驚かれるよりも、事前に知っておいていただきたいので、この点については透明性を保っています。
Query Streams MCPは、私のGoogle広告MCC(マネージャー)アカウントと連携できますか?また、アカウント間のレポート機能はどうでしょうか? +
はい、ネットワークエージェントは、シングルアカウントのGoogle広告認証とMCC(マネージャー)認証の両方をサポートしています。MCCの場合、エージェントにマネージャーへのOAuthアクセスを一度付与するだけで、エージェントはアクセス可能なすべての子アカウントを個別のコネクタとして表示します(必要に応じて、単一の統合ビューとして表示することも可能です)。 クロスアカウントレポート エージェントの非正規化を介して動作します google_ads_performance テーブル: LLM は単一の SELECT を書き込むことができます WHERE customer_id IN (...) 複数の子アカウントにまたがって、統合された結果を 1 つ取得します。これは、Google Ads UI (アカウントを手動で切り替える必要がある) では面倒なワークフローであり、生の GAQL (顧客 ID ごと) では効率的に実行することは不可能です。エージェントは、内部で顧客ごとのファンアウトを実行し、アカウントごとの応答をキャッシュし、ユニオンを単一の SQL サーフェスとして公開します。 1 つの MCC + 子セットは、エージェント上の 1 つの OAuth グラントです。リフレッシュ トークンは自動的にサイクルします。代理店が複数の関連性のない MCC を管理している場合、各 MCC は個別のコネクタであり、LLM は名前で適切なコネクタを選択します。
これは、オープンソースのGoogle広告MCPサーバーを自分で運用する場合とどう違うのでしょうか? +
Google Ads MCP の直接サーバー (GitHub にはコミュニティ プロジェクトが存在し、ほとんどが薄い GAQL ラッパー) は、データ ソースごとに 1 つの MCP であり、そのほとんどは、生の REST または GAQL フィールドを LLM にダンプし、SQL サーフェスもメトリック セマンティクス レイヤーもありません。Claude が Google Ads + PostgreSQL + Stripe アカウント + Snowflake ウェアハウスから読み取るには、各 AI クライアントで個別に構成された 4 つの MCP サーバーが必要で、それぞれに独自の認証情報、スコープ モデル、監査ストーリーが必要です。Query Streams MCP は、アカウントがペアリングしたすべてのコネクタにアクセスできる 1 つのキーであり、エージェントは広告データをクリーンな SQL サーフェスに正規化します。 コストマイクロ セマンティックタイピングが組み込まれています。また、スキーマインテリジェンス、エージェントレイヤーの読み取り専用強制、キーごとのレート制限、監査証跡も取得できます。 イベントログそして、既に利用しているデータ領域の課金パイプラインもそのまま利用できます。これらは、直接的なMCPでは得られないものです。
AIがデータの書き込みや削除を試みるとどうなるでしょうか? +
キャッシュされた広告データがSQLを見る前に、エージェントで拒否されます。 qs_run_query 呼び出しは、ハードコードされた読み取り専用バリデーターによって解析され、 セレクト, , そして 説明する ステートメント。それ以外の場合は、 読み取り専用違反 そして、キャッシュされた Google Ads テーブルには決してアクセスしません。バリデーターはクラウドではなくエージェント プロセスで実行されるため、侵害されたクラウド サーフェスでもそれを迂回することはできません。さらに、もう 1 つの安全層があります。Google Ads の書き込み/変更操作 (キャンペーンの一時停止、入札額の変更、予算の調整) は、そもそも MCP サーフェスに公開されません。エージェントは、Google Ads API に対して読み取り専用の GAQL のみを発行します。したがって、バリデーターが何らかの方法で迂回されたとしても、LLM はアカウントを変更するために呼び出すものは何もありません。
AIが実際に何を質問したのか見せてもらえますか? +
はい。MCP ツール呼び出しごとに行が書き込まれます。 イベントログ 組織、ユーザー、キー、スコープ、レイテンシ、および結果コードとともに。組織管理者は、単一のクエリで「先週MCPを使用した人は誰か、どのコネクタを使用したか、そして何を質問したか?」に答えることができます。ログには、 ツール名とメタデータSQL テキストや返された行ではなく、それらはクラウド リンクを介して流れ、クラウド ログには記録されません。Google Ads API は、OAuth アプリが読み取り可能な変更履歴サーフェスをサードパーティの呼び出し元に公開しないため、Google Ads ではエージェントの イベントログ これは、「AIがいつ、どの子アカウントに対して、何を質問したか」を把握できる最も明確な監査方法です。その答えは、所有していない可能性のあるGoogle管理コンソールの背後に隠されているのではなく、あなた自身のデータベースにあります。
Query Streams MCPを使用するには、Schema Intelligenceを実行する必要がありますか? +
いいえ — SIはオプトインです (コネクタ、データベース) ペアリングされ、MCP はそれなしで動作します (AI はベア スキーマと si_推奨事項 ブロックし、会話の途中でSIを有効にすることができます qs_request_si_analysis);これをオンにすると、AI はキュレーションされたメタデータの 6 層を取得し、正しい Google Ads SQL を作成します。 cost_micros / 1000000 変換と キャンペーンステータス 列挙型フィルタリングは初回試行で成功します。6つのレイヤーと実行時の詳細については、上記の「スキーマインテリジェンスが追加する6つのレイヤー」で説明しています。 スキーマインテリジェンスがMCPサーバーを支える仕組み →
後からStripeやPostgreSQLなどの別のコネクタを追加したらどうなりますか? +
クライアント側では何も変更されません。エージェントがペアリングした瞬間に、同じキーが新しいコネクタに到達します(qs_list_connectors (自動的に取得されます)。1つの設定ブロックで、現在と将来のアカウント全体を購入できます。 なぜ1つのキーで全てのコネクタをカバーできるのか →
データとやり取りするためだけに、MCPをセットアップする必要があるのですか? +
いいえ - Nova AIはクエリストリームポータルに組み込まれています。 MCP の設定や構成ファイルは不要で、あらゆるコネクタ (Google 広告を含む) に対応します。クエリ ストリーム内のデータとやり取りするには Nova を使用し、独自の AI クライアント (Claude、Cursor、ChatGPT など) が同じデータ (同じエージェント、同じコネクタ、同じスキーマ インテリジェンス) にアクセスできるようにするには MCP を使用します。 Nova AI についてもっと詳しく知りたい方はこちら →

さあ始めましょう

わずか5分で、AIツールをGoogle広告データに接続できます。

1つのMCPキーで、Google広告、すべてのデータベース、Query Streamsアカウント内の他のすべてのAPIコネクタにアクセスできます。完全な監査証跡、キーごとのレート制限、MCC対応のアカウント間レポート機能、ファイアウォールの変更は一切不要です。Claude、Cursor、ChatGPT、Grokはすべてすぐに使用できます。

関連ガイド: クエリストリームエージェントをダウンロードしてください | APIコネクタのセットアップ | すべてのMCPサーバーガイド | Nova AI テキストからSQLへの変換

カテゴリ: MCPサーバー

タグ: mcp、claude、カーソル、Google広告、有料検索、PPC、マーケティング分析、APIコネクタ

メタディスクリプション:MCP経由でClaudeまたはCursorを使用してGoogle広告をクエリできます。キャッシュされたSQLインターフェース、MCCサポート、ファイアウォールの脆弱性なし。無料。

更新日 2026 年 6 月 16 日