פרק 4

MCP בקלוד קוד

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

#דרישות מקדימות

לפני שמוסיפים שרת ראשון:

ודאו ש-Claude Code מותקן ותקין במערכת (הרצת claude --version).
פתחו חלון טרמינל בתיקיית הפרויקט שבו תרצו לעבוד.
ודאו שסביבת Node.js זמינה אם אתם מתכננים להריץ שרתי stdio מבוססי npx.

#הוספת שרתי MCP (פקודת `claude mcp add`)

קלוד קוד מספק פקודת CLI ייעודית להוספת שרתים בצורה מהירה ומובנית.

#1. הוספת שרת HTTP מרוחק

חיבור לשירות ענן הפועל בתעבורת HTTP:

claude mcp add --transport http notion https://mcp.notion.com/mcp

חיבור עם כותרת אימות קבועה (Authorization Header):

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp \
  --header "Authorization: Bearer sntrys_your_token_value"

חיבור עם מספר כותרות מותאמות:

claude mcp add --transport http internal-api https://api.internal.corp/mcp \
  --header "Authorization: Bearer my_token" \
  --header "X-Workspace-ID: ws_9941"

#2. הוספת שרת stdio מקומי

חיבור לשרת מקומי המופעל דרך npx:

claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server

העברת משתני סביבה לשרת ה-stdio (דגל --env):

claude mcp add --env AIRTABLE_API_KEY=key_secret123 --env AIRTABLE_BASE_ID=app_base456 \
  --transport stdio airtable -- npx -y airtable-mcp-server

חיבור שרת מערכת קבצים עם נתיב מורשה:

claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem /home/user/workspace/app

תזכורת חשובה: תמיד הציבו את התו -- לפני פקודת השרת כדי שהדגלים של npx לא ייקראו כדגלים של קלוד.

#היכן נשמרות ההגדרות: הבדלים בין Scopes

קלוד קוד תומך בשתי רמות הגדרה (Scopes):

רמת משתמש (User / Global): ההגדרות נשמרות בקובץ ~/.claude.json בתיקיית הבית של המשתמש. שרתים שמוגדרים כאן יהיו זמינים בכל פרויקט ובכל תיקייה במחשב.
רמת פרויקט (Project): ההגדרות נשמרות בקובץ .mcp.json בשורש המאגר (Repository). הגדרה זו מאפשרת לשתף את תצורת השרתים עם כל חברי הצוות דרך Git.

כדי לשמור שרת ברמת הפרויקט, הוסיפו את הדגל --scope project:

claude mcp add --scope project --transport http linear https://mcp.linear.app/mcp

מבנה קובץ .mcp.json לדוגמה בשורש הפרויקט:

{
  "mcpServers": {
    "linear": {
      "transport": "http",
      "url": "https://mcp.linear.app/mcp"
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./data"]
    }
  }
}

#ניהול והסרת שרתים מה-CLI

רשימת כל השרתים המוגדרים והסטטוס שלהם:

claude mcp list

הצגת פרטי שרת ספציפי:

claude mcp get notion

הסרת שרת מהמערכת:

claude mcp remove notion

להסרת שרת שהוגדר ברמת הפרויקט:

claude mcp remove --scope project notion

#עבודה אינטראקטיבית בתוך סשן קלוד (פקודת `/mcp`)

במהלך עבודה בסשן פעיל של קלוד קוד, תוכלו לכתוב /mcp וללחוץ Enter:

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

#מנגנון אמון בתיקיות (Workspace Trust)

כדי להגן על המחשב שלכם מהרצת פקודות זדוניות בעת שיבוט (Clone) של מאגרי קוד זרים, קלוד קוד לא יריץ באופן אוטומטי שרתי stdio שהוגדרו בקובץ .mcp.json בפרויקט חדש.

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

#בידוד שמות כלים (Namespacing)

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