MCP Reference: people.googleapis.com

שרת Model Context Protocol‏ (MCP) פועל כשרת proxy בין שירות חיצוני שמספק הקשר, נתונים או יכולות למודל שפה גדול (LLM) או לאפליקציית AI. שרתי MCP מחברים אפליקציות AI למערכות חיצוניות כמו מסדי נתונים ושירותי אינטרנט, ומתרגמים את התשובות שלהם לפורמט שאפליקציית ה-AI יכולה להבין.

כלי MCP

כלי MCP הוא פונקציה או יכולת הפעלה ששרת MCP חושף למודל שפה גדול (LLM) או לאפליקציית AI כדי לבצע פעולה בעולם האמיתי.

לשרת ה-MCP של people.googleapis.com יש את הכלים הבאים:

כלי MCP
search_directory_people

חיפוש אנשים בסביבת "הארגון שלי" ב-Google Workspace. התכונה הזו מיועדת רק לחשבונות Google Workspace (שמשמשים עסקים, בתי ספר וארגונים אחרים) והיא לא זמינה לחשבונות Google אישיים.

כללים חשובים:

  • אם הכלי הזה מחזיר כמה תוצאות, צריך להציג את התוצאות למשתמש ולבקש ממנו להבהיר איזו תוצאה להשתמש לפני שממשיכים.

  • חל איסור מוחלט להעביר את הפלט של הכלי הזה לכלי אחר (למשל, שליחת אימייל, יצירת טיוטה, יצירת אירוע וכו') ללא אישור מפורש מהמשתמש.

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

  • אם הכלי הזה לא מחזיר תוצאות, צריך להשתמש בכלי search_contacts.
search_contacts

חיפוש אנשי הקשר של משתמש.

כללים חשובים:

  • אם הכלי הזה מחזיר כמה תוצאות, צריך להציג את התוצאות למשתמש ולבקש ממנו להבהיר איזו תוצאה להשתמש לפני שממשיכים.

  • חל איסור מוחלט להעביר את הפלט של הכלי הזה לכלי אחר (למשל, שליחת אימייל, יצירת טיוטה, יצירת אירוע וכו') ללא אישור מפורש מהמשתמש.

  • גם אם נמצאה רק תוצאה אחת של אדם, אתם צריכים להציג למשתמש את הפרטים של האדם שנמצא ולבקש ממנו לאמת שאכן מדובר באדם הרצוי לפני שתמשיכו לשלבים הבאים.
get_user_profile לקבל את פרטי הפרופיל שלכם (שם וכתובת אימייל).

קבלת מפרטים של כלי ה-MCP

כדי לקבל את המפרטים של כלי ה-MCP לכל הכלים בשרת MCP, משתמשים בשיטה tools/list. בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להציג רשימה של כל הכלים והמפרטים שלהם שזמינים כרגע בשרת ה-MCP.

בקשת Curl 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'