מילון מונחים
מילון מונחי MCP וגישה של סוכני AI
36 המונחים שהאינדקס הזה משתמש בהם, בשפה פשוטה: הרכיבים של Model Context Protocol, איך ניגשים לשרתים ואיך מתחברים אליהם, מה ה-MCP Registry מתעד, והקבצים שאתר יכול לפרסם עבור מערכות AI. כל מונח מקשר להסבר או לאינדקס שמרחיבים עליו.
הפרוטוקול
- Model Context Protocol (MCP)
- פרוטוקול פתוח לחיבור אפליקציות AI לכלים ולנתונים חיצוניים. הוא מגדיר איך אפליקציה ושרת מתארים זה לזה מה הם יכולים לעשות ומחליפים ביניהם בקשות, כך ששרת אחד עובד עם כל אפליקציה שתומכת בפרוטוקול. הוא פורסם על ידי Anthropic בנובמבר 2024 ומפותח באופן פתוח; גרסאות המפרט נקראות לפי תאריך, כמו 2024-11-05, 2025-03-26 ו-2025-06-18. מה זה שרת MCP? ←
- שרת MCP
- תוכנה שמציעה כלים, משאבים או פרומפטים לאפליקציות AI דרך MCP. השרת יכול להיות מרוחק - מופעל על ידי המפרסם שלו ונגיש בכתובת URL - או מקומי - תוכנה שמופעלת במחשב של המשתמש עצמו. שרת עוטף בדרך כלל שירות אחד או סוג נתונים אחד: מנוע הזמנות, מפה, שירות אחסון קוד, מסד נתונים. שרתים מה-MCP Registry שיש להם דף כאן ←
- לקוח MCP
- החלק באפליקציית AI שמחזיק את החיבור לשרת MCP אחד. אפליקציה שמחוברת לשלושה שרתים מריצה שלושה לקוחות, וכל אחד מהם מתקשר עם השרת שלו. איך מוסיפים שרת לעוזר AI ←
- מארח MCP (host)
- אפליקציית ה-AI שבה המשתמש עובד - עוזר צ'אט, אפליקציית דסקטופ, עורך קוד, סוכן שורת פקודה. המארח מפעיל את הלקוחות, מחליט לאילו שרתים הם מתחברים, מעביר למודל השפה את מה שהשרתים מציעים ומבקש את הסכמת המשתמש לפני ביצוע פעולות.
- כלי (Tool)
- פונקציה ששרת מציע למודל להפעיל: יש לה שם, תיאור שמסביר למודל מתי להשתמש בה, ו-JSON Schema לקלט שלה. חיפוש טיסות, הצגת לוח יציאות ויצירת issue הם כלים. המודל מחליט מתי להפעיל כלי; מארחים מבקשים בדרך כלל מהמשתמש לאשר הפעלה שמשנה משהו.
- משאב (Resource)
- נתונים ששרת מאפשר לקרוא, וכל פריט מזוהה באמצעות URI: קובץ, רשומה במסד נתונים, מסמך. בדרך כלל האפליקציה, ולא המודל, מחליטה אילו משאבים לטעון לתוך השיחה.
- פרומפט (Prompt)
- תבנית הודעה לשימוש חוזר ששרת מציע, לעיתים קרובות עם ארגומנטים, שהמשתמש בוחר באפליקציה - למשל כפקודת slash - כדי להתחיל משימה בדרך שהכין מחבר השרת.
- דגימה (Sampling)
- בקשה מהשרת ללקוח שמודל השפה של האפליקציה ייצר טקסט, כך ששרת יכול להשתמש במודל בלי מפתח API משלו. השליטה נשארת אצל המארח, והוא יכול להציג את הבקשה למשתמש.
- בקשת מידע מהמשתמש (Elicitation)
- בקשה מהשרת, דרך הלקוח, לקבל מידע נוסף מהמשתמש - תאריך חסר, אישור - שעליה עונים בטופס שהאפליקציה מציגה. נוספה במהדורה 2025-06-18 של המפרט.
- JSON-RPC 2.0
- פורמט ההודעות ש-MCP משתמש בו: כל בקשה, תגובה והתראה היא אובייקט JSON קטן. חיבור מתחיל בהחלפת initialize, שבה הלקוח והשרת מסכימים על גרסת הפרוטוקול ומצהירים על היכולות שכל אחד מהם תומך בהן.
שכבות תעבורה והתחברות
- שכבת תעבורה (Transport)
- הדרך שבה הודעות MCP עוברות בין הלקוח לשרת. המפרט מגדיר את stdio לשרתים מקומיים ואת Streamable HTTP לשרתים מרוחקים; עדיין נתקלים גם בשכבת התעבורה הקודמת, HTTP עם Server-Sent Events. הרשומה של שרת במרשם מציינת באילו שכבות תעבורה הוא תומך. שרתים לפי שכבת תעבורה ←
- stdio
- שכבת התעבורה המקומית: הלקוח מפעיל את השרת כתוכנה באותו מחשב ומחליף איתו הודעות דרך הקלט והפלט הסטנדרטיים שלו, הודעת JSON אחת בכל שורה. שום רכיב לא מאזין ברשת, והתוכנה רצה עם ההרשאות של המשתמש עצמו. שרתים מקומיים מעל stdio ←
- Streamable HTTP
- שכבת התעבורה הנוכחית לשרתים מרוחקים, שהוצגה במהדורה 2025-03-26: נקודת קצה HTTPS אחת שהלקוח שולח אליה הודעות ב-POST, והיא משיבה בתגובת JSON אחת או בזרם של Server-Sent Events. שרת יכול לנהל סשן, שמזוהה בכותרת Mcp-Session-Id. שרתים מרוחקים מעל Streamable HTTP ←
- SSE (HTTP + Server-Sent Events)
- שכבת התעבורה המרוחקת של המהדורה הראשונה (2024-11-05): הלקוח מחזיק זרם Server-Sent Events פתוח כדי לקבל הודעות, ושולח את ההודעות שלו ב-POST לכתובת URL שנייה שהשרת מציין. במהדורה 2025-03-26 היא הוחלפה ב-Streamable HTTP; לקוחות רבים עדיין תומכים בה. הסבר על שכבות התעבורה של MCP ←
- שרת מרוחק
- שרת MCP שהמפרסם שלו מפעיל ושניגשים אליו בכתובת HTTPS. אין צורך בהתקנה; המפרסם מריץ ומעדכן אותו, ומה שמבקשים ממנו עובר דרך המערכות שלו. מרוחק או מקומי? ←
- שרת מקומי
- שרת MCP שמותקן מחבילה ומופעל במחשב של המשתמש עצמו, בדרך כלל מעל stdio. הוא יכול לגשת לקבצים ולאפליקציות מקומיים, והמפתחות שלו נשמרים בתצורה של הלקוח. מרוחק או מקומי? ←
- OAuth ל-MCP (הרשאות MCP)
- הדרך שבה שרת מרוחק מבקש מהמשתמש להתחבר. חלק ההרשאות במפרט, שנוסף לראשונה במהדורה 2025-03-26, מבוסס על OAuth 2.1: הלקוח מעביר את המשתמש לדף ההתחברות של השירות עצמו, מקבל טוקן גישה ושולח אותו עם כל בקשה. מאז מהדורה 2025-06-18, שרת MCP מוגדר כשרת משאבים (resource server) של OAuth שמפרסם מטא-נתונים המציינים את שרת ההרשאות שלו (RFC 9728). הדבר חל על שכבות תעבורה מבוססות HTTP; שרת stdio מקומי מקבל את פרטי הגישה שלו ממשתני סביבה במקום זאת. לפני שמחברים שרת ←
- כותרות מוצהרות
- כותרות HTTP (headers) שהרשומה של שרת מרוחק במרשם מציינת שלקוח חייב לשלוח, כמו Authorization עם מפתח API. הרשומה מסמנת כל כותרת כחובה או כרשות, וכסודית או לא.
- משתני סביבה
- ערכים בעלי שם, לעיתים קרובות מפתחות API, ששרת מקומי קורא כשהלקוח מפעיל אותו. הרשומה במרשם מפרטת את המשתנים שהחבילה שלה מצפה להם; התצורה של הלקוח מגדירה אותם.
ה-MCP Registry
- MCP Registry
- הקטלוג הציבורי הרשמי של שרתי MCP בכתובת registry.modelcontextprotocol.io, שמופעל על ידי פרויקט MCP והושק כגרסת Preview בספטמבר 2025. הוא מחזיק מטא-נתונים בלבד - שמות, תיאורים, גרסאות, נקודות קצה וחבילות - עם API פתוח לקריאה בלבד, ומצפה שקטלוגים שנבנים עליו, כמו האינדקס הזה, יוסיפו סינון ועריכה משלהם. מה זה ה-MCP Registry הרשמי? ←
- מרחב שמות (Namespace)
- החלק בשם במרשם שלפני הלוכסן, בתבנית DNS הפוך. io.github.<account> מוקצה למי שמתחבר למרשם עם GitHub כמשתמש הזה, או עם ההרשאות שהמרשם דורש בארגון הזה (התיעוד שלו דורש כיום בעלים של הארגון); דומיין הפוך כמו com.example מוקצה למי שמוכיח שליטה ב-example.com באמצעות רשומת DNS (שמכסה גם את תת-הדומיינים שלו) או באמצעות קובץ שמוגש בנתיב /.well-known/mcp-registry-auth. מרחב השמות מראה מי פרסם רשומה, ולא שהמוצר שהרשומה עובדת איתו תומך בה. שרתים לפי מפרסם ←
- server.json
- הקובץ שמפרסם מגיש למרשם ומתאר בו שרת: השם, התיאור והגרסה שלו, כותרת, אתר ומאגר קוד אופציונליים, ואיך ניגשים אליו - כתובות מרוחקות (remotes) וחבילות (packages).
- סוגי חבילות
- מרשמי החבילות שאליהם אפשר לפרסם שרת מקומי, כפי שמצוין ברשומה שלו במרשם: npm (Node.js), PyPI (Python), אימג'ים של OCI (Docker ומרשמי קונטיינרים אחרים), NuGet (.NET), Cargo (crates של Rust) ו-MCP Bundles. הסוג מציין ללקוח איזו סביבת ריצה נדרשת. שרתים לפי מרשם חבילות ←
- חבילת npm
- חבילת Node.js ממרשם npm. לקוחות מפעילים אותה בדרך כלל עם npx, שמוריד אותה בשימוש הראשון; יש צורך ב-Node.js מותקן. שרתי npm ←
- חבילת PyPI
- חבילת Python מ-PyPI. לקוחות מפעילים אותה בדרך כלל עם uvx, מתוך הכלי uv, שמריץ אותה בסביבה מבודדת, או אחרי התקנה עם pip. שרתי PyPI ←
- אימג' OCI
- אימג' של קונטיינר במרשם OCI כמו Docker Hub או GitHub Container Registry, שמופעל עם docker run. השרת רץ בתוך הקונטיינר ולא ישירות על המחשב. שרתים באימג' של קונטיינר ←
- MCP Bundle (.mcpb)
- ארכיון יחיד שמכיל שרת MCP מקומי וקובץ manifest.json שמתאר אותו, כך שלקוח שתומך ב-bundles יכול להתקין אותו בצעד אחד. הפורמט נקרא בעבר Desktop Extensions (.dxt). שרתי MCP Bundle ←
- גרסה וסטטוס
- כל פרסום במרשם מוסיף גרסה שלא משתנה לאחר מכן; החדשה ביותר מסומנת כ-latest. הסטטוס של רשומה הוא פעילה (active), הוצאה משימוש (deprecated) או נמחקה (deleted). האינדקס הזה קורא את הגרסה האחרונה ומשמיט רשומות שהוצאו משימוש או נמחקו.
קבצים ותיאורים באתר של השירות עצמו
- llms.txt
- קובץ Markdown בשורש האתר, /llms.txt, שהוצע בספטמבר 2024 באתר llmstxt.org, שמסביר למודלי שפה מהו האתר ומקשר לדפים השימושיים ביותר שלו, כל אחד עם הערה קצרה. הוא לא מתיר ולא אוסר דבר; הוא מפה. האינדקס הזה סופר אותו כקיים רק כשהאתר משיב עם קובץ טקסט אמיתי, ולא עם דף HTML. מה כותבים בקובץ llms.txt ←
- OpenAPI
- פורמט סטנדרטי וקריא למכונה לתיאור API של HTTP - נקודות הקצה, הפרמטרים, התגובות והאימות שלו - ב-JSON או ב-YAML, שנקרא בעבר Swagger. פריימוורקים של סוכנים יכולים להפוך את הפעולות שלו לכלים. OpenAPI לסוכני AI ←
- ai-plugin.json
- מניפסט בנתיב /.well-known/ai-plugin.json שהוצג ב-2023 עבור תוספי ChatGPT: הוא נותן שם לשירות, מתאר אותו עבור המודל ומפנה לתיאור OpenAPI. מערכת התוספים הוצאה מאז משימוש, אבל חלק מהאתרים עדיין מגישים את הקובץ. OpenAPI לסוכני AI ←
- /.well-known/mcp.json
- קובץ שחלק מהאתרים מגישים כדי לתאר את שרת ה-MCP שלהם - נקודת הקצה, שכבת התעבורה וההתחברות - כך שלקוחות וקטלוגים יוכלו למצוא אותו מהדומיין בלבד. הוא אינו חלק ממהדורה שפורסמה של המפרט, והקבצים שנתקלים בהם בפועל שונים במבנה שלהם; האינדקס הזה מתעד אם אתר משיב שם עם אובייקט JSON.
- agents.json
- קובץ JSON מוצע, שמוגש בנתיב /agents.json, שמתאר את הפעולות של API ואת התהליכים מרובי השלבים שסוכן יכול לבצע באמצעותן, על בסיס OpenAPI. מעט אתרים מפרסמים קובץ כזה; האינדקס הזה מתעד אם אתר משיב שם עם אובייקט JSON.
- אפליקציית ChatGPT
- אפליקציה ששירות מפרסם בתוך ChatGPT. אפליקציות נבנות עם Apps SDK של OpenAI, שמבוסס על MCP, ויכולות להציג תוצאות אינטראקטיביות בצ'אט; המשתמש צריך לחבר אפליקציה לפני ש-ChatGPT יכול להפעיל אותה. שירותים עם אפליקציית ChatGPT ←
- מחבר Claude
- שרת MCP מרוחק שנוסף ל-Claude, מתוך ספריית המחברים של Anthropic או לפי כתובת URL, כך ש-Claude יכול לקרוא מידע מהשירות או לבצע בו פעולות אחרי שהמשתמש מחבר אותו. שירותים עם מחבר Claude ←
- API ציבורי
- API מתועד שכל אחד יכול להירשם אליו ולפנות אליו, בדרך כלל עם מפתח מהשירות. כך סוכנים שנבנו בהתאמה אישית ניגשים לשירות שאין לו שרת MCP. שירותים עם API ציבורי ←