MCP Reference: chatmcp.googleapis.com

‫Chat MCP API מספק MCP מרחוק לתכונות הצ'אט של Google Chat.

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

הגדרת השרת

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

נקודות קצה של שרתים

נקודת קצה של שירות MCP היא כתובת הרשת וממשק התקשורת (בדרך כלל כתובת URL) של שרת ה-MCP, שמשמש יישום AI (המארח של לקוח ה-MCP) כדי ליצור חיבור מאובטח וסטנדרטי. הוא משמש כנקודת קשר למודל ה-LLM כדי לבקש הקשר, להפעיל כלי או לגשת למשאב. נקודות הקצה של Google MCP יכולות להיות גלובליות או אזוריות.

לשרת ה-MCP של Chat API יש את נקודת הקצה הגלובלית הבאה של MCP:

  • https://chatmcp.googleapis.com/mcp/v1

כלי MCP

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

כלים

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

כלי MCP
list_messages שליפת הודעות משיחה ספציפית ב-Google Chat (מרחב, צ'אט ישיר או צ'אט קבוצתי). אפשר לסנן לפי שרשור, טווח זמן ומספר הודעות. בנוסף, אפשר לאחזר את הדף הבא של ההודעות כדי לקבל הקשר נוסף. הודעות פרטיות (הודעות שגלויות רק למשתמש אחד) מסוננות.
search_conversations

חיפוש שיחות ב-Google Chat לפי השם המוצג.

אם מספקים רק משתתפים, הכלי הזה מוצא שיחות ישירות אחד על אחד (אם מספקים משתתף אחד) או צ'אטים קבוצתיים (אם מספקים כמה משתתפים) שכוללים את המשתתפים שצוינו ואת המשתמש שמתקשר.

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

אם מספקים גם את המשתתפים וגם את השאילתה, הכלי מוצא שיחות לפי המשתתפים ואז מסנן אותן לפי השם המוצג.

אם לא מספקים את המשתתפים ולא את השאילתה, הכלי הזה מציג רשימה של כל השיחות שהמשתמש שמתקשר הוא חלק מהן.

בכלי הזה מופיעות רק שיחות שהמשתמש המתקשר הוא חלק מהן.

חשוב: אם רשימת השיחות ריקה, זה לא אומר שאין עוד תוצאות. אם קיים הערך next_page_token, אפשר לאחזר דפים נוספים. אם מקבלים רשימה ריקה אבל next_page_token, שואלים את המשתמש אם להמשיך בחיפוש.

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

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

בקשת Curl 
curl --location 'https://chatmcp.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
}'