Google Ads を OpenAI Agents SDK に接続するには、https://mcp.paidsync.ai/mcp 向けの MCPServerStreamableHttp を作成し、Authorization ヘッダーに PaidSync.ai の API キーを入れて、Agent に渡します。これでエージェントは、Google Ads、Meta Ads、ほか 12 のプラットフォーム向けの PaidSync.ai ツールを呼び出せます。
Agents SDK に必要なもの
この SDK には、リモート MCP サーバーを使う方法が 二つあります。PaidSync.ai が対応するのは、コード側で接続を管理する方です。
- MCPServerStreamableHttp。URL とヘッダーは params に指定します。
- 環境変数に入れたPaidSync.ai の API キー。ドキュメントでは、URL よりも Authorization ヘッダーを使うことが推奨されています。
- Google Ads を接続した PaidSync.ai のログイン情報。
この SDK にはホスト型の MCP ツールもあり、OpenAI の Responses API が代わりに呼び出しを行います。ドキュメントには SDK が OAuth フローを実行する説明がないため、ここではヘッダーを使う方法になります。
接続のしくみ
| 設定 | 値 |
|---|---|
| クラス | MCPServerStreamableHttp |
| URL | https://mcp.paidsync.ai/mcp |
| ヘッダー | Authorization: Bearer、環境変数から取得 |
| 渡す先 | Agent(mcp_servers=[server]) |
| キーの制限 | Google Ads の読み取りとプレビュー |
Google Ads の変更を適用するには PaidSync.ai の OAuth サインインが必要で、キーでは行えません。SDK のツール承認設定を使えば、書き込み系のツールを人の確認待ちにできます。
Google Ads を OpenAI Agents SDK に接続する 5 ステップ
順番に進めてください。コードボックスには OpenAI Agents SDK MCP ドキュメントにある設定がそのまま入っています。
Google Ads を PaidSync.ai に接続する
paidsync.ai に登録し、Google 自身のサインイン画面で Google Ads を接続します。
API キーを作成する
ダッシュボードでキーを作成し、PAIDSYNC_API_KEY としてエクスポートします。
サーバーを作成する
下のスニペットを使います。非同期コンテキストマネージャーが接続を開き、閉じます。
Agent に渡す
Agent に mcp_servers=[server] を指定して、Runner.run を呼び出します。
ツール呼び出しを確認する
実行結果の出力を読み、PaidSync.ai のツールが使われたことを確認します。
PaidSync.ai を使う OpenAI Agents SDK
import asyncio, os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
async with MCPServerStreamableHttp(
name="PaidSync",
params={
"url": "https://mcp.paidsync.ai/mcp",
"headers": {"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
"timeout": 10,
},
cache_tools_list=True,
) as server:
agent = Agent(name="Ads analyst", mcp_servers=[server])
result = await Runner.run(agent, "List my Google Ads accounts.")
print(result.final_output)
asyncio.run(main())接続を確認する方法
まず読み取りだけのアカウント一覧から始め、次にムダな広告費のレポートへ進みます。
PaidSync.ai があなたを守る仕組み
- キーは URL に入れません。キーは環境変数から取り、ヘッダーで渡します。
- レポートは何も変更しません。ムダな支出とパフォーマンスのレポートは、アカウントを読み取るだけです。
- 変更にはサインインが必要。キーでは Google Ads の変更を適用できません。
- 変更ログ。適用された変更は、ベストエフォートで、変更前後の結果とともに記録されます。
セットアップは OpenAI Agents SDK のドキュメントに沿っています（2026年10月24日確認）。出典: OpenAI Agents SDK MCP docs。すべての Google Ads ツールは Google Ads MCP サーバー のページに、対応クライアントの一覧は 広告を接続する にあります。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
よくある質問
OpenAI Agents SDK は MCP に対応していますか？
はい。ホスト型の MCP ツールと、コード側で管理する Streamable HTTP サーバーの両方に対応しています。
PaidSync.ai にはどちらを使えばよいですか？
Bearer ヘッダーを付けた MCPServerStreamableHttp が、ドキュメントに載っている簡単な方法です。
エージェントは Google Ads アカウントを変更できますか？
キーでは、読み取りとプレビューができます。Google Ads の変更を適用するには、OAuth サインインが必要です。
Meta Ads でも使えますか。
はい。同じサーバーが Meta Ads のツールも提供しています。Meta Ads MCP サーバーのページをご覧ください。
料金はいくらですか?
PaidSync.ai は、月 100 タスク（$50 相当）まで無料で、カードは不要です。Pro は月額 $99 からです。料金をご覧ください。