Merchant API MCP Access Service（アルファ版）

Merchant API Model Context Protocol（MCP）アクセス サービスを使用して、Merchant Center のデータと分析情報への承認済みアクセスを取得し、新しいエージェント エクスペリエンスと自動化されたワークフローを構築します。

概要

Merchant API MCP アクセス サービスは、LLM、エージェント、コーディング アシスタントが Merchant Center のデータに基づいて新しいエージェント エクスペリエンスと自動化されたワークフローを構築し、オーケストレートするための標準化された安全なブリッジを提供します。

具体的には、Merchant Center のデータと Google が生成したレポートや分析情報への承認済みアクセスを許可し、読み取り専用の限定的な書き込みオペレーションを実行して、次のようなユースケースに対応します。

• 不承認となった商品を診断して修正する
• パフォーマンス レポートと分析情報を生成する
• 自動改善の有効化を確認する
• データソースを作成して取得する

安全性とアクセス制御

Merchant API MCP Access Service は、セキュリティを最優先に設計されています。

• 認証: ツールの実行は Merchant API の標準認証に則って管理され、OAuth 2.0 またはサービス アカウントの認証情報が必要です。可能な限り制限の厳しいアクセス権を持つ認証情報を使用することをおすすめします。
• 実行の安全性: エージェントによる検出ではツールの可視性が制限されませんが、ツールの実行は特定の API 認証情報に制限されます。
• 保護機能: ツールは、安全ガードレールとして、読み取り専用オペレーションとリスクの低い書き込みツール（データソースの作成など）に厳しく制限されます。

重要な考慮事項

Merchant API MCP Access Service はアルファ版です。スコープと機能は拡張され、変更される可能性があります。

始める前に、次の制限事項とベスト プラクティスを確認してください。

変更とリリース

変更は予告なく行われることがあり、リリースノートに公開されます。

安全なテスト

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

共有割り当て

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

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

新しい機能（特に書き込みアクション）は今後追加される予定です。ツールセット全体を公開するのではなく、クライアントを明示的に構成して組み込みツール フィルタリングを行うことを強くおすすめします。

利用可能な機能の概要

Merchant API MCP Access Service を使用すると、次のアクションをエージェント方式で実行できます。

• 正確なリソース名を使用して、特定のプロダクトの詳細なステータスとレポートのコンテキストを取得します。
• 複数の商品を登録して検索します。
• クエリのパフォーマンス指標、商品のステータス、人気商品に関する分析情報、価格に関する分析情報、競合視認性、YouTube ショッピング アフィリエイト アナリティクス。
• 商品の表示やプログラムへの参加に影響するアカウント単位の問題を特定します。
• データソースのアップロード ステータスを一覧表示、作成、取得、確認します。
• 在庫全体で商品が不承認となった理由の集計リストを表示します。
• 商品、画像、送料の自動改善の設定を確認します。
• 特定の Merchant Center プログラムの有効な地域、満たされていない要件、参加状況を確認します。

スタートガイド

IDE、コーディング アシスタント、またはエージェントを Merchant API MCP Access Service に接続するには、MCP クライアント設定（mcp.json や settings.json など）を更新します。

クライアントの構成

構成設定:

{
    "mcpServers": {
        "merchant-api-access": {
            "serverUrl": "https://merchantapi.googleapis.com/mcp",
            "headers": {
                "Authorization": "Bearer {ACCESS_TOKEN}",
                "x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
            }
        }
    }
}

claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      }
    }
  }'

次のように置き換えます。

• ACCOUNT_ID: Merchant Center ID
• ACCESS_TOKEN: API 呼び出しを行うための認証トークン
• GOOGLE_CLOUD_PROJECT_ID: Merchant Center アカウントに関連付けられている Google Cloud プロジェクトの ID

使用シナリオの例

Merchant API MCP アクセス サービスを活用してエージェント エクスペリエンスと自動化されたワークフローを構築する方法を説明するため、次のシナリオを検討してください。

シナリオ 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 テーブルを作成します。

シナリオ 4: データソースを作成して取得する

商品更新をアップロードするために新しいデータソースを追加したい。

ユーザー プロンプト:

「販売者アカウント用に「price-updates」という名前の補助データソースを作成してください。」

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

1. エージェントは、指定された設定で create_data_source を呼び出して、新しいフィードを登録します。
2. MCP サーバーはデータソースを作成し、一意のリソース名を返します。
3. エージェントは fetch_data_source を呼び出して、関連付けられたファイルのダウンロードと処理をトリガーします。
4. エージェントは get_file_upload を呼び出して、アップロードの進行状況をモニタリングし、アイテムの処理が成功したステータスを確認します。

MCP ツールと説明

Merchant API MCP アクセス サービスは、次のツールをエージェントに公開します。