Google Ads を Claude Agent SDK に接続するには、https://mcp.paidsync.ai/mcp 向けの http MCP サーバーを追加し、Authorization ヘッダーに PaidSync.ai の API キーを入れて、allowedTools にそのツールを列挙します。これでエージェントは、Google Ads、Meta Ads、そのほか 12 のプラットフォーム向けの PaidSync.ai ツールを呼び出せます。
Agent SDK に必要なもの
Agent SDK は、オプションで MCP サーバーを受け取ります。リモートサーバーには、次が必要です。
- mcpServers のエントリ。type は
http、URL、headers オブジェクトを指定します。 - allowedTools にツールを指定します。形式は
mcp__paidsync__tool_nameです。 - 環境変数に入れた PaidSync.ai の API キー。
SDK はブラウザを開いたり、対話型の OAuth フローを実行したりしないため、ヘッダーのトークンを使います。Anthropic のドキュメントによると、MCP ツールは allowedTools で明示的に許可する必要があります。
接続のしくみ
| 設定 | 値 |
|---|---|
| サーバーの種類 | http |
| URL | https://mcp.paidsync.ai/mcp |
| ヘッダー | Authorization: Bearer、環境変数から取得 |
| ツール名 | mcp__paidsync__ の後ろにツール名 |
| キーの制限 | Google Ads の読み取りとプレビュー |
Google Ads の変更を適用するには、PaidSync.ai の OAuth サインインが必要です。そのフローを自分のアプリで完了させれば、同じヘッダーでアクセストークンを送れます。
Google Ads を Claude Agent SDK に接続する 5 つのステップ
順番に進めてください。コードボックスには、Claude Agent SDK の MCP ドキュメントにある正確な設定が入っています。
Google Ads を PaidSync.ai に接続する
paidsync.ai に登録し、Google 自身のサインイン画面で Google Ads を接続します。
API キーを作成する
ダッシュボードでキーを作成し、PAIDSYNC_API_KEY としてエクスポートします。
サーバーを追加する
下のスニペットを、オプションとして渡します。
必要なものだけを許可する
mcp__paidsync__get_wasted_spend_report などの読み取りツールを、allowedTools に列挙します。
init メッセージを確認する
init メッセージの mcp_servers のリストを見て、paidsync が接続済みと表示されていることを確認します。
PaidSync.ai を使った Claude Agent SDK
import asyncio, os
from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage
options = ClaudeAgentOptions(
mcp_servers={
"paidsync": {
"type": "http",
"url": "https://mcp.paidsync.ai/mcp",
"headers": {"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
}
},
allowed_tools=["mcp__paidsync__get_wasted_spend_report"],
)
async def main():
async for message in query(prompt="Run get_wasted_spend_report for the last 30 days.", options=options):
if isinstance(message, ResultMessage) and message.subtype == "success":
print(message.result)
asyncio.run(main())接続を確認する方法
まず init メッセージを読みます。paidsync のステータスが connected なら、キーは有効です。
PaidSync.ai があなたを守る仕組み
- 明示的な許可。allowedTools にあるツールだけが、確認なしで実行されます。
- レポートは何も変更しません。ムダな支出とパフォーマンスのレポートは、アカウントを読み取るだけです。
- 変更にはサインインが必要。キーでは Google Ads の変更を適用できません。
- 変更ログ。適用された変更は、ベストエフォートで、変更前後の結果とともに記録されます。
セットアップは Anthropic の Agent SDK ドキュメントに従っており、2026 年 十月 24 日に確認しました。出典は Claude Agent SDK MCP ドキュメントです。Google Ads のすべてのツールは Google Ads MCP サーバーのページに、対応クライアントの一覧は広告を接続するのページにあります。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
よくある質問
Claude Agent SDK はリモート MCP サーバーに対応していますか。
はい。Anthropic のドキュメントでは、Python と TypeScript で、ヘッダー付きの http サーバーと sse サーバーが説明されています。
OAuth ではなくキーを使うのはなぜですか。
Anthropic のドキュメントによると、SDK は対話型の OAuth フローを実行しません。トークンをヘッダーで渡してください。
allowedTools では PaidSync.ai のツールをどう指定しますか。
mcp__paidsync__ の後ろにツール名を付けるか、すべてを指定する場合は mcp__paidsync__* を使います。
Meta Ads でも使えますか。
はい。同じサーバーが Meta Ads のツールも提供しています。Meta Ads MCP サーバーのページをご覧ください。
料金はいくらですか?
PaidSync.ai は、月 100 タスク（$50 相当）まで無料で、カードは不要です。Pro は月額 $99 からです。料金をご覧ください。