זהו שרת MCP שמספק כלים לתשלום למפתחים.
שרת 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 Developer API יש את נקודת הקצה הגלובלית הבאה של 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 שמשויכים למזהה סוחר ספציפי. הוא מספק משוב מיידי על סטטוס השילוב ועל ביקורות המסמכים. בנוסף, עליך להודיע למשתמש שאפשר ליצור או לעדכן את השילוב במסוף Google Pay ו-Wallet (https://pay.google.com/business/console/). |
create_merchant |
יוצר סוחר חדש עם החשבון המאומת. חובה לבקש מהמשתמש לספק את המידע הנדרש ליצירת מוכר. אחד משדות החובה הוא קוד הקטגוריה של המוֹכר (MCC). הרשימה של חשבונות הניהול ארוכה, ולכן אפשר להציג רק חלק מהאפשרויות הנפוצות, אבל חובה להודיע למשתמש שיש עוד אפשרויות ושהוא יכול לבקש את הרשימה המלאה (למשל, באמצעות הצגת הכיתוב 'X אפשרויות נוספות' או רמז דומה). בנוסף, צריך להודיע למשתמש שהוא יכול לספק ישירות את קוד ה-MCC בן 4 הספרות (למשל, 5499) אם הוא כבר יודע אותו, ולעודד אותו להשתמש בו. אל תתקשרו לכלי הזה לפני שתנסו לאסוף את המידע הנדרש ליצירת חשבון של מוֹכרים. אחרי שיוצרים את המוכר, חובה להציג למשתמש את כתובת ה-URL של התנאים וההגבלות של מסוף העסק ולתת לו הוראות לאשר אותם לפני שהוא מבצע פעולות כלשהן במוכר הזה. |
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 |
מאחזר מדדי שגיאות מפורטים של פרופיל עסק ספציפי של מוֹכר. הכלי הזה מספק פירוט מדויק של השגיאות, ומאפשר למפתחים לזהות ולפתור בעיות. |
update_merchant |
מעדכן שדות ספציפיים של סוחר קיים. השדות הנתמכים כוללים את display_name, mcc, corporate_website_url, customer_support_website_url, customer_support_email ו-customer_support_phone. |
list_principals |
רשימה של הגורמים (משתמשים) שיש להם גישה למוֹכר ספציפי. כדי לבצע את הפעולה הזו, נדרשת גישת אדמין לחשבון של המוכר. |
set_principal_role |
הפונקציה מגדירה את התפקיד של חשבון משתמש אצל מוֹכר, או מוסיפה חשבון משתמש חדש עם התפקיד שצוין. הגורם המרכזי מקבל הזמנה באימייל, והוא צריך לאשר אותה כדי שהגישה שלו תהיה פעילה. כדי לבצע את הפעולה הזו, נדרשת גישת אדמין לחשבון של המוכר. |
delete_principal |
מוחק את הגישה של גורם מרכזי (משתמש) למוֹכר ספציפי. כדי לבצע את הפעולה הזו, נדרשת גישת אדמין לחשבון של המוכר. |
קבלת מפרטים של כלי ה-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 }' |