Google Ads を Agent Development Kit に接続するには、https://mcp.paidsync.ai/mcp を指す StreamableHTTPConnectionParams を使った McpToolset を追加し、Authorization ヘッダーに PaidSync.ai の API キーを入れて送ります。これで ADK エージェントは、Google Ads、Meta Ads、そのほか 12 のプラットフォーム向けの PaidSync.ai ツールを呼び出せます。
ADK に必要なもの
ADK のエージェントは McpToolset を使って MCP サーバーに接続します。PaidSync.ai には次のものが必要です。
- McpToolset に、StreamableHTTPConnectionParams と PaidSync.ai の URL を設定します。
- PaidSync.ai の API キー。ダッシュボードで作成し、環境変数に保存します。
- Google Ads を接続した PaidSync.ai のログイン情報。
ADK のドキュメントでは接続パラメータにヘッダーを指定する例が示されており、McpToolset は auth_scheme と auth_credential を通じて OAuth 2.0 のトークン更新も管理できるとされています。
接続のしくみ
| 設定 | 値 |
|---|---|
| クラス | McpToolset |
| 接続 | StreamableHTTPConnectionParams |
| URL | https://mcp.paidsync.ai/mcp |
| ヘッダー | Authorization: Bearer、環境変数から取得 |
| キーの制限 | Google Ads の読み取りとプレビュー |
Google Ads の変更を適用するには PaidSync.ai の OAuth サインインが必要で、キーでは行えません。キーはレポート用のエージェントに使い、変更には人が関わる形にしてください。
Google Ads を Google ADK に接続する 5 ステップ
順番に進めてください。コードボックスには Google ADK MCP ツールのドキュメントにある設定がそのまま入っています。
Google Ads を PaidSync.ai に接続する
paidsync.ai に登録し、Google 自身のサインイン画面で Google Ads を接続します。
API キーを作成する
ダッシュボードでキーを作成し、PAIDSYNC_API_KEY としてエクスポートします。URL には絶対に入れないでください。
ツールセットを追加する
下のボックスの McpToolset を LlmAgent の tools に追加します。
エージェントを実行する
adk run またはウェブ UI でエージェントを起動し、アカウントについて質問します。
ツール呼び出しを確認する
イベントログで PaidSync.ai のツールが実行されたことを確認します。
PaidSync.ai を使う ADK エージェント
import os
from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
root_agent = LlmAgent(
model="gemini-flash-latest",
name="ads_analyst",
instruction="Answer questions about the user's ad accounts with PaidSync tools.",
tools=[McpToolset(connection_params=StreamableHTTPConnectionParams(
url="https://mcp.paidsync.ai/mcp",
headers={"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
))],
)接続を確認する方法
まずアカウント一覧のような読み取りだけの質問から始め、イベントログでツール呼び出しを確認します。
PaidSync.ai があなたを守る仕組み
- キーは URL に入れません。キーは環境変数から取り、ヘッダーで渡します。
- レポートは何も変更しません。ムダな支出とパフォーマンスのレポートは、アカウントを読み取るだけです。
- 変更にはサインインが必要。キーでは Google Ads の変更を適用できません。
- 変更ログ。適用された変更は、ベストエフォートで、変更前後の結果とともに記録されます。
セットアップは Google の ADK ドキュメントに沿っています（2026年10月24日確認）。出典: Google ADK MCP tools docs。すべての Google Ads ツールは Google Ads MCP サーバー のページに、対応クライアントの一覧は 広告を接続する にあります。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
よくある質問
Google ADK のエージェントは MCP サーバーを使えますか。
はい。ADK の McpToolset は、Streamable HTTP を通じてエージェントをリモート MCP サーバーに接続します。
ADK で PaidSync.ai に OAuth は必要ですか。
レポートには必要ありません。API キーを入れた Bearer ヘッダーで動作します。ADK は、auth_scheme による OAuth のサポートも文書化しています。
ADK エージェントは Google Ads アカウントを変更できますか。
キーでは、読み取りとプレビューができます。Google Ads の変更を適用するには、OAuth サインインが必要です。
Meta Ads でも使えますか。
はい。同じサーバーが Meta Ads のツールも提供しています。Meta Ads MCP サーバーのページをご覧ください。
料金はいくらですか?
PaidSync.ai は、月 100 タスク（$50 相当）まで無料で、カードは不要です。Pro は月額 $99 からです。料金をご覧ください。