התחברות לשרת ה-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?"
  • "תציג לי את מדדי השגיאות של השילוב שלי עם 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). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

    להפעלת ה-API

אימות והרשאה

שרת ה-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 שלכם:

    • עבור Cursor Desktop,‏ Claude Code,‏ Claude.ai,‏ ChatGPT ו-Antigravity, בוחרים באפשרות Web application (אפליקציית אינטרנט).
    • ל-Antigravity CLI, ל-Antigravity IDE ול-VS Code, בוחרים באפשרות אפליקציה למחשב.
  3. בשדה שם, מזינים שם לאפליקציה.

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

    סמן במחשב

    http://localhost:8787/callback

    Claude Code

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    Claude.ai

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

    ChatGPT

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

    Antigravity

    https://antigravity.google/oauth-callback

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

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

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

VS Code

  1. לוחצים על סמל בחלק העליון של חלונית הצד של הצ'אט ועוברים אל MCP Servers (שרתי MCP).
  2. לוחצים על הלחצן הוספת שרת (), בוחרים באפשרות HTTP ומזינים את כתובת ה-URL שמפנה לשרת MCP של Pay & Wallet Developer: ‏ https://paydeveloper.googleapis.com/mcp.
    ההגדרה של MCP נשמרת בקובץ .vscode/mcp.json בסביבת העבודה:
    {
      "servers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp"
        }
      }
    }
  3. לוחצים לחיצה ימנית על שרת ה-MCP החדש ובוחרים באפשרות הפעלת השרת.
  4. חוזרים לחלון הצ'אט ומפעילים כלי בשרת ה-MCP כדי להפעיל את תהליך האימות. לדוגמה: "תציג את החשבונות שלי ב-Google Pay".
  5. תיבת הדו-שיח Dynamic Client Registration לא אפשרי נפתחת כמו שצפוי. לוחצים על לחצן כלשהו כדי לסגור את תיבת הדו-שיח.
  6. מזינים את מזהה הלקוח ב-OAuth ומקישים על Enter.
  7. כשמופיעה בקשה, מזינים את סוד הלקוח ב-OAuth ומקישים על Enter.
  8. נפתח חלון דו-שיח לאימות. לוחצים על אישור.
  9. אתם יכולים לבחור מתוך רשימה של זהויות מאומתות או להיכנס לחשבון חדש.
  10. אחרי האימות, הכלי מופעל והסשן ממשיך בחלון הצ'אט.

סמן במחשב

כדי להגדיר את Cursor Desktop:

  1. בחלונית הצדדית שבצד ימין, לוחצים על התאמה אישית.
  2. לוחצים על שרת MCP חדש. ייפתח קובץ ההגדרות mcp.json.
  3. מזינים את פרטי ההגדרה כדי להוסיף את שרת ה-MCP של Google Pay ו-Wallet למפתחים:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "url": "https://paydeveloper.googleapis.com/mcp",
          "auth": {
            "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
            "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
          }
        }
      }
    }
  4. אחרי ששומרים את הקובץ, רשימת שרתי ה-MCP מתעדכנת.
  5. לוחצים על אימות כדי להתחיל את תהליך האימות.

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

Claude.ai

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

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

ChatGPT

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

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

Antigravity CLI

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

    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "AGY_CLI_CLIENT_ID",
            "clientSecret": "AGY_CLI_CLIENT_SECRET"
          }
        }
      }
    }
  2. מריצים את הפקודה /mcp, בוחרים את שרת ה-MCP החדש ולוחצים על Authenticate (אימות) כדי להתחיל את תהליך האימות.

‫Antigravity IDE

  1. לוחצים על בחלק העליון של החלונית הצדדית של הסוכן בכלי העריכה ובוחרים באפשרות שרתי MCP.
  2. לוחצים על ניהול שרתי MCP.
  3. לוחצים על View raw config (הצגת ההגדרות הגולמיות) ומוסיפים את פרטי שרת ה-MCP:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "ANTIGRAVITY_IDE_CLIENT_ID",
            "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET"
          }
        }
      }
    }
  4. חוזרים אל Antigravity IDE ולוחצים על רענון.
  5. בוחרים את שרת ה-MCP החדש, לוחצים על אימות ומשלימים את תהליך האימות.
  6. מעתיקים את קוד ההרשאה ושולחים אותו בחלון Antigravity Settings.

Antigravity

  1. ב-Antigravity, עוברים אל הגדרות > התאמות אישיות.
  2. בקטע Installed MCP Servers (שרתי MCP מותקנים), לוחצים על Open MCP Config (פתיחת הגדרות MCP) כדי לערוך את הקובץ mcp_config.json:
    {
      "mcpServers": {
        "google-pay-wallet-dev": {
          "serverUrl": "https://paydeveloper.googleapis.com/mcp",
          "oauth": {
            "clientId": "ANTIGRAVITY_CLIENT_ID",
            "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
          }
        }
      }
    }
  3. חוזרים אל Antigravity ולוחצים על רענון.
  4. לוחצים על אימות ומשלימים את תהליך האימות.
  5. מעתיקים את קוד ההרשאה ושולחים אותו בחלון Antigravity Settings.

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

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

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

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