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 服务器。
-
在 Cloud 控制台的项目选择器页面上,选择或创建 Google Cloud 项目。
-
启用 Pay & Wallet Developer API。
启用 API 所需的角色
如需启用 API,您需要拥有
serviceusage.services.enable权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 获得了此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。
所需的角色
如需获得使用 Google Pay 和 Google 钱包开发者 MCP 服务器远程 MCP 服务器所需的权限,请让管理员向您授予 Google Cloud 项目的以下 Identity and Access Management (IAM) 角色,您需要在该项目中启用 Google Pay 和 Google 钱包开发者 MCP 服务器:
- 进行 MCP 工具调用:MCP Tool User (
roles/mcp.toolUser)
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
身份验证和授权
Google Pay 和 Google 钱包开发者 MCP 服务器使用 OAuth 2.0 协议与 Identity and Access Management (IAM) 搭配使用,以进行身份验证和授权。支持所有 身份用于向 MCP 服务器进行身份验证。
Google Pay 和 Google 钱包开发者 MCP 服务器不接受 API 密钥。
我们建议使用 MCP 工具为客服人员创建单独的身份,以便控制和监控对资源的访问权限。如需详细了解身份验证,请参阅向 MCP 服务器进行身份验证。
Google Pay 和 Google 钱包开发者 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 和密钥,请按以下步骤操作:
-
在 Google API 控制台中,依次前往 Google Auth Platform > 客户端 > 创建客户端。
-
在应用类型列表中,为您的 AI 应用选择合适的类型:
- 对于 Cursor Desktop、Claude Code、Claude.ai、ChatGPT 和 Antigravity,请选择Web 应用。
- 对于 Antigravity CLI、Antigravity IDE 和 VS Code,请选择桌面应用。
在名称字段中,为应用输入名称。
-
如果您选择了 Web 应用,请在已获授权的重定向 URI 部分中点击 + 添加 URI,然后为您的 AI 应用添加所需的重定向 URI:
Cursor 桌面版
http://localhost:8787/callbackClaude Code
http://localhost:CLAUDE_REDIRECT_PORT/callback
Claude.ai
https://claude.ai/api/mcp/auth_callbackChatGPT
您可以暂时将
redirect_uri留空。创建应用时,ChatGPT 会生成一个redirect_uri(请参阅下文的配置 AI 应用)。Antigravity
https://antigravity.google/oauth-callback 点击创建。创建后,客户端密钥会显示一次。复制并妥善存储此密码。
配置 AI 应用
接下来,您需要向 AI 应用提供服务器配置详细信息。
VS Code
- 点击聊天侧边栏顶部的 图标,然后前往 MCP 服务器。
-
点击添加服务器按钮 (),选择 HTTP,然后输入指向 Pay & Wallet Developer MCP 服务器的网址:
https://paydeveloper.googleapis.com/mcp。
您的 MCP 配置已保存在工作区的.vscode/mcp.json文件中:{ "servers": { "google-pay-wallet-dev": { "url": "https://paydeveloper.googleapis.com/mcp" } } }
- 右键点击新的 MCP 服务器,然后选择 Start Server。
- 返回到聊天窗口,调用 MCP 服务器中的工具以触发身份验证流程。 例如:“列出我的 Google Pay 账号”。
- 系统会按预期打开“不支持动态客户端注册”对话框。点击任意按钮即可关闭对话框。
- 输入您的 OAuth 客户端 ID,然后按 Enter 键。
- 出现提示时,输入您的 OAuth 客户端密钥,然后按 Enter 键。
- 系统会打开一个用于进行身份验证的对话框,点击允许。
- 您可以从经过身份验证的身份列表中进行选择,也可以使用新账号登录。
- 身份验证完成后,系统会调用该工具,并在聊天窗口中继续会话。
Cursor 桌面版
如需配置 Cursor Desktop,请执行以下操作:
- 点击左侧面板中的自定义。
-
点击新建 MCP 服务器。系统会打开
mcp.json配置文件。 -
输入配置详细信息以添加 Google Pay 和 Google 钱包开发者 MCP 服务器:
{ "mcpServers": { "google-pay-wallet-dev": { "url": "https://paydeveloper.googleapis.com/mcp", "auth": { "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID", "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET" } } } }
- 保存文件后,MCP 服务器列表会更新。
- 点击进行身份验证以开始身份验证流程。
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
Claude.ai
如需配置 Claude.ai,请执行以下操作:
- 依次前往自定义 > 连接器。
- 点击添加,然后选择添加自定义连接器。
-
输入以下详细信息:
-
服务器名称:
Google Pay & Wallet MCP。-
远程 MCP 服务器网址
https://paydeveloper.googleapis.com/mcp。 - 在高级设置中,输入您的 OAuth 客户端 ID 和 OAuth 客户端密钥。
- 选择新连接器,然后点击连接。
ChatGPT
如需配置 ChatGPT,请执行以下操作:
- 依次前往设置 > 安全和登录,启用开发者模式。
- 在主侧边栏中选择 Plugins,然后点击 按钮。
-
输入以下详细信息:
-
名称:
Google Pay & Wallet MCP。-
服务器网址:
https://paydeveloper.googleapis.com/mcp - 前往高级设置,然后输入您的 OAuth 客户端 ID 和密钥。
- 复制动态回调网址,并将其添加到上一步中创建的 OAuth 客户端。
Antigravity CLI
-
如需配置 Antigravity CLI,请将以下内容添加到您的
~/.gemini/config/mcp_config.json文件中:{ "mcpServers": { "google-pay-wallet-dev": { "serverUrl": "https://paydeveloper.googleapis.com/mcp", "oauth": { "clientId": "AGY_CLI_CLIENT_ID", "clientSecret": "AGY_CLI_CLIENT_SECRET" } } } }
-
运行
/mcp,选择新的 MCP 服务器,然后选择验证以启动身份验证过程。
Antigravity IDE
- 点击编辑器代理侧边栏顶部的 ,然后选择 MCP 服务器。
- 点击 Manage MCP Servers。
-
点击 View raw config(查看原始配置),然后添加您的 MCP 服务器详细信息:
{ "mcpServers": { "google-pay-wallet-dev": { "serverUrl": "https://paydeveloper.googleapis.com/mcp", "oauth": { "clientId": "ANTIGRAVITY_IDE_CLIENT_ID", "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET" } } } }
- 返回 Antigravity IDE,然后点击刷新。
- 选择新的 MCP 服务器,然后点击进行身份验证并完成身份验证流程。
- 复制授权代码,然后在 Antigravity 设置窗口中提交该代码。
Antigravity
- 在 Antigravity 中,依次前往 设置 > 自定义。
-
在 Installed MCP Servers 部分,点击 Open MCP Config 以修改
mcp_config.json文件:{ "mcpServers": { "google-pay-wallet-dev": { "serverUrl": "https://paydeveloper.googleapis.com/mcp", "oauth": { "clientId": "ANTIGRAVITY_CLIENT_ID", "clientSecret": "ANTIGRAVITY_CLIENT_SECRET" } } } }
- 返回 Antigravity,然后点击刷新。
- 点击身份验证,然后完成身份验证流程。
- 复制授权代码,然后在 Antigravity 设置窗口中提交该代码。
已知限制
- 仅限英文结果:文档搜索仅支持英文。
- ACL 后面的内容:ACL 后面的文档不会编入索引
- 依赖于网络:服务器需要与 Google Pay 和 Google 钱包服务保持实时连接。
服务条款
使用 Google Pay API 需遵守 Google Pay API 服务条款。使用 Google Wallet API 时,必须遵守 Google Wallet API 服务条款。