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 服务器概览

服务器端点

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 集成的购买流程的屏幕截图(大小不超过 1 MB)。他们的购买流程必须接受审核并获得批准,然后他们才能获得完整的正式版发布权限。示例:https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together。- 您必须要求用户提供 5 张支持性屏幕截图。请逐个询问,以确保映射正确。提问时,请仅使用用户友好的枚举说明。4. 如果集成类型为“直接”: - 您还必须要求用户提供 PDF 格式的 PCI 证明文件。提问时仅使用用户友好的枚举说明。5. 对于提供的每个文件,请让用户提供文档路径或名称(如果位于当前目录中)。在请求中,将其映射到正确的 DocumentType,并将名称字段设置为描述性名称(例如 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
}'