מדריך MCP בעברית

פרק 1

מה זה MCP

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

פרוטוקול MCP (ראשי תיבות של Model Context Protocol) הוא תקן פתוח שנוצר במקור על ידי Anthropic ואומץ במהירות על ידי כלל התעשייה (כולל קלוד קוד, גרוק CLI, קלוד דסקטופ, Cursor, VS Code ועוד). הפרוטוקול מגדיר שפה אחידה ומאובטחת המאפשרת למודלי שפה גדולים לתקשר עם אפליקציות, שירותי רשת ומאגרי מידע מקומיים.

הדימוי המקובל בתעשייה הוא תקן USB-C של עולם ה-AI: בדיוק כפי שכבל USB-C מאפשר לחבר מסך, מקלדת או כונן חיצוני לכל מחשב נייד בלי להתקין כבלים ייעודיים לכל יצרן, כך שרת MCP שנכתב פעם אחת מתחבר ישירות לכל סוכן שתומך בתקן.

+----------------------------------------------------------------+
|                          HOST (המארח)                          |
|         Claude Code / Grok CLI / Cursor / Claude Desktop        |
|                                                                |
|   +---------------------+            +---------------------+   |
|   |     MCP Client      |            |     MCP Client      |   |
|   +----------+----------+            +----------+----------+   |
+--------------|----------------------------------|--------------+
               | (stdio)                          | (Streamable HTTP)
               v                                  v
+-----------------------------+    +-----------------------------+
|    Local MCP Server (תהליך)  |    |    Remote MCP Server (ענן)   |
|  Filesystem, Postgres, Git  |    |     Linear, Sentry, Notion  |
+-----------------------------+    +-----------------------------+

#הבעיה ש-MCP פותר: סוף לפרגמנטציה

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

  • חיבור גיטהאב לקלוד דרש פורמט אחד.
  • חיבור אותו גיטהאב לגרוק CLI דרש פורמט אחר.
  • חיבור ל-Cursor דרש תוסף נפרד.
  • כל שינוי ב-API של השירות החיצוני שבר את כל האינטגרציות בו-זמנית.

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

#שלושת הגורמים בארכיטקטורה

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

תפקידהגדרהדוגמאות בפועל
Host (מארח)האפליקציה הראשית שבה המשתמש מנהל את השיחה והסוכן פועל. המארח מנהל את הרשאות האבטחה, מרחב ההקשר (Context) וממשק המשתמש.קלוד קוד (Claude Code), גרוק CLI, סביבת העבודה Cursor, אפליקציית Claude Desktop.
Client (לקוח)רכיב התקשורת הפנימי בתוך המארח שמחזיק חיבור ישיר מול שרת MCP בודד (יחס 1:1).לקוח ה-MCP המובנה בקלוד או בגרוק, המתאם הודעות JSON-RPC.
Server (שרת)תוכנית קלת-משקל שחושפת יכולות, משאבים ותבניות דרך הפרוטוקול. השרת יכול לרוץ כמחשב מקומי או כשירות מרוחק ברשת.שרת קבצים מקומי, שרת חיבור ל-PostgreSQL, שרת Linear, שרת Sentry, שרת GitHub.

#שלושת המרכיבים ששרת MCP חושף

שרת MCP חושף למודל שלושה סוגי יכולות בסיסיות (Primitives):

  1. כלים (Tools): פונקציות ביצועיות שהמודל יכול להפעיל באופן יזום. לכל כלי יש שם, תיאור שמסביר מתי כדאי להשתמש בו, וסכמת קלט מוגדרת (JSON Schema). לדוגמה: create_issue, query_database, send_slack_message.
  2. משאבים (Resources): נתונים ומסמכים לקריאה בלבד שהלקוח או המשתמש יכולים לצרף להקשר השיחה לפי כתובת URI ייחודית. לדוגמה: קריאת קובץ לוג חי file:///var/log/app.log או סכמת בסיס נתונים postgres://public/schema.
  3. תבניות שיחה (Prompts): תבניות מוכנות מראש שהשרת מציע למשתמש כדי להפעיל תהליכי עבודה נפוצים. לדוגמה: תבנית לסקירת קוד, ניפוי שגיאה או יצירת דוח שבועי.

#שתי דרכי תעבורה עיקריות

פרוטוקול MCP מגדיר שני אפיקי תעבורה (Transports) עיקריים להעברת הודעות JSON-RPC:

  • תעבורת stdio (תהליך מקומי): המארח מפעיל תהליך מקומי ישירות על המחשב שלכם ומנהל איתו ערוץ קלט/פלט סטנדרטי (stdin/stdout). זוהי הדרך המועדפת לעבודה מול מערכת הקבצים המקומית, מסדי נתונים מקומיים או כלי פיתוח פרטיים.
  • תעבורת Streamable HTTP (שרת מרוחק): תקשורת מודרנית מבוססת HTTP עם תמיכה בהזרמת אירועים (Server-Sent Events / SSE) ואימות מאובטח (Bearer Token או OAuth 2.0). מתאימה לשירותי ענן כמו Linear, Sentry, Notion ושרתי צוות ארגוניים.

#דוגמה מעשית: איך זה נראה בזמן אמת

בלי MCP, כאשר אתם רוצים לברר מהו סטטוס הבאג במערכת המעקב:

  1. אתם פותחים דפדפן ונכנסים ל-Linear או Jira.
  2. מחפשים את מספר הטיקט ומעתיקים את תוכנו.
  3. מדביקים את הטקסט בחלון הצ'אט של הסוכן.
  4. מבקשים מהסוכן לתקן את הקוד.
  5. מעתיקים את הפתרון של הסוכן חזרה לטיקט וסוגרים אותו ידנית.

עם שרת MCP מחובר:

  1. אתם כותבים לסוכן: "תבדוק מה הטיקט הפתוח על שגיאת ההתחברות, תתקן את הקוד בפרויקט ותעדכן את הטיקט".
  2. הסוכן מפעיל את הכלי linear__get_issue, קורא את תיאור התקלה ישירות מהענן.
  3. הסוכן מאתר את הקובץ המתאים, מתקן את הבאג ומריץ בדיקות מקומיות.
  4. הסוכן מפעיל את הכלי linear__add_comment ומשאיר תגובה עם פרטי התיקון, כולל קישור לקומיט.

#מבנה המדריך

במדריך זה נלמד צעד אחר צעד כיצד לשלוט באופן מלא בפרוטוקול MCP:

  • פרק 2: מתי לבחור ב-MCP ומתי להעדיף סקילים או פקודות מערכת מובנות.
  • פרק 3: הבדלים מעשיים בין תעבורת stdio לתעבורת HTTP.
  • פרקים 4 ו-5: התקנה והגדרה מפורטת בקלוד קוד (Claude Code) ובגרוק CLI (Grok CLI).
  • פרקים 6 עד 8: גילוי כלים, ניהול אימות ו-OAuth, וקטלוג שרתים מובילים מהתעשייה.
  • פרקים 9 עד 11: הקמת צי שרתים ארגוני, תאימות בין סביבות פיתוח ומודל הרשאות ואבטחה.
  • פרקים 12 עד 14: אבחון תקלות, בניית שרת MCP עצמאי ומלכודות נפוצות שחובה להכיר.