שימוש בשרת MCP מרוחק של Agent Retrieval כדי להתחבר ל-AI ולאפליקציות מותאמות אישית

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

מה ההבדל בין שרתי MCP מקומיים לשרתי MCP מרוחקים?

שרתי MCP מקומיים

בדרך כלל פועלים במחשב המקומי ומשתמשים בזרמי הקלט והפלט הרגילים (stdio) לתקשורת בין שירותים באותו מכשיר.

שרתי MCP מרוחקים

פועלים בתשתית של השירות ומציעים נקודת קצה (endpoint) מסוג HTTP לאפליקציות AI, כדי לאפשר תקשורת בין לקוח ה-MCP של ה-AI לבין שרת ה-MCP. מידע נוסף על ארכיטקטורת MCP

ליבה ללא שמירת מצב

בגרסת MCP‏ 2026-07-28, פרוטוקול MCP משתנה מפרוטוקול דו-כיווני עם שמירת מצב (stateful) לפרוטוקול ללא שמירת מצב (stateless). כל בקשת MCP מתארת את עצמה ואפשר לנתב אותה באמצעות כותרות. אין צורך בלחיצת היד של initialize/initialized או ב-Mcp-Session-Id כי כל בקשה כוללת את כל המידע הנדרש בכותרות HTTP או בפרמטר _meta. שרתי MCP יכולים לבקש מידע נוסף שנדרש לכלי באמצעות בקשות הלוך ושוב (MRTR).

כדי לנתב ולעבד בקשות בלי לנתח את גוף הבקשה, נדרשות כמה כותרות MCP, כולל:

• כותרות שנדרשות לפי מפרט ה-MCP, כמו כותרת גרסת הפרוטוקול וכותרות בקשה רגילות.
• כותרות בהתאמה אישית שמוגדרות על ידי שרת ה-MCP. הכותרות האלה משתקפות בכותרות HTTP מסכימת הקלט של הכלי באמצעות המאפיין x-mcp-header. לדוגמה, שרת MCP יכול להגדיר כותרת מותאמת אישית כדי לציין את האזור או את מזהה הפרויקט ב- Cloud de Confiance by S3NS .

מידע נוסף על הארכיטקטורה של MCP זמין במפרט של MCP בגרסה 2026-07-28 ובשינויים העיקריים.

שרתי MCP מרוחקים של Google ושל Cloud de Confiance by S3NS

• חיפוש פשוט ומרוכז
• נקודות קצה (endpoints) מנוהלות של HTTP גלובלי או אזורי
• הרשאה פרטנית
• אבטחה אופציונלית של הנחיות ותשובות באמצעות הגנה מוגברת על המודל
• רישום מרכזי ביומן הביקורת

במאמר סקירה כללית על שרתי Google Cloud MCP מוסבר על שרתי MCP אחרים ועל אמצעי הבקרה לאבטחה ולמשילות שזמינים לשרתי Google Cloud MCP.

לפני שמתחילים

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

3. מפעילים את Agent Retrieval API, אם הוא עדיין לא מופעל.

   התפקידים שנדרשים כדי להפעיל ממשקי API

   כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

   להפעלת ה-API

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לשימוש בשרת ה-MCP של Agent Retrieval, בקשו מהאדמין להקצות לכם את התפקידים הבאים ב-IAM בפרויקט שבו אתם רוצים להשתמש בשרת ה-MCP של Agent Retrieval:

• לבצע קריאות לכלי MCP: משתמש בכלי MCP (roles/mcp.toolUser)
• קריאת משאבים של Agent Retrieval: צפייה בחיפוש וקטורי (roles/vectorsearch.viewer)

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

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

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

שרת ה-MCP של Agent Retrieval חושף רק כלים לקריאה בלבד, ולא נדרשות הרשאות כתיבה.

אימות והרשאה

שרת ה-MCP של Agent Retrieval משתמש בפרוטוקול OAuth 2.0 עם IAM לאימות ולהרשאה. כל Cloud de Confiance by S3NS הזהויות נתמכות לאימות בשרתי MCP.

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

היקפי ההרשאות של Agent Retrieval MCP OAuth

ב-OAuth 2.0 משתמשים בהיקפי הרשאות ובפרטי כניסה כדי לקבוע אם לחשבון משתמש מאומת מסוים מותר לבצע פעולה ספציפית במשאב. למידע נוסף על היקפי ההרשאות של OAuth 2.0 ב-Google, קראו את המאמר שימוש ב-OAuth 2.0 לגישה ל-Google APIs.

שרת ה-MCP של Agent Retrieval מקבל את היקף ההרשאות הבא של OAuth:

הגדרת לקוח MCP לשימוש בשרת Agent Retrieval MCP

אפליקציות וסוכני AI, כמו Claude או Antigravity, יכולים ליצור מופע של לקוח MCP שמתחבר לשרת MCP אחד. לאפליקציית AI יכולים להיות כמה לקוחות שמתחברים לשרתי MCP שונים. אם האפליקציה שלכם לא מופיעה בהנחיות הספציפיות ללקוח, תוכלו להשתמש במידע הבא כדי להתחבר מרוב האפליקציות.

באפליקציית ה-AI, מחפשים דרך להוסיף או להתחבר לשרת MCP מרוחק. בשרת ה-MCP של Agent Retrieval, מזינים את הפרטים הבאים לפי הצורך:

• שם השרת: שרת MCP של Agent Retrieval

• כתובת ה-URL של השרת או נקודת הקצה (endpoint): https://vectorsearch.googleapis.com/mcp

  נקודת הקצה היחידה הזו חושפת את כל תשעת הכלים של Agent Retrieval MCP. קריאות לכלים נשלחות לקצה העורפי הנכון באמצעות ניתוב מבוסס-כותרת.

• תעבורה: HTTP שניתן להעביר בסטרימינג

• פרטי אימות: Cloud de Confiance by S3NS פרטי הכניסה שלכם, מזהה הלקוח והסוד של OAuth או פרטי הכניסה והזהות של הסוכן. מידע נוסף על אימות בשרתי MCP

דרישות לגבי ניתוב מבוסס-כותרת ופרוטוקול לקוח

שרת ה-MCP של Agent Retrieval שולח כל tools/call בקצה הרשת על סמך שתי כותרות HTTP:

• ‫Mcp-Name – חייב להיות זהה לשם הכלי בגוף הבקשה (params.name).
• ‫Mcp-Param-Region – חייב להיות זהה לרכיב location של נתיב המשאב בגוף הבקשה (לדוגמה, us-central1 לאוסף ב-projects/PROJECT_ID/locations/us-central1/collections/COLLECTION_ID).

אם אחת מהכותרות חסרה או לא תואמת לגוף, הבקשה תידחה עם השגיאה HTTP 400 Bad Request.

לקוח ה-MCP צריך להפיק את הכותרות האלה באופן דינמי לכל tools/call. ההתנהגות הזו מוגדרת כסטנדרט בגרסה 2026-07-28 של פרוטוקול MCP ובגרסאות מתקדמות יותר. חשוב לוודא שספריית הלקוח של MCP מפרסמת לפחות את גרסת הפרוטוקול הזו במהלך לחיצת היד של initialize. לקוחות שמשתמשים בגרסאות פרוטוקול ישנות יותר, או בגרסאות SDK שלא תומכות בהנפקת כותרות דינמיות, לא יכולים להשתמש בשרת ה-MCP של Agent Retrieval דרך נקודת הקצה המאוחדת /mcp.

‫URI של הפניה לכתובת אחרת

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

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

להנחיות כלליות נוספות, אפשר לעיין במקורות המידע הבאים:

• להתחבר לשרתי MCP מרוחקים.
• הגדרת MCP באפליקציית AI.

באילו כלים אפשר להשתמש

שרת ה-MCP של Agent Retrieval חושף תשעה כלים לקריאה בלבד:

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

כלים לרשימות

משתמשים בכלי לבדיקת MCP כדי להציג רשימה של כלים, או שולחים בקשת HTTP מסוג tools/list ישירות לשרת ה-MCP של Agent Retrieval. השיטה tools/list לא דורשת אימות.

שרת ה-MCP של Agent Retrieval תומך בפרוטוקול ללא שמירת מצב (stateless) של MCP 2026-07-28, כך שכל בקשה ללא שמירת מצב מתארת את עצמה וצריך להצהיר על גרסת הפרוטוקול גם בכותרת ה-HTTP של MCP-Protocol-Version וגם בשדה ה-body של _meta.io.modelcontextprotocol/protocolVersion, יחד עם אובייקט _meta.io.modelcontextprotocol/clientCapabilities (אפשר להשתמש באובייקט ריק). כותרת ה-HTTP של Mcp-Method חייבת להתאים גם ל-method בגוף הבקשה.

curl -X POST 'https://vectorsearch.googleapis.com/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/list' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'

תרחישים לדוגמה

הנה כמה תרחישי שימוש לדוגמה בשרת ה-MCP של Agent Retrieval:

• בדיקת משאבים: הצגת רשימה של אוספים ואינדקסים בפרויקט, ובדיקת הסכימות והמטא-נתונים שלהם.
• חיפוש וקטורי וסמנטי: הרצת חיפוש וקטורי או סמנטי באוסף כדי למצוא את אובייקטי הנתונים הכי רלוונטיים לשאילתה.
• אחזור היברידי: שילוב של חיפושים סמנטיים, חיפושי טקסט וחיפושים וקטוריים בקריאה אחת באצווה, ומיזוג התוצאות באמצעות Reciprocal Rank Fusion‏ (RRF) או Vertex Ranking API.
• אחזור אובייקטי נתונים: אחזור של אובייקטי נתונים ספציפיים לפי מזהה, או שליחת שאילתה לאוסף לפי מסנן כדי לבדוק רשומות שהוטמעו.

פרומפטים לדוגמה

• "הצגת רשימה של אוספי Agent Retrieval בפרויקט PROJECT_ID ב-REGION".
• "Show the schema of collection COLLECTION_ID in region REGION"
• "Run a semantic search on collection COLLECTION_ID for QUERY_TEXT and return the top 5 nearest neighbors."
• "Do a hybrid search on collection COLLECTION_ID for QUERY_TEXT that combines semantic and text search, then rerank the top 50 with semantic-ranker-fast@latest."
• "Get the data object with ID DATA_OBJECT_ID from collection COLLECTION_ID."

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

• ‫PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance
• ‫REGION: האזור של האוסף (לדוגמה, us-central1)
• ‫COLLECTION_ID: מזהה האוסף של Agent Retrieval
• ‫DATA_OBJECT_ID: המזהה של אובייקט נתונים באוסף
• ‫QUERY_TEXT: הטקסט בשפה טבעית של השאילתה

מכסות ומגבלות

לשרת ה-MCP של Agent Retrieval אין מכסות משלו. אין הגבלה על מספר הקריאות שאפשר לבצע לשרת ה-MCP. אתם עדיין כפופים למכסות שנאכפות על ידי Agent Retrieval API, שכלי שרת ה-MCP קוראים לו בשמכם. מידע נוסף על המכסות של Agent Retrieval

המאמרים הבאים

• מידע על Agent Retrieval MCP
• איך יוצרים אוסף
• איך מחפשים אובייקטים של נתונים
• איך משנים את הדירוג של תוצאות החיפוש
• מידע נוסף על שרתי MCP של Google Cloud