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 と Google ウォレットのデベロッパー 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 インテグレーションの現在のステータスと構成の詳細を返します。インテグレーションとドキュメントの審査のステータスに関するフィードバックが即座に提供されます。 |
create_merchant |
認証済みアカウントで新しい販売者を作成します。販売者の作成に必要な情報の提供をユーザーに依頼する必要があります。販売者の作成に必要な情報を収集するまで、このツールを呼び出さないでください。販売者が作成されたら、Business Console の利用規約の URL をユーザーに提示し、この販売者に対して操作を行う前に同意するよう指示する必要があります。 |
create_google_pay_integration |
特定の販売者の Google Pay インテグレーションを作成します。この操作を行うには、ユーザーが Business Console の利用規約と Google Pay API 利用規約に同意している必要があります。事前に確認する必要はありません。同意していない場合、ツール呼び出しは失敗し、エラー メッセージには同意する必要がある特定の利用規約の URL が含まれます。このエラーが発生した場合は、ユーザーに URL を提示して同意を求め、同意したらもう一度試すよう指示します。ツールを呼び出す前に、次の手順でユーザーとやり取りします。1. まず、インテグレーション アイテムをユーザーに尋ねます（現時点ではウェブ インテグレーションのみがサポートされています）。 - ウェブサイトの URL を尋ねます。 # - インテグレーション アイテムがアプリ インテグレーションの場合は、Android アプリのパッケージ名を尋ねます。2. 次に、インテグレーション タイプをユーザーに尋ねます。 - サポートされている決済サービス プロバイダ（PSP: https://developers.google.com/pay/api#participating-processors）のいずれかを使用している場合は、[Gateway] を選択するようユーザーに伝えます。それ以外の場合は、[Direct] を選択します。3. すべてのインテグレーション タイプ（Direct または Gateway）の場合: - Google Pay API と統合された購入フローのスクリーンショット（最大 1 MB）をアップロードするようユーザーに伝えます。購入フローが審査され、承認されてから、本番環境へのフルアクセスが付与されます。例: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together- 5 つのサポート スクリーンショットの提供をユーザーに依頼する必要があります。正しいマッピングを確保するため、1 つずつ尋ねます。尋ねる際は、わかりやすい列挙型の説明のみを使用してください。4. インテグレーション タイプが Direct の場合: - PCI 証明書ドキュメントを PDF 形式で提供するようユーザーに依頼する必要があります。尋ねる際は、わかりやすい列挙型の説明のみを使用してください。5. 提供されたファイルごとに、現在のディレクトリにある場合はドキュメントのパスまたは名前を提供するようユーザーに依頼します。正しい DocumentType にマッピングし、リクエストの name フィールドにわかりやすい名前（item_selection.png や pci_attestation.pdf など）を設定します。選択したインテグレーション タイプに必要なドキュメントを収集するまで、このツールを呼び出さないでください。 |
list_pass_issuers |
認証済みユーザーに関連付けられている Google ウォレット ビジネス コンソールに登録されているすべてのパス発行者の包括的なリストを取得します。このツールは、ポイントカード、ギフトカード、フライトなどのウォレット パスを管理するデベロッパーにとって不可欠な情報を提供します。 |
list_pass_classes |
認証済みユーザーに関連付けられている Google ウォレット ビジネス コンソールに登録されているすべてのパス クラスの包括的なリストを取得します。このツールは、ポイントカード、ギフトカード、フライトなどのウォレット パスを管理するデベロッパーにとって不可欠な情報を提供します。 |
validate_pass_jwt |
パスの JWT 表現、またはパスの JSON 文字列としてのエンコードされていない JWT ペイロードを検証します。 |
query_merchant_performance |
特定の販売者のビジネス プロフィールの高レベルの集計パフォーマンス データとインテグレーション後の指標を取得します。 |
query_merchant_error_metrics |
特定の販売者のビジネス プロフィールの詳細なエラー指標を取得します。このツールは、エラーの詳細な内訳を提供し、デベロッパーが問題を特定して解決できるようにします。 |
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 }' |