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

שרת ה-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.

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

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

  • ‫"List my Google Pay accounts" (הצגת רשימת החשבונות שלי ב-Google Pay).
  • "מה הסטטוס של השילובים שלי עם 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 למפתחים.

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

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

  2. מפעילים את Pay & Wallet Developer API.

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

    כדי להפעיל ממשקי API, נדרשת ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק 'שימוש בשירות'' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    להפעלת ה-API

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

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

  • ביצוע קריאות לכלי 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 OAuth:

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

  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 בהמשך).

  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. מעתיקים את קוד ההרשאה ושולחים אותו בחלון Agent Settings.

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. תיבת הדו-שיח Dynamic Client Registration not supported (רישום דינמי של לקוחות לא אפשרי) נפתחת כמו שצפוי. לוחצים על כפתור כלשהו כדי לסגור את תיבת הדו-שיח.
  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.