MCP Reference: paydeveloper.googleapis.com

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 伺服器具有下列全域 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. 首先,請使用者提供整合項目 (目前僅支援網站整合)。- 要求提供網站網址。# - If the integration item is App integration, ask for the Android app package name. 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 錢包商家控制台中,所有已註冊的票證發卡機構完整清單。這項工具提供重要資訊,協助開發人員管理會員卡、禮物卡或航班等 Google 錢包票證。
list_pass_classes 擷取與已驗證使用者相關聯的 Google 錢包商家控制台中,註冊的所有票證類別完整清單。這項工具提供重要資訊,協助開發人員管理會員卡、禮物卡或航班等 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
}'