12. חיבור לכלים חיצוניים (MCP)

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

מה זה MCP, במילים פשוטות

Model Context Protocol (MCP) הוא תקן פתוח לחיבור בין כלי AI לכלים חיצוניים. שרת MCP הוא תוכנה — שרצה על המחשב שלכם או כשירות מתארח — שחושפת בפני קלוד כלים ספציפיים: לחפש issue ב-Jira, לשלוח שאילתה למסד נתונים, לנווט בדפדפן. ברגע שמחברים שרת, קלוד יכול לפעול ישירות מול המערכת הזו במקום לעבוד רק ממה שאתם מדביקים לצ'אט.

דוגמאות לדברים שאפשר לבקש אחרי חיבור השרתים המתאימים:

• "תממש את הפיצ'ר שמתואר ב-JIRA-4521 ותפתח PR ב-GitHub"
• "תבדוק ב-Sentry אם יש שגיאות חדשות מהפיצ'ר האחרון"
• "תמצא לי 10 לקוחות שלא קנו ב-90 הימים האחרונים, לפי מסד הנתונים ב-PostgreSQL"
• "תעדכן את תבנית המייל שלנו לפי עיצוב הפיגמה שפורסם בסלאק"

חיבור שרת ראשון: שלב אחר שלב

נדגים עם שרת התיעוד הרשמי של Claude Code — לא דורש הרשאות ולא הרשמה, ולכן נוח לתרגול. אותו תהליך עובד לכל שרת.

1. מוסיפים את השרת: בטרמינל, מחוץ לשיחת קלוד:

   claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

   claude-code-docs הוא שם שאתם בוחרים לשרת. Claude Code מדפיס אישור ושורה שמראה איזה קובץ הגדרות הוא עדכן.
2. בודקים את הסטטוס:

   claude mcp list

   רוצים לראות ✔ Connected. סטטוסים אחרים אפשריים: ! Needs authentication (דורש התחברות בדפדפן), ✘ Failed to connect, או ⏸ Pending approval לשרתי פרויקט שעוד לא אישרתם.
3. משתמשים בשרת: פותחים שיחה ומבקשים משהו שדורש אותו:

   תשתמש בשרת claude-code-docs כדי לבדוק מה עושה MCP_TIMEOUT

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

   claude mcp remove claude-code-docs

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

ארבע דרכים לחבר שרת

בשרת מקומי (stdio), כל מה שאחרי -- מועבר לשרת בדיוק כפי שהוא, בלי ש-Claude Code ינסה לפרש את הדגלים שלו:

claude mcp add --env AIRTABLE_API_KEY=מפתח-שלכם --transport stdio airtable 
  -- npx -y airtable-mcp-server

שרת שדורש התחברות (OAuth), כמו Sentry או Notion, מוסיפים באותה פקודה, ואז פותחים /mcp בתוך שיחה, בוחרים בשרת ומאשרים דרך הדפדפן:

/mcp

הוספה ידנית מול Connectors גרפיים

claude mcp add בטרמינל היא לא הדרך היחידה:

• אפליקציית הדסקטופ של Claude Code: מוסיפים שרתים דרך ממשק ה-Connectors, בלי שורת פקודה.
• Claude Desktop (אפליקציית הצ'אט, לא Claude Code): אפליקציה נפרדת. כדי להעתיק שרתים משם ל-CLI: claude mcp add-from-claude-desktop (זמין ב-macOS וב-WSL).
• VS Code: חיבור דרך ההרחבה.
• claude.ai: Connectors שמוסיפים ב-claude.ai/customize/connectors נטענים אוטומטית ב-CLI כשמתחברים עם אותו חשבון — ראו בהמשך.

כל דרך כותבת בסוף לאותם קובצי הגדרות, כך שאפשר לערבב בין שיטות ולראות את כל השרתים יחד ב-/mcp.

היקפים (scope): למי השרת שייך

ב-Windows, ~/.claude.json הוא C:Usersשם-המשתמש.claude.json. קובעים היקף עם --scope:

# לכל הפרויקטים שלכם, פרטי
claude mcp add --scope user --transport http hubspot https://mcp.hubspot.com/anthropic

# משותף לצוות, נכנס ל-.mcp.json
claude mcp add --scope project --transport http shared-server https://example.com/mcp

שרת שהוגדר ב-project דורש אישור בתחילת שיחה, כדי שמאגר קוד ששיכפלתם לא יריץ תהליכים על המחשב שלכם בלי ידיעתכם. אם השרת מוגדר בכמה היקפים בו-זמנית, סדר העדיפות הוא: local, אחריו project, אחריו user, אחריו שרתי Plugin, ולבסוף Connectors מ-claude.ai.

ניהול שרתים עם /mcp

Connectors מ-claude.ai

אם התחברתם ל-Claude Code עם חשבון claude.ai, שרתים שהוספתם שם ב-claude.ai/customize/connectors (נקראים Connectors) זמינים אוטומטית ב-Claude Code, בלי הגדרה נוספת. הם מופיעים ב-/mcp עם סימון שמראה שהם הגיעו מ-claude.ai. Connectors שלא התחברתם אליהם מעולם מוסתרים מאחורי "Show unused connectors" כדי שלא יעמיסו על הרשימה.

שימו לב: Connectors נטענים רק כשאמצעי ההתחברות הפעיל הוא כניסה עם מנוי claude.ai — לא כשמשתמשים במפתח API, ב-Bedrock, ב-Google Cloud, או בטוקן ארוך-טווח. לכבות אותם לגמרי אפשר עם ההגדרה disableClaudeAiConnectors.

אבטחה: לסמוך רק על שרתים ידועים

עקרונות נוספים מ-פרק 7: הרשאות ובטיחות: כללי deny תקפים גם על כלי MCP (למשל mcp__github__*), ואפשר להגביל שרת ספציפי מבלי להסיר אותו לגמרי דרך /mcp.

Tool Search: למה שרתים רבים לא מייקרים כל שיחה

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

אפשר לשלוט בהתנהגות עם משתנה הסביבה ENABLE_TOOL_SEARCH:

שרת עם כמה כלים שקלוד צריך בכל תור אפשר לסמן עם "alwaysLoad": true בהגדרות שלו ב-.mcp.json, כדי שהוא תמיד ייטען מראש בלי חיפוש.

{
  "mcpServers": {
    "claude-code-docs": {
      "type": "http",
      "url": "https://code.claude.com/docs/mcp"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": { "Authorization": "Bearer ${API_KEY}" }
    }
  }
}