MCP Reference: paydeveloper.googleapis.com

Model Context Protocol (MCP) 服务器充当外部服务（为大语言模型 [LLM] 或 AI 应用提供上下文、数据或功能）与 LLM 或 AI 应用之间的代理。MCP 服务器将 AI 应用连接到数据库和 Web 服务等外部系统，并将这些系统的响应转换为 AI 应用可理解的格式。

服务器设置

您必须先启用 MCP 服务器并设置身份验证，然后才能使用。如需详细了解如何使用 Google 和 Google Cloud 远程 MCP 服务器，请参阅 Google Cloud MCP servers overview。

服务器端点

MCP 服务端点是 MCP 服务器的网络地址和通信接口（通常是网址），AI 应用（MCP 客户端的宿主）使用该端点来建立安全、标准化的连接。它是 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 使用经过身份验证的账号创建新商家。您必须要求用户提供创建商家所需的必要信息。在尝试收集创建商家所需的必要信息之前，请勿调用此工具。创建商家后，您必须向用户显示商家控制台服务条款网址，并指示他们接受该网址，然后才能对此商家执行任何操作。
create_google_pay_integration 为特定商家创建 Google Pay 集成。此操作要求用户已接受商家控制台服务条款和 Google Pay API 服务条款。您无需提前检查这些条款。如果用户尚未接受这些条款，工具调用将失败，并且错误消息将包含需要接受的特定服务条款网址。如果发生这种情况，请向用户显示网址以供接受，并指示他们在接受后重试。请按照以下顺序在调用工具之前与用户互动：1. 首先，询问用户集成项（目前仅支持 Web 集成）。 - 询问网站网址。 # - 如果集成项是应用集成，请询问 Android 应用软件包名称。2. 然后，询问用户集成类型：- 如果用户使用我们支持的付款服务提供商 (PSP: https://developers.google.com/pay/api#participating-processors) 之一，请告知用户选择“网关”，否则选择“直接”。3. 对于所有集成类型（“直接”或“网关”）：- 告知用户上传与 Google Pay API 集成的购买流程的屏幕截图（最大 1MB）。他们的购买流程必须经过审核并获得批准，然后才能获得完整的正式版发布权限。示例：https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together。- 您必须要求用户提供 5 张支持性屏幕截图。请逐一询问，以确保正确映射。询问时，请仅使用用户友好的枚举说明。4. 如果集成类型为“直接”：- 您还必须要求用户提供 PDF 格式的 PCI 证明文档。询问时，请仅使用用户友好的枚举说明。5. 对于提供的每个文件，如果用户位于当前目录中，请要求用户提供文档路径或名称。将其映射到正确的 DocumentType，并在请求中将 name 字段设置为描述性名称（例如 item_selection.png 或 pci_attestation.pdf）。在尝试收集所选集成类型所需的文档之前，请勿调用此工具。
list_pass_issuers 检索与经过身份验证的用户关联的 Google 钱包商家控制台中注册的所有卡券发行方的完整列表。此工具为管理钱包卡券（例如会员卡、礼品卡或航班）的开发者提供必要的信息。
list_pass_classes 检索与经过身份验证的用户关联的 Google 钱包商家控制台中注册的所有卡券类的完整列表。此工具为管理钱包卡券（例如会员卡、礼品卡或航班）的开发者提供必要的信息。
validate_pass_jwt 验证卡券的 JWT 表示法，或卡券的未编码 JWT 载荷（以 JSON 字符串的形式）。
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
}'