התחברות לשרת ה-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 ולהפעיל את שרת ה-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 Tool User (roles/mcp.toolUser)

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

אימות והרשאה

שרת ה-MCP של Google Pay ו-Wallet למפתחים משתמש בפרוטוקול 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 החדש ובוחרים באפשרות Start Server (הפעלת השרת).
  4. חוזרים לחלון הצ'אט ומפעילים כלי בשרת ה-MCP כדי להפעיל את תהליך האימות. לדוגמה: "תציג את החשבונות שלי ב-Google Pay".
  5. תיבת הדו-שיח Dynamic Client Registration not supported (רישום דינמי של לקוחות לא אפשרי) נפתחת כמו שצפוי. לוחצים על כפתור כלשהו כדי לסגור את תיבת הדו-שיח.
  6. מזינים את מזהה הלקוח ב-OAuth ומקישים על Enter.
  7. כשמופיעה בקשה, מזינים את סוד הלקוח ב-OAuth ומקישים על Enter.
  8. נפתח חלון דו-שיח לאימות. לוחצים על אישור.
  9. אתם יכולים לבחור מתוך רשימה של זהויות מאומתות או להיכנס לחשבון חדש.
  10. אחרי האימות, הכלי מופעל והסשן ממשיך בחלון הצ'אט.

סמן למחשב

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

  1. בחלונית שבצד ימין, לוחצים על התאמה אישית.
  2. לוחצים על New MCP Server (שרת 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.