これは、支払いデベロッパーにツールを提供する MCP サーバーです。
Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。
サーバーのセットアップ
使用する前に、MCP サーバーを有効にして、認証を設定する必要があります。Google と Google Cloud のリモート MCP サーバーの使用方法については、Google Cloud MCP サーバーの概要をご覧ください。
サーバー エンドポイント
MCP サービス エンドポイントは、安全で標準化された接続を確立するために AI アプリケーション（MCP クライアントのホスト）が使用する MCP サーバーのネットワーク アドレスと通信インターフェース（通常は URL）です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための接続ポイントとなります。Google MCP エンドポイントをグローバルまたはリージョンにすることができます。
Google Pay とウォレットのデベロッパー MCP サーバー API MCP サーバーには、次のグローバル MCP エンドポイントがあります。
- https://paydeveloper.googleapis.com/mcp
MCP ツール
MCP ツールは、現実世界でアクションを実行する目的で MCP サーバーが LLM または AI アプリケーションに対して公開する関数または実行可能な機能です。
ツール
paydeveloper.googleapis.com MCP サーバーには、次のツールがあります。
| MCP ツール | |
|---|---|
search_documentation |
Google Pay と Google ウォレットの公式デベロッパー向けドキュメントとコードサンプルから、最も関連性の高い最新のセクションを検索して取得します。 |
list_merchants |
認証済みアカウントに関連付けられているすべての Google Pay 加盟店の包括的なリストを取得します。販売者におけるユーザーの役割に応じて、管理者は販売者の詳細情報をすべて表示できますが、デベロッパーは販売者の基本情報のみを表示できます。 |
list_google_pay_integrations |
特定の販売者 ID に関連付けられているすべての Google Pay 統合の現在のステータスと構成の詳細を返します。統合とドキュメント レビューのステータスに関するフィードバックがすぐに提供されます。また、Google Pay & ウォレット コンソール（https://pay.google.com/business/console/)）で統合を作成 / 更新できることをユーザーに必ず通知しなければなりません。 |
create_merchant |
認証されたアカウントで新しい販売者を作成します。販売者を作成するために必要な情報をユーザーに提供するよう依頼しなければなりません。必須項目の 1 つは販売者カテゴリコード（MCC）です。MCC のリストは長いため、一般的なオプションのサブセットを表示しても構いませんが、より多くのオプションが利用可能であり、完全なリストをリクエストできることをユーザーに必ず知らせる必要があります（「X 個のオプションがさらにあります」などのヒントを表示するなど）。また、4 桁の MCC コード（5499 など）をすでに知っている場合は、直接入力できることをお客様に伝え、そのコードを使用するよう促します。販売者作成に必要な情報を収集するまで、このツールを呼び出さないでください。販売者が作成されたら、販売者に対して操作を行う前に、Business Console の利用規約の URL をユーザーに提示し、同意するよう指示しなければなりません。 |
list_pass_issuers |
認証されたユーザーに関連付けられている Google ウォレット ビジネス コンソールに登録されているすべてのパス発行者の包括的なリストを取得します。このツールは、ポイントカード、ギフトカード、フライトなどのウォレット パスを管理するデベロッパーにとって不可欠な情報を提供します。 |
list_pass_classes |
認証されたユーザーに関連付けられている Google ウォレット ビジネス コンソールに登録されているすべてのパスクラスの包括的なリストを取得します。このツールは、ポイントカード、ギフトカード、フライトなどのウォレット パスを管理するデベロッパーにとって不可欠な情報を提供します。 |
validate_pass_jwt |
パスの JWT 表現、またはパスの JSON 文字列としてのエンコードされていない JWT ペイロードを検証します。 |
query_merchant_performance |
特定の販売者のビジネス プロファイルについて、概要レベルの集計されたパフォーマンス データと統合後の指標を取得します。 |
query_merchant_error_metrics |
特定の販売者のビジネス プロフィールの詳細なエラー指標を取得します。このツールはエラーの詳細な内訳を提供するため、デベロッパーは問題を特定して解決できます。 |
update_merchant |
既存の販売者の特定のフィールドを更新します。サポートされているフィールドには、display_name、mcc、corporate_website_url、customer_support_website_url、customer_support_email、customer_support_phone があります。 |
list_principals |
特定の販売者にアクセスできるプリンシパル（ユーザー）を一覧表示します。このオペレーションには、販売者の管理者権限が必要です。 |
set_principal_role |
販売者に対するプリンシパル（ユーザー）のロールを設定するか、指定されたロールを持つ新しいプリンシパルを追加します。校長にメールで招待状が送信されます。アクセスを有効にするには、校長が招待状を承諾する必要があります。このオペレーションには、販売者の管理者権限が必要です。 |
delete_principal |
特定の販売者に対するプリンシパル（ユーザー）のアクセス権を削除します。このオペレーションには、販売者の管理者権限が必要です。 |
MCP ツールの仕様を取得する
MCP サーバー内のすべてのツールの MCP ツール仕様を取得するには、tools/list メソッドを使用します。次の例は、curl を使用して、MCP サーバー内で現在使用可能なすべてのツールとその仕様を一覧表示する方法を示しています。
| Curl リクエスト |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |