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 }' |