Claude Code
Merchant Center を Claude Code に接続するには、PaidSync.ai を追加します。claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp と入力して、PaidSync のログイン情報でサインインします。
すると Claude Code は、16 個のツールで Merchant Center アカウントにアクセスできます。商品の問題、アカウントの状態、商品の成果、データソースに加え、商品、補足フィード、Google Ads のリンクの変更が可能です。Claude Code は各ツールを実行する前に確認します。
設定階層。Merchant Center への書き込みにはドライランがなく、最初の呼び出しで適用されるため、書き込みツールでは Claude Code のプロンプトをオンにしておいてください。
コマンド
Claude Code は Streamable HTTP でリモート MCP サーバーと通信します。PaidSync はその 一つです。一度追加すれば、コードを編集するのと同じターミナルから、Merchant Center キャンペーンのレポートと管理ができます。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpデフォルトでは、現在のプロジェクトにのみサーバーを登録します。--scope user を追加すると、お使いのマシン上のすべてのプロジェクトで利用できます。
claude mcp list を実行して登録を確認し、セッションを開始して /mcp と入力してサインインします。
5 ステップのセットアップ
1paidsync.ai/signup で登録
所要時間は 10 秒。Google またはメールでサインインします。無料プランは月 100 タスク、$50 相当で $0、カード不要です。
2PaidSync ダッシュボードで Merchant Center を接続する
Merchant Center の 接続 をクリックし、Merchant Center へのアクセス権を持つ Google アカウントでサインインします。Merchant Center は content スコープの Google OAuth で認可され、PaidSync があなたの Google パスワードを見ることはありません。
すでに Claude Code の中にいますか。connect_merchant_center の実行を依頼してください。ブラウザで開くリンクがツールから返ります。
3Claude Code が作業する広告アカウントを選択
セッション内では、list_merchant_accounts が Google ログインで開けるアカウントを（マルチクライアントアカウント配下のサブアカウントを含めて）表示し、set_active_merchant_account が Claude Code で作業するアカウントを選びます。
4PaidSync を Claude Code に追加する
ターミナルで次を実行します。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpセッションを開始して /mcp と入力し、paidsync を選んで、開いたブラウザウィンドウで PaidSync のログインでサインインします。OAuth トークンは Claude Code が保存します。キーはどこにも貼り付けません。
チームで設定しますか？リポジトリのルートに .mcp.json をコミットすれば、エンジニア全員が同じコネクタを使えます。
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}ヘッドレス実行などで API キーを使いたいですか？ログに残ってしまう URL ではなく、ヘッダーで送ってください。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"コミットする .mcp.json には "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } を追加すると、キーは各エンジニアの環境に残り、git には入りません。Google Ads の変更の適用には、引き続き OAuth サインインが必要です。ほかのプラットフォームではキーでも変更を適用できるため、パスワードと同じように扱い、OAuth を優先してください。
5接続をテスト
Claude Code のセッションで次のように尋ねます。“私の Merchant Center で不承認の原因が最も多い問題は何ですか”
Claude Code が、各問題のコード、重大度、配信先、国、影響を受ける商品数、Google の修正手順を返します。接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code の Merchant Center 例
以下の各プロンプトは、PaidSync の Merchant Center グループのツールに対応します。ツールは Claude Code が選びます。最後の列は、その呼び出しが広告アカウントの何かを変更できるかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “Merchant Center アカウントを一覧表示して、Acme をアクティブにして” | list_merchant_accounts, set_active_merchant_account | なし |
| “不承認の原因が最も多い問題は何ですか。それぞれどう修正すればよいですか” | list_product_issues | なし |
| “私の Merchant Center アカウントにリスクはありますか” | get_merchant_account_status | なし |
| “私の Merchant Center にリンクされている Google Ads アカウントをすべて一覧表示して” | merchant_list_links | なし |
| “過去 28 日間でインプレッションはあったのにクリックがなかった商品はどれですか” | get_product_performance | なし |
| “在庫切れになっている商品を価格つきで一覧表示して” | list_products | なし |
| “英語の米国向け商品用に、Holiday Sale Prices という補足フィードを作成して” | merchant_create_supplemental_feed | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull the Merchant Center product issues and write a list of the issues that disapprove the most products." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/merchant-center-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
16 個の Merchant Center ツールのうち、9 個は読み取り専用で、5 個は書き込みができます。読み取りの対象は、アカウント、商品の問題、アカウントの状態、商品、商品の成果、リンク、データソースです。
書き込みの対象は、商品、補足フィード、Google Ads のリンクです。Merchant Center への書き込みにはドライランがなく、最初の呼び出しで適用され、商品とリンクの削除に確認フラグも不要です。
続きを読む
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
Claude Code が Merchant Center でできないこと
- Merchant Center の変更はプレビューなしで最初の呼び出しで適用されるため、書き込みツールでは Claude Code のプロンプトをオンにしておいてください。
- アカウントへの最初のリクエストで PaidSync がそのアカウントに登録されます。これには管理者アクセスが必要で、反映まで約 5 分かかります。
- Merchant Center のレポートは 一日から二日遅れで反映されます。
- 商品の成果は、一回のリクエストで最大 1,000 商品が対象です。
- PaidSync は、接続した Google ログインで開けるアカウントだけを一覧表示します。
よくある質問
Merchant Center を Claude Code に接続するにはどうすればよいですか。
paidsync.ai に登録し、ダッシュボードで Merchant Center を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで、PaidSync のログインでサインインしてください。
Claude Code は商品の不承認を修正できますか。
Claude Code は、すべての不承認を理由と修正手順つきで一覧にできます。属性の修正には、PaidSync が商品を更新でき、Claude Code は各書き込みツールを実行する前に確認します。
PaidSync は Google Ads も Claude Code に接続しますか。
はい。PaidSync は Merchant Center と Google Ads の両方を同じツールセットで接続するため、Claude Code は 一回のセッションでフィードの状態とショッピングキャンペーンの費用を比較できます。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
Merchant Center のレポートとフィードの変更を、Claude Code の 一つのコマンドで。