MCP Reference: paydeveloper.googleapis.com

這是提供工具給 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
}'