販売者データ MCP サーバー（公開アルファ版）

選択したコーディング アシスタントから Merchant Center アカウントに関するライブデータを直接取得します。統合開発環境（IDE）またはカスタム エージェント フレームワーク内で、Model Context Protocol（MCP）サービスを使用して Merchant Center データにアクセスし、管理できるようになりました。 このサービスにより、コーディング アシスタントまたはエージェントは Merchant Center データに対して読み取り専用の安全な書き込みオペレーションを実行できるため、信頼できるライブ コンテキストを使用して問題の診断、プログラムの確認、レポートのクエリを行うことができます。

プロトコル自体の詳細については、Model Context Protocol 標準をご覧ください。

セキュリティとアクセス制御

Merchant Data MCP サーバーは、セキュリティを最優先に設計されています。

  • 認証: ツールの実行は、標準の Merchant API 認証に則って厳密に管理され、 OAuth 2.0 またはサービス アカウントの認証情報が必要です。
  • 実行の安全性: エージェントに対してツール スキーマの可視性が広いにもかかわらず、ツールの実際の実行は高度に保護されており、特定の API 認証情報によって厳しく制限されています。

重要な考慮事項

これらのツールを使用する前に、次のおすすめの方法と制限事項をご確認ください。

変更とリリース

変更についてはリリースノートに掲載しますが、非推奨期間なしで直ちに適用される可能性があります。

安全なテスト

本番環境でこれらのツールを使用する前に、 テスト アカウントまたは非ライブ アカウントを使用して最初に試すことをおすすめします。

共有割り当て

MCP サーバーは、標準の Merchant API 呼び出しと同じ割り当てプールを共有します。エージェントを実行すると、特にデータソースの取得で割り当てがすぐに使い果たされる可能性があります。本番環境でのサービスの中断を防ぐため、テスト アカウントを使用することを強くおすすめします。

ツールのフィルタリングと安全性

Google は今後、この MCP サーバーに新しいツール（書き込み機能を含む）を追加する可能性があります。AI エージェントが自動的 かつ意図せずに新しいツールやリスクの高いツールを実行しないようにするには、ツールセット全体を公開するのではなく、組み込みのツール フィルタリング を使用するようにクライアントを明示的に構成することを強くおすすめします。

範囲と制限事項

  • 読み取り専用に重点を置く: この初期フェーズの安全ガードレールとして、 ツールは読み取り専用オペレーションとリスクの低い書き込み ツール（データソースの作成など）に厳しく制限されています。

使用可能な機能

Merchant Data MCP サーバーを使用すると、エージェントを使用して次の操作を行うことができます。

  • 正確なリソース名を使用して、特定の商品に関する詳細なステータスとレポートのコンテキストを取得 します。
  • 複数の商品を一覧表示して検索 します。
  • 検索レポートを通じて、パフォーマンス データ、商品のステータス、料金の検討をクエリ します。
  • データソースのアップロード ステータスを一覧表示、作成、取得、確認 します。
  • 商品の表示やプログラムへの参加に影響するアカウント単位の問題を特定 します。
  • 在庫全体で商品が不承認になった理由をまとめて一覧表示 します。
  • 特定の Merchant Center プログラムの有効な地域、満たされていない要件、参加状況を確認 します。
  • 商品、画像、配送の自動改善の設定を確認 します。

設定

IDE またはコーディング アシスタントを Merchant Data MCP サーバーに接続するには、MCP クライアントの設定を更新します。たとえば、Claude Desktop、Antigravity、Visual Studio Code、またはカスタム エージェント フレームワークの mcp.json ファイルを更新します。

ローカル MCP サーバーの設定にはサービス アカウントが必要 です。このヘッドレス ローカル実行では、標準ユーザーの OAuth はサポートされていません 。サービス アカウントを作成し、その JSON 秘密鍵ファイルをダウンロードして、特定の Merchant Center ID とともに引数としてパスを指定する必要があります。

サービス アカウントを作成してダウンロードする方法について詳しくは、 サービス アカウント ガイドをご覧ください。

クライアントの構成

構成の設定:

Antigravity

Antigravity のドキュメントの手順に沿って操作します。

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

Claude Desktop

Claude Desktop のドキュメントの手順に沿って操作します。

{
    "mcpServers": {
        "merchant-data-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google/merchant-data-mcp",
                "--credentials",
                "/path/to/your/service-account-file.json"
            ]
        }
    }
}

使用シナリオの例

Merchant Data MCP サーバーを使用すると、エージェントは Merchant Center のライブデータとやり取りできます。一般的なシナリオをいくつかご紹介します。

シナリオ 1: 商品の不承認を診断する

特定の商品が Google 検索結果に表示されない理由を把握したいと考えています。

ユーザーによるプロンプト:

「オファー ID 'offer123' の商品が不承認になったのはなぜですか？」

MCP を使用したエージェントの動作:

  1. エージェントが list_products または get_product_by_name を呼び出して、商品のステータスを確認します。
  2. MCP サーバーは、issues のリスト（「価格形式が正しくありません」や「配送の値がありません」など）を含む商品のステータスを返します。
  3. エージェントが問題を分析し、根本原因を説明して、解決方法（価格情報の更新など）を提案します。

シナリオ 2: 自動改善を確認する

配送日数の自動改善が有効になっているかどうかを確認したいと考えています。

ユーザーによるプロンプト:

「配送日数の自動改善は有効になっていますか？」

MCP を使用したエージェントの動作:

  1. エージェントが get_automatic_improvements を呼び出して、アカウント単位の設定を取得します。
  2. MCP サーバーは、画像、商品アイテム、配送の改善のステータスを示す構成を返します。
  3. エージェントは、配送の改善が有効になっていることを確認するか、無効になっている場合は有効にする方法を説明します。

シナリオ 3: パフォーマンス指標をクエリする

Merchant Center の UI を操作せずに、最近のパフォーマンスをすばやく確認したいと考えています。

ユーザーによるプロンプト:

「先週のクリック数で上位 5 件の商品を表示してください。」

MCP を使用したエージェントの動作:

  1. エージェントは、product_performance_view テーブルをターゲットとし、clicks DESC で並べ替え、5 に制限する Merchant Center Query Language（MCQL）クエリを作成します。
  2. エージェントは、作成したクエリを使用して report_search を呼び出します。
  3. MCP サーバーは、ライブ レポート データベースに対してクエリを実行し、行を返します。
  4. エージェントは、結果をわかりやすい Markdown テーブルにフォーマットします。

使用可能なツールの詳細なリスト

MCP サーバーは、次のツールをエージェントに公開します。

MCP ツール 説明
get_product_by_name 正確な商品リソース名を使用して、特定の販売者の商品情報を取得します。レポートのコンテキストと商品単位で発生する可能性のある問題を含む、商品の詳細なステータスを返します。
list_products 特定の販売者の複数の商品を一覧表示または検索します。レポートのコンテキストと商品単位で発生する可能性のある問題を含む、商品の詳細なステータスを返します。
report_search レポート テーブルをクエリして、パフォーマンス指標、商品のステータス、料金の検討を取得します。詳しくは、レポートに関するガイドをご覧ください。
list_data_sources 特定の販売者のデータソースを一覧表示します。
get_data_source 特定のデータソースの詳細を取得します。
create_data_source 特定の販売者のデータソースを作成します。
fetch_data_source 特定の販売者のデータソースに関連付けられているファイルを取得して処理します。
get_file_upload 特定のデータソースの最新のファイル アップロードのステータスを取得します。
list_accounts 特定のユーザーのアカウントを一覧表示します。
list_account_issues 特定のアカウント単位の問題を一覧表示して、アカウント全体の問題を特定します。
list_programs 特定の販売者のプログラムを一覧表示します。参加状況、有効な地域、満たされていない要件などが表示されます。
list_aggregated_product_issues 商品単位で発生する問題をまとめて一覧表示して、商品データの全体的な健全性をモニタリングします。
get_automatic_improvements 商品アイテムの更新、画像の改善、配送の改善など、自動改善の設定を取得します。