שרת Model Context Protocol (MCP) פועל כשרת proxy בין שירות חיצוני שמספק הקשר, נתונים או יכולות למודל שפה גדול (LLM) או לאפליקציית AI. שרתי MCP מחברים אפליקציות AI למערכות חיצוניות כמו מסדי נתונים ושירותי אינטרנט, ומתרגמים את התשובות שלהם לפורמט שאפליקציית ה-AI יכולה להבין.
הגדרת השרת
לפני שמשתמשים בשרתי MCP, צריך להפעיל אותם ולהגדיר אימות. מידע נוסף על שימוש בשרתי MCP מרוחקים של Google ו-Google Cloud זמין במאמר סקירה כללית על שרתי MCP של Google Cloud.
נקודות קצה של שרתים
נקודת קצה של שירות MCP היא כתובת הרשת וממשק התקשורת (בדרך כלל כתובת URL) של שרת ה-MCP, שמשמשת אפליקציית AI (המארח של לקוח ה-MCP) כדי ליצור חיבור מאובטח וסטנדרטי. הוא משמש כנקודת קשר למודל שפה גדול (LLM) כדי לבקש הקשר, להפעיל כלי או לגשת למשאב. נקודות הקצה של Google MCP יכולות להיות גלובליות או אזוריות.
לשרת ה-MCP של Google Pay ו-Wallet למפתחים יש את נקודת הקצה הגלובלית הבאה של MCP:
- https://paydeveloper.googleapis.com/mcp
כלי MCP
כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית AI כדי לבצע פעולה בעולם האמיתי.
כלים
בשרת ה-MCP paydeveloper.googleapis.com יש את הכלים הבאים:
| כלי MCP | |
|---|---|
search_documentation |
מחפש ומאחזר את הקטעים הרלוונטיים והעדכניים ביותר מתוך התיעוד הרשמי למפתחים של Google Pay ו-Google Wallet ודוגמאות קוד. |
list_merchants |
אחזור רשימה של כל הפרופילים העסקיים של מוֹכרים ב-Google Pay שמשויכים לחשבון המאומת. |
list_google_pay_integrations |
הפונקציה מחזירה את הסטטוס הנוכחי ואת פרטי ההגדרה של כל השילובים של Google Pay שמשויכים למזהה מוכר ספציפי. הוא מספק משוב מיידי על סטטוס השילוב ועל ביקורות המסמכים. |
create_merchant |
יוצר סוחר חדש עם החשבון המאומת. חובה לבקש מהמשתמש לספק את המידע הנדרש ליצירת מוכר. אל תפעילו את הכלי הזה לפני שתנסו לאסוף את המידע הנדרש ליצירת חשבון מוכר. אחרי שיוצרים את המוכר, חובה להציג למשתמש את כתובת ה-URL של התנאים וההגבלות של מסוף העסק ולתת לו הוראות לאשר אותם לפני שהוא מבצע פעולות כלשהן במוכר הזה. |
create_google_pay_integration |
יוצר שילוב של Google Pay עבור מוכר ספציפי. כדי לבצע את הפעולה הזו, המשתמש צריך לאשר את התנאים וההגבלות של מסוף העסק ואת התנאים וההגבלות של Google Pay API. אין צורך לבדוק מראש אם יש עדכונים כאלה. אם הם לא אושרו, הקריאה לכלי תיכשל והודעת השגיאה תכיל את כתובות ה-URL הספציפיות של התנאים וההגבלות שצריך לאשר. במקרה כזה, צריך להציג למשתמש את כתובות ה-URL כדי שיאשר אותן, ולהנחות אותו לנסות שוב אחרי האישור. כדי ליצור אינטראקציה עם המשתמש לפני שמפעילים את הכלי, פועלים לפי הרצף הבא: 1. קודם כל, מבקשים מהמשתמש את פריט השילוב (בשלב הזה יש תמיכה רק בשילוב לאתרים). – מבקשים את כתובת האתר. # – אם פריט השילוב הוא שילוב אפליקציה, צריך לבקש את שם חבילת ה-APK של האפליקציה ל-Android. 2. לאחר מכן, שואלים את המשתמש מהו סוג השילוב: - אם המשתמש משתמש באחד מספקי שירותי התשלום (PSP) הנתמכים שלנו (https://developers.google.com/pay/api#participating-processors), צריך לבחור באפשרות Gateway. אחרת, צריך לבחור באפשרות Direct. 3. לכל סוגי השילוב (ישיר או Gateway): - מבקשים מהמשתמש להעלות צילומי מסך (עד 1MB) של תהליך הקנייה שמשולב עם Google Pay API. כדי לקבל גישה מלאה לסביבת הייצור, אנחנו צריכים לבדוק ולאשר את תהליך הקנייה. דוגמאות: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. – עליך לבקש מהמשתמש לספק 5 צילומי מסך תומכים. מבקשים אותם אחד אחד כדי לוודא שהמיפוי נכון. כששואלים, צריך להשתמש רק בתיאורי ה-enum הידידותיים למשתמש. 4. אם סוג השילוב הוא ישיר: - אתם חייבים גם לבקש מהמשתמש לספק את מסמך האישור של PCI בפורמט PDF. כששואלים שאלה, צריך להשתמש רק בתיאור הידידותי למשתמש של ה-enum. 5. לכל קובץ שסופק, תבקש מהמשתמש לספק את נתיב המסמך או את השם שלו אם הוא נמצא בספרייה הנוכחית. ממפים אותו ל-DocumentType הנכון ומגדירים את שדה השם לשם תיאורי (לדוגמה, item_selection.png או pci_attestation.pdf) בבקשה. אל תתקשרו עם הכלי הזה לפני שתנסו לאסוף את המסמכים הנדרשים לסוג השילוב שבחרתם. |
list_pass_issuers |
הפונקציה מחזירה רשימה מקיפה של כל מנפיקי הכרטיסים שרשומים במסוף העסקי של Google Wallet שמשויך למשתמש המאומת. הכלי הזה מספק מידע חיוני למפתחים שמנהלים כרטיסים ב-Wallet, כמו כרטיסי מועדון לקוחות, כרטיסי מתנה או כרטיסי טיסה. |
list_pass_classes |
הפעולה הזו מאחזרת רשימה מקיפה של כל כרטיסי המועדון שרשומים במסוף העסקי של Google Wallet שמשויך למשתמש המאומת. הכלי הזה מספק מידע חיוני למפתחים שמנהלים כרטיסים ב-Wallet, כמו כרטיסי מועדון לקוחות, כרטיסי מתנה או כרטיסי טיסה. |
validate_pass_jwt |
הפונקציה מאמתת את ייצוג ה-JWT של הכרטיס, או את המטען הייעודי (payload) של ה-JWT שלא עבר קידוד כמחרוזת JSON של הכרטיס. |
query_merchant_performance |
הפעולה הזו מאחזרת נתוני ביצועים מצטברים ברמה גבוהה ומדדים אחרי ההטמעה של פרופיל עסק ספציפי של מוֹכר. |
query_merchant_error_metrics |
מאחזר מדדי שגיאות מפורטים של פרופיל עסק ספציפי של מוֹכר. הכלי הזה מספק פירוט מדויק של השגיאות, ומאפשר למפתחים לאתר ולפתור בעיות. |
קבלת מפרטים של כלי ה-MCP
כדי לקבל את המפרטים של כלי ה-MCP לכל הכלים בשרת MCP, משתמשים בשיטה tools/list. בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להציג רשימה של כל הכלים והמפרטים שלהם שזמינים כרגע בשרת ה-MCP.
| בקשת Curl |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |