连接到 Google Pay 和 Google 钱包开发者 MCP 服务器

Google Pay 和 Google 钱包开发者 MCP 服务器可让 AI 赋能型开发工具访问您的 Google Pay 和 Google 钱包开发者数据、搜索官方文档以及管理您的集成。

Model Context Protocol (MCP) 可规范大语言模型 (LLM) 和 AI 应用或代理连接到外部数据源的方式。借助 MCP 服务器,您可以使用其工具、资源和提示来执行操作,并从其后端服务获取更新后的数据。

借助 Google Pay 和 Google 钱包开发者 MCP 服务器,您可以:

  • 搜索文档:从 Google Pay 和 Google 钱包官方文档中获取最新指南和代码示例。
  • 管理集成:查看集成状态,并为商家账号启用 API。
  • 监控效果:访问商家账号的汇总效果数据和错误指标。
  • 管理卡券:列出 Google 钱包的卡券发卡机构和类别。

示例提示

您可以将以下提示与 AI 助理搭配使用:

  • “列出我的 Google Pay 账号。”
  • “我的 Google Pay 集成处于什么状态?”
  • “如何将 Google Pay 与 React 集成?”
  • “显示过去 30 天内我的集成项目的 Google Pay 错误指标。”
  • “列出我的 Google 钱包卡券类。”

准备工作

如需使用 Google Pay & Wallet Developer MCP 服务器,您必须创建 Google Cloud 项目,并启用 Google Pay & Wallet Developer MCP 服务器和 Google 钱包 API。

  1. 在 Cloud 控制台的项目选择器页面上,选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  2. 启用 Pay & Wallet Developer、Google Wallet API。

    启用 API 所需的角色

    如需启用 API,您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin),该角色包含 serviceusage.services.enable 权限。了解如何授予角色

    启用 API

所需的角色

如需获得使用 Google Pay 和钱包开发者 MCP 服务器远程 MCP 服务器所需的权限,请让管理员向您授予您要在其中启用 Google Pay 和钱包开发者 MCP 服务器 MCP 服务器的 Google Cloud 项目的以下 Identity and Access Management (IAM) 角色:

如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

身份验证和授权

Google Pay 和 Google 钱包开发者 MCP 服务器 MCP 服务器使用 OAuth 2.0 协议和 Identity and Access Management (IAM) 进行身份验证和授权。支持所有 身份用于向 MCP 服务器进行身份验证。

Google Pay 和 Google 钱包开发者 MCP 服务器不接受 API 密钥。

我们建议使用 MCP 工具为代理创建单独的身份,以便控制和监控对资源的访问权限。如需详细了解身份验证,请参阅向 MCP 服务器进行身份验证

Google Pay 和钱包开发者 MCP 服务器 OAuth 范围

OAuth 2.0 使用范围和凭证来确定经过身份验证的主账号是否有权对资源执行特定操作。如需详细了解 Google 的 OAuth 2.0 范围,请参阅使用 OAuth 2.0 访问 Google API

Google Pay 和 Google 钱包开发者 MCP 服务器具有以下 MCP 工具 OAuth 范围:

gcloud CLI 的范围 URI 说明
https://www.googleapis.com/auth/paydeveloper.merchant 管理 Google Pay 商家数据。
https://www.googleapis.com/auth/paydeveloper.issuer.readonly 读取 Google 钱包发卡机构数据。

创建 OAuth 2.0 客户端 ID 和密钥

如需创建 OAuth 2.0 客户端 ID 和密钥,请按以下步骤操作:

  1. 在 Google API 控制台中,依次前往 Google Auth Platform > 客户端 > 创建客户端

    前往“创建客户端”

  2. 应用类型列表中,为您的 AI 应用选择合适的类型:

    • 对于 AntigravityClaude.aiClaude CodeChatGPT,请选择Web 应用
    • 对于 Gemini CLIVS Code,请选择桌面应用
  3. 名称字段中,为应用输入名称。

  4. 如果您选择了 Web 应用,请在已获授权的重定向 URI 部分中点击 + 添加 URI,然后为您的 AI 应用添加所需的重定向 URI:

    Antigravity

    https://antigravity.google/oauth-callback

    Claude.ai

    https://claude.ai/api/mcp/auth_callback

    Claude Code

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    ChatGPT

    您可以暂时将 redirect_uri 留空。创建应用时,ChatGPT 会生成一个 redirect_uri(请参阅下文的配置 AI 应用)。

  5. 点击创建。创建后,系统会显示一次客户端密钥。复制并妥善存储此密码。

配置 AI 应用

接下来,您需要向 AI 应用提供服务器配置详细信息。

Gemini CLI

  1. 如需配置 Gemini CLI,请将以下内容添加到 `~/.gemini/settings.json` 文件中:

    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "httpUrl": "https://paydeveloper.googleapis.com/mcp",
          "authProviderType": "dynamic_discovery",
          "oauth": {
            "enabled": true,
            "clientId": "GEMINI_CLI_CLIENT_ID",
            "clientSecret": "GEMINI_CLI_CLIENT_SECRET",
            "scopes": [
              "https://www.googleapis.com/auth/paydeveloper.merchant",
              "https://www.googleapis.com/auth/paydeveloper.issuer.readonly"
            ]
          }
        }
      }
    }
  2. 运行 /mcp auth google-pay-wallet-dev 以启动 Google Pay 和 Google 钱包开发者 MCP 服务器的身份验证流程。

Antigravity

如需将 Antigravity 配置为使用 MCP 服务器,请执行以下操作:

  1. 在 Antigravity 中,依次点击“智能体”窗格中的其他选项 菜单 > MCP 服务器 > 管理 MCP 服务器
  2. 在“管理 MCP 服务器”窗格顶部,点击查看原始配置以修改 mcp_config.json 文件:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "ANTIGRAVITY_CLIENT_ID",
            "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
          }
        }
      }
    }
  3. 返回到管理 MCP 服务器,然后点击刷新。 点击身份验证会打开代理设置中的自定义标签页。
  4. 点击身份验证,然后完成 OAuth 流程。
  5. 复制授权代码,然后在 Agent Settings(代理设置)窗口中提交该代码。

VS Code

  1. 如需配置 VS Code (Copilot),请修改工作区中的 .vscode/mcp.json 文件:
    {
      "servers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp"
        }
      }
    }
  2. 调用 MCP 服务器中的工具以触发身份验证流程。 例如:“列出我的 Google Pay 账号”。
  3. 系统会按预期打开动态客户端注册不支持对话框。点击任意按钮即可关闭对话框。
  4. 输入您的 OAuth 客户端 ID,然后按 Enter 键。
  5. 出现提示时,输入您的 OAuth 客户端密钥,然后按 Enter 键。
  6. 系统会打开一个用于进行身份验证的对话框,点击允许
  7. 授权后,系统会调用该工具,并在聊天窗口中继续会话。

Claude.ai

如需配置 Claude.ai,请执行以下操作:

  1. 依次前往自定义 > 连接器
  2. 点击 按钮,然后选择添加自定义连接器
  3. 输入以下详细信息:
      服务器名称Google Pay & Wallet MCP
      远程 MCP 服务器网址 https://paydeveloper.googleapis.com/mcp
  4. 高级设置中,输入您的 OAuth 客户端 IDOAuth 客户端密钥
  5. 选择新连接器,然后点击连接

Claude Code

如需配置 Claude Code,请运行以下命令:

MCP_CLIENT_SECRET=CLAUDE_CODE_CLIENT_SECRET claude mcp add --transport http \
  --client-id CLAUDE_CODE_CLIENT_ID --client-secret --callback-port CLAUDE_REDIRECT_PORT \
  google-pay-wallet-dev https://paydeveloper.googleapis.com/mcp

ChatGPT

如需配置 ChatGPT,请执行以下操作:

  1. 依次前往设置 > 应用 > 高级设置,启用开发者模式
  2. 点击创建应用按钮。
  3. 输入以下详细信息:
      名称Google Pay & Wallet MCP
      MCP 服务器网址https://paydeveloper.googleapis.com/mcp
  4. 前往高级设置,然后输入您的 OAuth 客户端 ID 和密钥。
  5. 复制动态回调网址,并将其添加到上一步中创建的 OAuth 客户端。

已知限制

  • 仅限英文结果:文档搜索仅支持英文。
  • ACL 后面的内容:ACL 后面的文档不会编入索引
  • 依赖于网络:服务器需要与 Google Pay 和 Google 钱包服务保持实时连接。

服务条款

使用 Google Pay API 需遵守 Google Pay API 服务条款。使用 Google Wallet API 时,必须遵守 Google Wallet API 服务条款