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

    להפעלת ה-API

אימות והרשאה

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

שרת ה-MCP למפתחים של Google Pay ו-Google 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‏ > לקוחות > יצירת לקוח.

    כניסה לדף Create client

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

    • ב-Cursor Desktop, ב-Claude Code, ב-Claude.ai, ב-ChatGPT וב-Antigravity, בוחרים באפשרות אפליקציית אינטרנט.
    • ב-Antigravity CLI, ב-Antigravity IDE וב-VS Code, בוחרים באפשרות אפליקציה למחשב.

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

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

    Cursor למחשב

    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.
  2. לוחצים על הכפתור Add Server (), בוחרים באפשרות 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 not supported נפתחת כמו שצפוי. לוחצים על לחצן כלשהו כדי לסגור את תיבת הדו-שיח.
  6. מזינים את מזהה הלקוח ב-OAuth ומקישים על Enter.
  7. כשמופיעה בקשה, מזינים את סוד הלקוח ב-OAuth ומקישים על Enter.
  8. תיבת דו-שיח לאימות נפתחת, לוחצים על אישור.
  9. אתם יכולים לבחור מתוך רשימה של זהויות מאומתות, או להיכנס באמצעות חשבון חדש.
  10. אחרי האימות, הכלי מופעל והסשן ממשיך בחלון הצ'אט.

Cursor למחשב

כדי להגדיר את 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. בקטע Advanced settings, מזינים את מזהה הלקוח ב-OAuth ואת סוד הלקוח ב-OAuth.
  5. בוחרים את המחבר החדש ולוחצים על Connect (קישור).

ChatGPT

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

  1. מפעילים את מצב פיתוח דרך הגדרות > אבטחה והתחברות.
  2. בחלונית הצדדית הראשית, לוחצים על פלאגינים ואז על הלחצן .
  3. ממלאים את הפרטים הבאים:
      שם: Google Pay & Wallet MCP.
      כתובת ה-URL של השרת: https://paydeveloper.googleapis.com/mcp
  4. עוברים אל Advanced settings (הגדרות מתקדמות) ומזינים את מזהה הלקוח ואת הסוד ב-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 החדש ולוחצים על אימות כדי להתחיל את תהליך האימות.

‫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 ולוחצים על Refresh (רענון).
  5. בוחרים את שרת ה-MCP החדש, לוחצים על אימות ומשלימים את תהליך האימות.
  6. מעתיקים את קוד ההרשאה ומזינים אותו בחלון Antigravity Settings.

Antigravity

  1. ב-Antigravity, עוברים אל הגדרות > התאמות אישיות.
  2. בקטע Installed MCP Servers, לוחצים על Open MCP 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. חוזרים אל Antigravity ולוחצים על רענון.
  4. לוחצים על אימות ומשלימים את תהליך האימות.
  5. מעתיקים את קוד ההרשאה ומזינים אותו בחלון Antigravity Settings.

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

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

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

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