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

מהות הכלי

מה זה 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 עצמאי ומלכודות נפוצות שחובה להכיר.

כל הפרקים

מה זה MCP

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

מתי צריך MCP

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

שתי התעבורות

השוואה מעמיקה בין תעבורת stdio מקומית לתעבורת Streamable HTTP מרוחקת - איך הן עובדות, מתי לבחור בכל אחת, ואיך מונעים תקלות נפוצות.

MCP בקלוד קוד

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

MCP בגרוק CLI

מדריך מקיף לחיבור וניהול שרתי MCP ב-Grok CLI - פקודות add ו-doctor, קבצי config.toml, מסך /mcps, ומנגנון גילוי הכלים search_tool ו-use_tool.

שמות כלים וגילוי

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

OAuth וסודות

עקרונות אבטחה, אימות OAuth 2.0 אינטראקטיבי, שמירת טוקנים מאובטחת, ושיטות עבודה למניעת דליפת מפתחות API ל-Git.

שרתים שמשתמשים בהם

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

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

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

תאימות בין כלים

שיתוף שרתי MCP בצורה שקופה בין קלוד קוד, גרוק CLI, Cursor ו-VS Code - סדר עדיפויות, מנוע התאימות של גרוק וניהול קבצי פרויקט משותפים.

אמון והרשאות

מודל האבטחה וההרשאות של MCP - מניעת התקפות Prompt Injection, ניהול אמון בתיקיות (Folder Trust), וכללי deny קשיחים לחסימת כלים מסוכנים.

אבחון

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

בניית שרת קטן

מדריך מעשי לפיתוח שרת MCP עצמאי ב-Python (עם FastMCP) וב-TypeScript (עם ה-SDK הרשמי) - הגדרת כלים, סכמות Zod ובדיקה ב-MCP Inspector.

מלכודות וטיפים

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