התחברות לשרת ה-MCP של Google Pay ו-Wallet למפתחים

תצוגה מקדימה

השימוש במוצר הזה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאי שירות הכלליים" בתנאים הספציפיים של השירות. השימוש במוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

שרת ה-MCP למפתחים של Google Pay ו-Wallet מאפשר לכלי פיתוח מבוססי-AI לגשת לנתוני הפיתוח שלכם ב-Google Pay וב-Google Wallet, לחפש במסמכים רשמיים ולנהל את השילובים שלכם.

התקן Model Context Protocol‏ (MCP) קובע איך מודלים גדולים של שפה (LLM) ואפליקציות או סוכני AI מתחברים למקורות נתונים חיצוניים. שרתי MCP מאפשרים לכם להשתמש בכלים, במשאבים ובהנחיות שלהם כדי לבצע פעולות ולקבל נתונים מעודכנים משירות לקצה העורפי שלהם.

שרת ה-MCP למפתחים של Google Pay ו-Wallet מאפשר לכם:

• חיפוש במסמכים: מקבלים הנחיות עדכניות ודוגמאות קוד ממסמכים רשמיים של Google Pay ו-Google Wallet.
• ניהול שילובים: בדיקת הסטטוס של השילובים והפעלת ממשקי API בחשבון של מוכר/ת.
• מעקב אחרי הביצועים: גישה לנתוני ביצועים מצטברים ולמדדי שגיאות בחשבון של מוכר/ת.

• ניהול כרטיסים: רשימה של מנפיקי כרטיסים וסוגי כרטיסים ב-Google Wallet.

  הערה: אפשר לעיין במסמכי העזר של Pay & Wallet Developer כדי לראות פרטים על כלי MCP זמינים והתיאורים שלהם.

הנחיות לדוגמה

אפשר להשתמש בהנחיות הבאות עם העוזר הדיגיטלי מבוסס ה-AI:

• ‫"List my Google Pay accounts" (הצגת רשימת החשבונות שלי ב-Google Pay).
• ‫"What is the status of my Google Pay integrations?" (מה הסטטוס של השילובים שלי עם Google Pay?)
• "איך אפשר לשלב את Google Pay עם React?"
• ‫"Show me Google Pay error metrics for my integration over the last 30 days" (הצגת מדדי השגיאות של Google Pay בשילוב שלי ב-30 הימים האחרונים).
• ‫"List my Google Wallet pass classes" (הצגת סוגי הכרטיסים שלי ב-Google Wallet).

לפני שמתחילים

כדי להשתמש בשרת MCP של Google Pay ו-Wallet למפתחים, צריך ליצור פרויקט ב-Google Cloud ולהפעיל את שרת ה-MCP של Google Pay ו-Wallet למפתחים ואת ממשקי ה-API של Google Wallet.

1. במסוף Cloud, בדף לבחירת הפרויקט, בוחרים פרויקט בענן או יוצרים פרויקט חדש ב-Google Cloud.

   כניסה לדף לבחירת הפרויקט

2. מפעילים את ממשקי ה-API של Pay & Wallet Developer ושל Google Wallet.

   תפקידים שנדרשים להפעלת ממשקי API

   כדי להפעיל ממשקי API, צריך את תפקיד ה-IAM 'אדמין של שימוש בשירות' (roles/serviceusage.serviceUsageAdmin), שכולל את ההרשאה serviceusage.services.enable. איך מקצים תפקידים

   הפעלת ממשקי ה-API

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לשימוש בשרת ה-MCP המרוחק של Google Pay & Wallet Developer, צריך לבקש מהאדמין להקצות לכם את התפקידים הבאים ב-Identity and Access Management (IAM) בפרויקט ב-Google Cloud שבו אתם רוצים להפעיל את שרת ה-MCP של Google Pay & Wallet Developer:

• ביצוע שיחות באמצעות כלי ה-MCP: ‏ MCP Tool User (roles/mcp.toolUser)

מידע נוסף על הקצאת תפקידים מופיע במאמר ניהול הגישה לפרויקטים, לתיקיות ולארגונים.

אימות והרשאה

שרתי MCP של Google Pay ו-Wallet Developer משתמשים בפרוטוקול OAuth 2.0 עם ניהול זהויות והרשאות גישה (IAM) לאימות ולמתן הרשאות. כל הזהויות נתמכות לצורך אימות לשרתי MCP.

שרת ה-MCP של Google Pay ו-Wallet למפתחים לא מקבל מפתחות API.

אנחנו ממליצים ליצור זהות נפרדת לסוכנים באמצעות כלי MCP, כדי שיהיה אפשר לשלוט בגישה למשאבים ולעקוב אחריה. מידע נוסף על אימות זמין במאמר אימות לשרתי MCP.

היקפי הרשאות OAuth של שרת ה-MCP של Google Pay ו-Wallet למפתחים

ב-OAuth 2.0 משתמשים בהיקפי הרשאות ובפרטי כניסה כדי לקבוע אם לגורם מאומת יש הרשאה לבצע פעולה ספציפית במשאב. מידע נוסף על היקפי הרשאות של OAuth 2.0 ב-Google זמין במאמר שימוש ב-OAuth 2.0 לגישה ל-Google APIs.

לשרת ה-MCP של Google Pay ו-Wallet למפתחים יש את היקפי ההרשאות הבאים של כלי ה-MCP:

URI של היקף ל-CLI של gcloud	תיאור
https://www.googleapis.com/auth/paydeveloper.merchant	ניהול נתוני מוֹכרים ב-Google Pay.
https://www.googleapis.com/auth/paydeveloper.issuer.readonly	קריאת נתוני מנפיק של Google Wallet.

יצירת מזהה לקוח וסוד לקוח ב-OAuth 2.0

כדי ליצור מזהה לקוח וסוד לקוח ב-OAuth 2.0:

1. ב-Google API Console, עוברים אל Google Auth Platform > Clients > Create client.

   מעבר אל Create client

   אם עדיין אין לכם אפליקציה בפלטפורמת האימות של Google, תצטרכו ליצור אפליקציה חדשה. לוחצים על הלחצן 'תחילת העבודה' בדף הסקירה הכללית וממלאים את הפרטים הנדרשים.

2. ברשימה Application type, בוחרים את הסוג המתאים לאפליקציית ה-AI שלכם:

   • ל-Antigravity,‏ Claude.ai,‏ Claude Code ו-ChatGPT, בוחרים באפשרות Web application (אפליקציית אינטרנט).
   • ל-Gemini CLI ול-VS Code, בוחרים באפשרות אפליקציית מחשב.

3. בשדה שם, מזינים שם לאפליקציה.

4. אם בחרתם באפשרות אפליקציית אינטרנט, בקטע Authorized redirect URIs לוחצים על + Add URI ומוסיפים את כתובת ה-URI הנדרשת להפניה אוטומטית של אפליקציית ה-AI:

   Antigravity

   https://antigravity.google/oauth-callback

   Claude.ai

   https://claude.ai/api/mcp/auth_callback

   Claude Code

   http://localhost:CLAUDE_REDIRECT_PORT/callback

   ChatGPT

   אפשר להשאיר את השדה redirect_uri ריק בשלב הזה. ‫ChatGPT יוצר redirect_uri כשהאפליקציה נוצרת (מידע נוסף בהגדרת אפליקציית ה-AI בהמשך).

   הערה: בקטע מקורות JavaScript מורשים, לוחצים על + הוספת URI, ואז מוסיפים https://chatgpt.com בשדה URI.

5. לוחצים על יצירה. סוד הלקוח מוצג פעם אחת בלבד אחרי שהוא נוצר. מעתיקים אותו ומאחסנים אותו באופן מאובטח.

הגדרת אפליקציית ה-AI

בשלב הבא, צריך לספק לאפליקציית ה-AI את פרטי הגדרת השרת.

Gemini CLI

1. כדי להגדיר את Gemini CLI, מוסיפים את השורות הבאות לקובץ `~/.gemini/settings.json`:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "httpUrl": "https://paydeveloper.googleapis.com/mcp",
         "authProviderType": "dynamic_discovery",
         "oauth": {
           "enabled": true,
           "clientId": "GEMINI_CLI_CLIENT_ID",
           "clientSecret": "GEMINI_CLI_CLIENT_SECRET",
           "scopes": [
             "https://www.googleapis.com/auth/paydeveloper.merchant",
             "https://www.googleapis.com/auth/paydeveloper.issuer.readonly"
           ]
         }
       }
     }
   }

2. מריצים את הפקודה /mcp auth google-pay-wallet-dev כדי להתחיל בתהליך האימות של שרת ה-MCP של Google Pay ו-Wallet למפתחים.

Antigravity

כדי להגדיר את Antigravity כך שישתמש בשרת ה-MCP:

1. ב-Antigravity, לוחצים על התפריט אפשרויות נוספות בחלונית Agent >‏ MCP Servers >‏ Manage MCP Servers.
2. בחלק העליון של החלונית Manage MCP Servers (ניהול שרתי MCP), לוחצים על View raw config (הצגת הגדרות התצורה הגולמיות) כדי לערוך את הקובץ mcp_config.json:

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "ANTIGRAVITY_CLIENT_ID",
           "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
         }
       }
     }
   }

3. חוזרים אל ניהול שרתי MCP ולוחצים על רענון. כשלוחצים על אימות, נפתחת הכרטיסייה התאמות אישיות בהגדרות הסוכן.
4. לוחצים על אימות ומשלימים את תהליך OAuth.
5. מעתיקים את קוד ההרשאה ושולחים אותו בחלון הגדרות הסוכן.

VS Code

1. כדי להגדיר את VS Code (Copilot), עורכים את הקובץ .vscode/mcp.json בסביבת העבודה:

   {
     "servers": {
       "google-pay-wallet-dev": {
         "url": "https://paydeveloper.googleapis.com/mcp"
       }
     }
   }

2. מתקשרים לכלי בשרת ה-MCP כדי להפעיל את תהליך האימות. לדוגמה: "תציג את החשבונות שלי ב-Google Pay".
3. תיבת הדו-שיח רישום דינמי של לקוחות לא אפשרי נפתחת כמו שצריך. לוחצים על כפתור כלשהו כדי לסגור את תיבת הדו-שיח.
4. מזינים את מזהה הלקוח ב-OAuth ומקישים על Enter.
5. כשמופיעה בקשה, מזינים את סוד לקוח ה-OAuth ומקישים על Enter.
6. נפתח חלון דו-שיח לאימות. לוחצים על אישור.
7. אחרי האישור, הכלי מופעל והסשן ממשיך בחלון הצ'אט.

Claude.ai

כדי להגדיר את Claude.ai:

1. עוברים אל התאמה אישית > מחברים.
2. לוחצים על הלחצן ובוחרים באפשרות הוספת מחבר בהתאמה אישית.
3. מזינים את הפרטים הבאים:
   שם השרת: Google Pay & Wallet MCP.
   כתובת ה-URL של שרת MCP מרוחק https://paydeveloper.googleapis.com/mcp.
4. בהגדרות מתקדמות מזינים את מזהה הלקוח ב-OAuth ואת סוד הלקוח ב-OAuth.
5. בוחרים את המחבר החדש ולוחצים על Connect (קישור).

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

ChatGPT

כדי להגדיר את ChatGPT:

1. מפעילים את מצב פיתוח דרך הגדרות > אפליקציות > הגדרות מתקדמות.
2. לוחצים על הלחצן יצירת אפליקציה.
3. ממלאים את הפרטים הבאים:
   שם: Google Pay & Wallet MCP.
   כתובת ה-URL של שרת ה-MCP: https://paydeveloper.googleapis.com/mcp
4. עוברים אל הגדרות מתקדמות ומזינים את מזהה הלקוח ב-OAuth ואת הסוד.
5. מעתיקים את כתובת ה-URL של הקריאה החוזרת הדינמית ומוסיפים אותה ללקוח OAuth שנוצר בשלב הקודם.

מגבלות ידועות

• תוצאות באנגלית בלבד: חיפוש במסמכים תומך רק באנגלית.
• תוכן מאחורי ACL: תיעוד מאחורי רשימות ACL לא נוסף לאינדקס
• תלוי ברשת: השרת דורש חיבור פעיל לשירותי Google Pay ו-Wallet.

תנאים והגבלות

השימוש ב-Google Pay API כפוף לתנאים ולהגבלות של Google Pay API. השימוש ב-Google Wallet API כפוף לתנאים ולהגבלות של Google Wallet API.