הגדרת שרת MCP של People API

‫People API מציע שרת מרוחק של Model Context Protocol ‏ (MCP) שמאפשר לסוכני AI לקיים אינטראקציה מאובטחת עם נתונים של פרופילים ואנשי קשר ב-Google Workspace. הגדרת שרת MCP של People API מאפשרת לאפליקציות AI כמו Google Antigravity ו-Claude לבצע פעולות באמצעות People API.

שרת ה-MCP של People API מספק דרך סטנדרטית לסוכני AI לבצע את הפעולות הבאות:

  • קריאת נתונים: אחזור פרופילי משתמשים וחיפוש אנשי קשר או אנשים בספרייה.
  • שמירה על אבטחה: יורשים את אותן הרשאות ואמצעי בקרה לניהול נתונים כמו המשתמש.

דרישות מוקדמות

הגדרת שרת MCP של People API

כדי להשתמש בשרת MCP של People API, צריך להפעיל אותו בפרויקט בענן של Google ואז להגדיר את לקוח ה-MCP כך שיתחבר אליו.

הפעלת ה-API ושירות ה-MCP

כדי להשתמש בשרת ה-MCP של People API, צריך להפעיל את השירות הבא בפרויקט Google Cloud:

  • People API

CLI

gcloud services enable people.googleapis.com --project=PROJECT_ID

מחליפים את PROJECT_ID במזהה הפרויקט ב-Google Cloud.

המסוף

מפעילים את ממשקי ה-API במסוף Google Cloud:

הפעלת ממשקי ה-API

שרת ה-MCP של People API משתמש ב-OAuth 2.0 לאימות ולהרשאה. כדי ליצור מספר לקוח OAuth, צריך להגדיר קודם את מסך ההסכמה ל-OAuth.

  1. במסוף Google Cloud, עוברים אל Google Auth Platform ‏> Branding.

    מעבר לדף Branding

  2. אם כבר הגדרתם את פלטפורמת האימות של Google, אתם יכולים לקבוע את ההגדרות הבאות של מסך ההסכמה ל-OAuth בקטעים Branding,‏ Audience וData Access. אם מופיעה ההודעה Google Auth Platform not configured yet, לוחצים על Get Started:

    1. בקטע App Information (פרטי האפליקציה), בשדה App name (שם האפליקציה), מקלידים People API MCP Server.
    2. בקטע User support email, בוחרים את כתובת האימייל או קבוצת Google המתאימה.
    3. לוחצים על הבא.
    4. בקטע Audience, לוחצים על Internal. אם אי אפשר לבחור באפשרות פנימי, בוחרים באפשרות חיצוני.
    5. לוחצים על הבא.
    6. בקטע Contact Information, מזינים כתובת אימייל שאליה אפשר לשלוח התראות על שינויים בפרויקט.
    7. לוחצים על הבא.
    8. בקטע Finish, קוראים את המדיניות של Google בנושא נתוני משתמשים בשירותי API. אם אתם מסכימים, מסמנים את התיבה I agree to the Google API Services: User Data Policy.
    9. לוחצים על המשך.
    10. לוחצים על יצירה.
    11. אם בחרתם באפשרות חיצוני לסוג המשתמש, מוסיפים משתמשי בדיקה:
      1. לוחצים על קהל.
      2. בקטע משתמשי בדיקה, לוחצים על הוספת משתמשים.
      3. מזינים את כתובת האימייל שלכם ושל משתמשים מורשים אחרים לבדיקה, ואז לוחצים על שמירה.

  3. לוחצים על גישה לנתונים > הוספה או הסרה של היקפי גישה. יופיע חלונית עם רשימה של היקפי הרשאות לכל API שהפעלתם בפרויקט Google Cloud.

    1. בקטע Manually add scopes (הוספת היקפי גישה באופן ידני), מדביקים את היקפי הגישה לשרת MCP של People API:

      • https://www.googleapis.com/auth/directory.readonly
      • https://www.googleapis.com/auth/userinfo.profile
      • https://www.googleapis.com/auth/contacts.readonly

    2. לוחצים על הוספה לטבלה.

    3. לוחצים על עדכון.

    4. אחרי שבוחרים את היקפי ההרשאות שנדרשים לאפליקציה, לוחצים על שמירה בדף גישה לנתונים.

הגדרת לקוח MCP

כדי להוסיף את שרת ה-MCP המרוחק של People API ללקוח ה-MCP, פועלים לפי ההוראות של הלקוח.

Antigravity

כדי להוסיף את שרת ה-MCP המרוחק של People API ל-Antigravity, צריך להוסיף את הגדרות השרת לקובץ mcp_config.json. ההוראות האלה תומכות ב-Antigravity 2.0, ב-Antigravity IDE וב-Antigravity CLI.

  1. יוצרים מזהה לקוח וסוד לקוח ב-OAuth 2.0:

    1. במסוף Google Cloud, עוברים אל Google Auth Platform ‏> ‏Clients ‏> ‏Create Client.

      מעבר אל Create Client

    2. בוחרים באפשרות Web application (אפליקציית אינטרנט) כסוג האפליקציה.

    3. הזן שם.

    4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI) ואז מוסיפים את https://antigravity.google/oauth-callback בשדה URIs (כתובות URI).

    5. לוחצים על Create ומעתיקים את מזהה הלקוח ואת סוד הלקוח.

  2. פותחים או יוצרים את קובץ ההגדרות ~/.gemini/antigravity/mcp_config.json.

  3. מוסיפים את ההגדרה mcpServers אל mcp_config.json:

    {
  "mcpServers": {
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫OAUTH_CLIENT_ID: מזהה הלקוח שיצרתם.
    • ‫OAUTH_CLIENT_SECRET: סוד הלקוח שיצרתם.

  4. חיסכון של mcp_config.json.

  5. מאמתים את שרת ה-MCP. אפשר לבצע אימות באמצעות הגדרות ממשק המשתמש הגרפי או ה-CLI:

    • ב-Antigravity IDE או GUI‏ (Antigravity 2.0):

      1. פותחים את מסך ההגדרות (למשל, לוחצים על הגדרות בפינה הימנית התחתונה או פותחים את הגדרות המשתמש של Antigravity).
      2. עוברים אל התאמות אישיות.
      3. בקטע Installed MCP Servers (שרתי MCP מותקנים), לוחצים על Refresh (רענון).
      4. מחפשים את people ברשימה, לוחצים על Authenticate (אימות), נכנסים לחשבון Google, מעתיקים את קוד ההרשאה, מדביקים אותו בתיבת הדו-שיח של הקלט ולוחצים על Submit (שליחה).

    • ב-Antigravity CLI:

      1. מפעילים את Antigravity CLI:

        agy

      2. כדי לפתוח את חלונית הניהול האינטראקטיבית של MCP, מריצים את הפקודה:

        /mcp

      3. משתמשים במקשי החיצים כדי לבחור באפשרות people, עוברים לפעולה Authenticate ומקישים על Enter. משלימים את תהליך הכניסה בדפדפן, מעתיקים את קוד ההרשאה, מדביקים אותו בהנחיית הטרמינל ולוחצים על Enter.

  6. מוודאים שהשרת מוגדר ופועל בצורה נכונה:

    • ב-Antigravity IDE או GUI: לחצן יציאה מוצג לצד השרת בקטע התאמות אישיות > שרתי MCP מותקנים.
    • ב-Antigravity CLI: פותחים את החלונית /mcp כדי לראות את שרתי ה-MCP שהוגדרו. בשרתים מאומתים ומאומתים מוצג הכיתוב Authed לצד השמות שלהם בחלונית האינטראקטיבית של TUI. אפשר לבחור כל שרת בתצוגת לוח הבקרה כדי לבדוק את הסטטוס שלו ולראות רשימה של כל הכלים שזמינים בו.

שרת ה-MCP המרוחק מוכן לשימוש ב-Antigravity.

Claude

כדי להשתמש בשרת MCP מרוחק של People API עם Claude.ai או Claude Desktop, צריך מינוי לתוכנית Claude Enterprise,‏ Pro,‏ Max או Team.

כדי להוסיף את שרת ה-MCP המרוחק של People API ל-Claude, צריך להגדיר מחבר מותאם אישית עם מזהה לקוח וסוד לקוח ב-OAuth.

  1. יוצרים מזהה לקוח וסוד לקוח ב-OAuth 2.0:

    1. במסוף Google Cloud, עוברים אל Google Auth Platform ‏> ‏Clients ‏> ‏Create Client.

      מעבר אל Create Client

    2. בוחרים באפשרות Web application (אפליקציית אינטרנט) כסוג האפליקציה.

    3. הזן שם.

    4. בקטע Authorized redirect URIs (כתובות URI מורשות להפניה אוטומטית), לוחצים על + Add URI (הוספת כתובת URI), ואז מוסיפים את https://claude.ai/api/mcp/auth_callback בשדה URIs (כתובות URI).

    5. לוחצים על Create ומעתיקים את מזהה הלקוח ואת סוד הלקוח.

  2. מגדירים את שרת ה-MCP ב-Claude:

    1. ב-Claude.ai או ב-Claude Desktop, עוברים אל Settings (הגדרות) (או אל Admin settings (הגדרות אדמין)) > Connectors (מחברים).
    2. לוחצים על הוספת מחבר בהתאמה אישית.
    3. מזינים את פרטי החיבור למוצר People API:
      • שם השרת: people.
      • כתובת ה-URL של שרת ה-MCP המרוחק: https://people.googleapis.com/mcp/v1
    4. בהגדרות מתקדמות, מזינים את מזהה הלקוח ב-OAuth ואת סוד הלקוח ב-OAuth.
    5. לוחצים על הוספה.

אחרים

להרבה אפליקציות AI יש דרכים להתחבר לשרת MCP מרוחק. בדרך כלל צריך להזין פרטים על השרת, כמו השם שלו, נקודות הקצה, פרוטוקול התעבורה ושיטת האימות. עבור שרת ה-MCP המרוחק של People API, מזינים את הפרטים הבאים:

  • שם השרת: people

  • כתובת ה-URL של השרת: https://people.googleapis.com/mcp/v1

  • Transport: HTTP

  • אימות: שרת ה-MCP המרוחק של People API משתמש ב-OAuth 2.0. פרטים נוספים זמינים במאמר מידע על אימות והרשאה.

לפרטים נוספים על חיבור סוגים שונים של לקוחות, אפשר לעיין במאמר בנושא הגדרת MCP באפליקציית AI.

בדיקת שרת ה-MCP של People API

אחרי שמגדירים את לקוח ה-MCP, אפשר לוודא שהחיבור תקין על ידי הפעלת כמה הנחיות לבדיקה.

כדאי לשאול את הלקוח של פלטפורמת ה-MCP את השאלות הבאות:

  • "מה השם שלי לפי הפרופיל שלי ב-Google?"

    הלקוח משתמש ב-people.get_user_profile כדי לאחזר את פרטי הפרופיל שלכם ב-Google Workspace.

אם הכלים פועלים בהצלחה ואתם מקבלים תגובות רלוונטיות, שרת ה-MCP של People API מוגדר בצורה נכונה.

פתרון בעיות

אם נתקלים בבעיות בהתחברות לשרת ה-MCP, אפשר לבדוק אם יש שגיאות ביומני OAuth. צריך לבקש מהאדמין לבדוק את האירועים ביומן של OAuth בכלי לחקירת אבטחה.

מאמרי עזרה על הכלי

הכלים הבאים זמינים בשרת ה-MCP של People API:

  • get_user_profile
  • search_contacts
  • search_directory_people

שיקול אבטחה חשוב: החדרת פרומפטים עקיפה

כשחושפים מודל שפה לנתונים לא מהימנים, יש סיכון למתקפת החדרת פרומפטים עקיפה. לספקי MCP כמו Google Antigravity יש גישה לכלים ולממשקי API עוצמתיים דרך שרת ה-MCP של People API, ולכן הם יכולים לקרוא נתונים בחשבון Google שלכם.

כדי לצמצם את הסיכונים האלה, צריך לסנן את הפרומפטים והתשובות כדי לזהות תוכן זדוני או מתקפות של הזרקת פרומפטים. אתם יכולים להשתמש ב-Model Armor ש-Google מספקת, או להשתמש בפתרון משלכם אם תתעדו אותו כדי שהמשתמשים יוכלו לקבל את הסיכון הזה. מידע נוסף זמין במאמר הגדרת אבטחה לשרתי MCP של Google Workspace.

כדאי לפעול לפי השיטות המומלצות הבאות:

  • השתמשו רק בכלים מהימנים. אל תחברו אף פעם שרת MCP של People API לאפליקציות לא מהימנות או לא מאומתות.
  • צריך להיזהר מקלט לא מהימן. מומלץ להימנע מבקשה מלקוח ה-MCP לעבד משאבים ממקורות לא מאומתים. יכול להיות שהקלט הזה מכיל הוראות נסתרות שיכולות להשתלט על הסשן שלכם, ולאפשר לתוקף לשנות, לגנוב או למחוק את הנתונים שלכם.
  • בודקים את כל הפעולות. חשוב תמיד לבדוק בקפידה את הפעולות שמבצע לקוח ה-AI בשמכם כדי לוודא שהן נכונות ותואמות לכוונות שלכם.