Google Merchant Center MCP

English | Русский

A1 Google Merchant Center MCP は、AI アプリを Google Merchant Center アカウントに接続します。商品が不承認になる理由を調べ、フィードやプロモーションを確認し、レポートや市場価格を調べ、必要に応じて商品データを意図的に変更できます。

このサーバーは、ショッピングの掲載情報の背後にある Merchant Center データ（商品、データソース、プロモーション、レポート）を扱います。キャンペーン、予算、入札は Google Ads に属するため、このサーバーの対象外です。

• 22 のツール。 15 の操作は Merchant Center データの読み取りのみを行い、5 つは商品・データソース・プロモーションのデータを書き込み、2 つは破壊的な可能性があります。

• あなたの Google アクセス。 サーバーは OAuth 認証情報と Merchant API v1 を使用します。別の Merchant Center アカウントを作成することはありません。

• ソースを考慮した変更。 商品とプロモーションの入力は、API データソース経由でのみ変更できます。ファイルフィードは再取得できますが、その内容はここでは編集されません。

• 明確な境界。 各ツールは読み取り専用・書き込み・破壊的のいずれかのメタデータを保持するため、AI クライアントは調査と実際の変更を区別できます。

まずは読み取り専用の質問から始めましょう：

どの商品が不承認で、それぞれについて Google はどのような問題を報告していますか？

サーバーに接続する · ユースケースを確認する · 技術ドキュメントを開く

1分で動作を確認する

あなた: どの商品が不承認で、それぞれについて Google はどのような問題を報告していますか？

アシスタント: 影響を受ける商品を一覧表示し、Merchant Center が報告する商品レベルの問題を説明します。

あなた: 商品 SKU-123 の現在の価格と在庫状況を表示して、in_stock への在庫状況の更新を準備してください。

アシスタント: 現在の商品入力、それが属する API データソース、そして行う正確な変更を表示します。実際の商品入力を更新する前に確認を求めます。

あなた: 更新を確認します。

アシスタント: 更新を送信し、Merchant Center が商品データを非同期に処理することを説明します。処理された商品とその品質ステータスが更新されるまで数分かかることがあります。

Related MCP server: gmc-mcp

目次

• クイックスタート

• できること

• Merchant Center データの接続方法

• 変更できるもの

• アクセスの取得

• 設定

• データとテレメトリー

• 制限とバックグラウンド処理

• 技術ドキュメント

• サポート

クイックスタート

Node.js 20+、Google Merchant Center アカウント、Google Cloud の OAuth 認証情報、そして Merchant Center に登録済みの Google Cloud プロジェクトが必要です。アクセス設定はアクセスの取得で説明しています。

1. OAuth クライアント ID、OAuth クライアントシークレット、OAuth リフレッシュトークン、Merchant Center アカウント ID の 4 つの値を準備します。

2. 以下のいずれかの手順に従って、サーバーを AI アプリに追加します。

3. 上記の最初の読み取り専用の質問をします。

アプリの場合：

1. Settings → Plugins → MCP servers を開きます。

2. Add server を選択します。

3. 起動コマンド npx -y mcp-google-merchants@latest と、以下の 4 つの環境変数を追加します。

コマンドラインから：

codex mcp add google-merchants \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  -- npx -y mcp-google-merchants@latest

接続を確認します：

codex mcp list

Codex MCP ドキュメント

claude mcp add \
  --env GOOGLE_MERCHANTS_CLIENT_ID=your_client_id \
  --env GOOGLE_MERCHANTS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_MERCHANTS_REFRESH_TOKEN=your_refresh_token \
  --env GOOGLE_MERCHANTS_ACCOUNT_ID=your_merchant_id \
  --transport stdio \
  --scope user \
  google-merchants \
  -- npx -y mcp-google-merchants@latest

接続を確認します：

claude mcp list

Claude Code MCP ドキュメント

1. Claude Desktop を開き、Settings → Developer に移動します。

2. Edit Config を選択します。

3. サーバーを mcpServers に追加します：

{
  "mcpServers": {
    "google-merchants": {
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Edit Config が利用できない場合は、設定ファイルを直接開いてください：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop MCP ドキュメント

macOS/Linux では ~/.cursor/mcp.json、Windows では %USERPROFILE%\.cursor\mcp.json にユーザーレベルのサーバーを追加します：

{
  "mcpServers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "your_client_id",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "your_refresh_token",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "your_merchant_id"
      }
    }
  }
}

Cursor MCP ドキュメント

コマンドパレットから MCP: Open User Configuration を実行して追加します：

{
  "servers": {
    "google-merchants": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-merchants@latest"],
      "env": {
        "GOOGLE_MERCHANTS_CLIENT_ID": "${input:google_merchants_client_id}",
        "GOOGLE_MERCHANTS_CLIENT_SECRET": "${input:google_merchants_client_secret}",
        "GOOGLE_MERCHANTS_REFRESH_TOKEN": "${input:google_merchants_refresh_token}",
        "GOOGLE_MERCHANTS_ACCOUNT_ID": "${input:google_merchants_account_id}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "google_merchants_client_id",
      "description": "Google OAuth client ID"
    },
    {
      "type": "promptString",
      "id": "google_merchants_client_secret",
      "description": "Google OAuth client secret",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_refresh_token",
      "description": "Google OAuth refresh token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google_merchants_account_id",
      "description": "Merchant Center account ID"
    }
  ]
}

MCP: List Servers でサーバーを確認します。

VS Code MCP ドキュメント

できること

カタログの問題を発見して理解する

• どの商品が不承認で、それぞれについて Google は何を報告していますか？

• 商品 SKU-123 のタイトル、価格、在庫状況、現在のステータスを表示してください。

• 在庫切れの商品はどれですか？

• この Merchant Center アカウントで最も頻度の高い商品の問題を表示してください。

パフォーマンスと価格を調べる

• 7月の商品別クリック数とインプレッション数を表示してください。

• 米国で市場ベンチマークより高い価格の商品はどれですか？

• Google が提案する価格と、予測される影響は何ですか？

価格比較と提案には、Merchant Center での無料の Market Insights へのオプトインが必要です。アカウントがオプトインしていない場合、サーバーはレポートに行がない理由を説明します。

アカウントとフィードを確認する

• アクセスできる Merchant Center アカウントを一覧表示してください。

• ストアのホームページはクレームされていますか？現在の配送設定を表示してください。

• 商品とプロモーションのデータソースを一覧表示し、API データソースを特定してください。

• このスケジュールされたファイルフィードを今すぐ再取得してください。

意図的な変更を行う

• この商品の価格と在庫状況を、その API データソース内で更新してください。

• 新しい商品フィード用の API データソースを作成してください。

• プロモーションを作成または更新し、その後承認状況を確認してください。

データを変更するリクエストについては、まずアシスタントに、対象アカウント、データソース、変更予定の正確なフィールドを表示するよう依頼してください。

Merchant Center データの接続方法

Merchant Center は、受け取ったデータと、その結果生成される商品ステータスを分けて管理します。

1. アカウントには、商品とプロモーションのデータソースが含まれます。

2. データソースには、API ソース、ファイル、Google Sheet、Merchant Center インターフェース、または自動フィードがあります。

3. 商品入力は、1 つのソースから提供された商品データです。

4. 処理済み商品は、Merchant Center がその入力を処理した後に導出するものです。対象適格性と商品レベルの問題が含まれます。

サーバーは、一覧にあるすべてのソースタイプを読み取れます。API データソースを作成し、商品入力を更新できるのは API データソース内のみです。ファイル、インターフェース、自動フィードに書き込むことはできません。条件による商品の検索にはレポートクエリを使用してください。list_products 自体はサーバーサイドのフィルタリングを提供しません。

変更できるもの

MCP クライアントは、書き込みツールと破壊的ツールの確認方法を決定します。サーバーは読み取り専用・書き込み・破壊的の各操作をマークするため、クライアントは適切な境界を提示できます。

アクセスの取得

サーバーは Google Merchant API と OAuth スコープ https://www.googleapis.com/auth/content を使用します。

1. Google Cloud プロジェクトを作成または選択し、Merchant API を有効にして、OAuth 同意画面を設定します。

2. Google Cloud で、タイプ Desktop app の OAuth クライアントを作成します。そのクライアント ID とクライアントシークレットを保存します。

3. Merchant Center にアクセスできる Google アカウントを承認し、上記のスコープのリフレッシュトークンを取得します。OAuth 2.0 Playground がこの手順で役立ちます。Use your own OAuth credentials を有効にし、スコープを入力して承認し、コードをトークンと交換します。

4. Merchant Center で自分の Merchant Center アカウント ID を見つけ、GOOGLE_MERCHANTS_ACCOUNT_ID として使用します。

5. Google Cloud プロジェクトを Merchant Center に一度登録します。この操作には、Google は確認済みのウェブサイトとアカウント管理者を持つ本番用 Merchant Center アカウントを必要とします。登録により、1 つの Cloud プロジェクトが Merchant Center アカウントにリンクされます。完了するまで、そのプロジェクトからの Merchant API 呼び出しはブロックされます。Google のデベロッパー登録ガイドに従ってください。

一度限りの登録は、技術用の raw_request ツールからも実行できますが、初めて Merchant API を設定する場合は Google のガイドに従う方が安全です。登録後、Google が呼び出しを受け付けるまで最大 5 分かかることがあります。

OAuthクライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。これらはMCPクライアント設定に保存され、Merchant Centerアカウントへのアクセス権を付与できます。

構成

* クライアントID、クライアントシークレット、リフレッシュトークンをまとめて使用するか、事前に発行されたアクセストークンを使用します。アクセストークンは通常約1時間で失効します。リフレッシュトークンを使用すると、サーバーは必要に応じて新しいアクセストークンを取得できます。

データとテレメトリー

サーバーは、AIアプリによって起動されるプロセスとしてローカルで実行されます。Merchant CenterへのリクエストをGoogleに送信し、GoogleのOAuthエンドポイントを通じてOAuthアクセストークンを更新します。

アクティブなインストール数とツールの需要をカウントするために、匿名の使用テレメトリーを送信します。ランダムなインストールID、パッケージバージョン、AIクライアントとNode.js/オペレーティングシステムのバージョン、およびツール名が含まれます。OAuthトークン、Merchant Centerデータ、ツール引数、プロンプトを送信または保存することはありません。A1 MCPサーバーでは、このテレメトリーを次の方法で無効にできます：

ASKADS_TELEMETRY=0

制限とバックグラウンド処理

• Merchant Centerの処理は非同期です。 新しく挿入、更新、削除された商品インプットが処理済みの商品に反映されるまでに数分かかる場合があります。商品とプロモーションの承認に関する問題は、即時のAPIエラーとしてではなく、後から表示されます。

• Market Insightsはオプションです。 価格競争力レポートと推奨価格レポートは、アカウントが無料のMarket Insightsプログラムにオプトインした後にのみデータを返します。

• クォータはアカウントとAPIメソッドによって異なります。 現在の消費量は list_method_quotas で確認できます。Googleの日次カウンターは12:00 UTCにリセットされます。

• 一時的な制限は慎重に処理されます。 Googleが 429 を返した場合、サーバーは Retry-After が提供されていればそれに従い、限られた回数の再試行を行います。ネットワークまたはサーバーの障害が不明確な場合、書き込みを再送信しません。

• バックグラウンド監視はありません。 サーバーはAIアプリが呼び出している間のみ動作します。AIアプリがスケジュールされたタスクをサポートしている場合、商品の問題やクォータの使用状況を定期的に確認するよう依頼できます。

• 集約された商品の問題にはアカウントの制限があります。 list_product_issues はスタンドアロンアカウントとサブアカウントで機能しますが、高度な親アカウントでは機能しません。

技術ドキュメント

• MCP機能カタログ — すべてのツールのタスク指向ページ。

• すべてのツールとその入力

• 開発ドキュメント

• 公開ドキュメント

• Google Merchant API 概要

• Google Merchant API 認証

• Googleデベロッパー登録

サポート

バグを発見した場合やシナリオが必要な場合は、Issueを作成 するか、Telegram までご連絡ください。