這是提供工具給 Google 付款開發人員使用的 MCP 伺服器。
Model Context Protocol (MCP) 伺服器可做為代理伺服器,在外部服務與大型語言模型 (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 伺服器 API 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 整合服務目前狀態和設定詳細資料。並立即提供整合和文件審查狀態的意見回饋。此外,您「必須」告知使用者,整合功能可在 Google Pay 和錢包主控台 (https://pay.google.com/business/console/) 中建立/更新。 |
create_merchant |
使用已通過驗證的帳戶建立新商家。你「必須」要求使用者提供建立商家所需的資訊。其中一個必填欄位是商家類別代碼 (MCC)。由於 MCC 清單很長,您可以顯示常見選項的子集,但務必告知使用者還有更多選項,並可要求完整清單 (例如顯示「還有 X 個選項」或類似提示)。此外,請告知使用者,如果他們已知道 4 位數的 MCC 代碼 (例如 5499),可以直接提供並使用該代碼。請先嘗試收集建立商家所需的資訊,再呼叫這項工具。建立商家後,您「必須」向使用者提供商家主控台服務條款網址,並指示他們接受條款,才能對這個商家執行任何操作。 |
list_pass_issuers |
擷取與已驗證使用者相關聯的 Google 錢包商家控制台中,註冊的所有票證發卡機構完整清單。這項工具提供重要資訊,協助開發人員管理會員卡、禮物卡或航班等 Google 錢包票證。 |
list_pass_classes |
擷取與已驗證使用者相關聯的 Google 錢包商家控制台中,所有已註冊票證類別的完整清單。這項工具提供重要資訊,協助開發人員管理會員卡、禮物卡或航班等 Google 錢包票證。 |
validate_pass_jwt |
驗證票證的 JWT 表示法,或票證的未編碼 JWT 酬載 (以 JSON 字串形式)。 |
query_merchant_performance |
擷取特定商家商家檔案的高層級匯總成效資料和整合後指標。 |
query_merchant_error_metrics |
擷取特定商家商家檔案的詳細錯誤指標。這項工具會詳細列出錯誤,方便開發人員找出並解決問題。 |
update_merchant |
更新現有商家的特定欄位。支援的欄位包括 display_name、mcc、corporate_website_url、customer_support_website_url、customer_support_email 和 customer_support_phone。 |
list_principals |
列出可存取特定商家的主體 (使用者)。這項操作需要商家管理員存取權。 |
set_principal_role |
設定商家主體 (使用者) 的角色,或新增具有指定角色的主體。系統會傳送電子郵件邀請給負責人,負責人必須接受邀請,存取權才會生效。這項操作需要商家管理員存取權。 |
delete_principal |
刪除主體(使用者)對特定商家的存取權限。這項操作需要商家管理員存取權。 |
取得 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 }' |