תיעוד 40

התחברות לשרתי MCP

הוספת שרת MCP ל-Claude Code, אימות החיבור ומציאת קובץ ההגדרות בדיסק.

הפרוטוקול Model Context Protocol (MCP) מאפשר ל-Claude Code להשתמש בכלים מעבר לסט המובנה שלו, כגון חיפוש במערכת מעקב אחר תקלות (issue tracker), ביצוע שאילתות במסד נתונים או שליטה בדפדפן אינטרנט. כלים אלה מגיעים משרתי MCP, אשר רצים במחשב שלך או כשירותים מתארחים (hosted services).

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

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

לכל הדרכים להתחבר ולהגדיר שרתי MCP ב-Claude Code, ראה את מדריך הייחוס של MCP.

#לפני שמתחילים

וודא שיש לך:

Claude Code מותקן ומאומת
מסוף (terminal) פתוח בתיקיית פרויקט. כל תיקייה מתאימה, כולל תיקייה ריקה.

#הוספה ואימות של שרת

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

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

הוספת שרת ה-MCP

רשום את השרת ב-Claude Code. הרץ זאת במסוף שלך, ולא בתוך הפעלה של claude: אתה מגדיר את השרת לפני תחילת שיחה.
```
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
```
חלקי הפקודה:
- claude mcp add: רושם שרת ב-Claude Code.
- --transport http: השרת מתארח בכתובת URL ולא רץ כתהליך מקומי.
- claude-code-docs: שם שאתה ממציא. שימוש בשם docs עבור אותו שרת יעבוד באופן זהה. Claude Code משתמש בכל שם שתבחר כדי לתייג את כלי השרת בפלט של Claude, וכדי להתייחס לשרת בפקודות כמו claude mcp remove.
- https://code.claude.com/docs/mcp: כתובת ה-URL שבה השרת מתארח.
הפקודה מדפיסה אישור כגון Added HTTP MCP server claude-code-docs with URL: https://code.claude.com/docs/mcp to local config, ולאחריו שורה File modified: המציגה את קובץ ההגדרות שנכתב. החלק local config אומר שהשרת רשום עבורך, בפרויקט זה: אם תפעיל את Claude Code בפרויקט אחר, שרת זה לא יהיה פעיל שם. כדי לרשום שרת פעם אחת עבור כל הפרויקטים שלך, הוסף אותו ברמת משתמש (user scope), כפי שמוסבר ב-שינוי רמת השרת.

בדיקת סטטוס החיבור

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

claude mcp list

השרת מופיע עם מחוון סטטוס:

סטטוס	משמעות
`✔ Connected`	מוכן לשימוש. זה מה שאתה אמור לראות עבור `claude-code-docs`
`! Connected · tools fetch failed`	השרת התחבר אך לא הצליח להביא את רשימת הכלים שלו. הרץ `claude mcp get <name>` לקבלת פרטי השגיאה
`! Needs authentication`	השרת נגיש אך דורש כניסה דרך הדפדפן, או טוקן שמועבר עם `--header`. ראה חיבור שרת הדורש כניסה
`✘ Failed to connect`	השרת לא הגיב. ראה פתרון בעיות
`✘ Connection error`	ניסיון החיבור נתקל בשגיאה. ראה פתרון בעיות
⏸ Pending approval (run `claude` to approve)	שרת ברמת פרויקט שעדיין לא אישרת. ראה עריכת .mcp.json ישירות
`⊘ Disabled for this project (re-enable via /mcp)`	שרת שכובה עבור פרויקט זה באמצעות רשימת `disabledMcpServers` של הפרויקט. ראה השבתת שרת מבלי להסיר אותו

מסופי Windows ישנים מסוימים, כגון מסוף ברירת המחדל ב-Windows 10, אינם תומכים בתווי Unicode אלה ומציגים √ ו-× במקום ✔ ו-✘.

שימוש בשרת

התחל הפעלה ובקש מ-Claude להשתמש בשרת החדש לפי שמו:
```
claude
```
```
Use the claude-code-docs server to look up what MCP_TIMEOUT does
```
מידע: בדרך כלל אינך צריך לציין שם שרת בהנחיה שלך, מכיוון ש-Claude בוחר כלים רלוונטיים בעצמו. ציון שמו כאן מבטיח שההדגמה תתבצע דרך השרת החדש ולא דרך כלי אחר, כגון שליפת רשת (web fetch), שיכול לענות על אותה שאלה.

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

שלב זה הוא אופציונלי. כשתסיים להתנסות, תוכל להסיר את השרת:
```
claude mcp remove claude-code-docs
```
הפקודה מאשרת עם Removed MCP server "claude-code-docs" from local config ושורה File modified: המציגה את הקובץ שהיא עדכנה.

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

#היכן נשמרים שרתים

הפקודה claude mcp add כותבת את פרטי השרת לקובץ הגדרות. כברירת מחדל היא רושמת את השרת ברמת local: פרטי עבורך, ופעיל רק בפרויקט הנוכחי. העבר --scope user כדי לרשום אותו פעם אחת עבור כל הפרויקטים שלך, או --scope project כדי לשתף אותו עם חברי הצוות. החלק שינוי רמת השרת מלווה את שני המקרים.

הערה: הפקודה claude mcp add פועלת באופן זהה בכל מעטפת (shell), כולל PowerShell ו-Command Prompt. בתוך הפעלה של claude, השתמש בפקודה /mcp כדי לבדוק ולנהל שרתים שכבר הוספת.

קיימות דרכים נוספות להוספת שרת, שכל אחת מהן מוסברת בהמשך דף זה:

הוספת שרת מקומי: הפעלת תוכנית במחשב שלך במקום להתחבר לכתובת URL.
עריכת .mcp.json ישירות: כתיבת רשומת ה-JSON בעצמך במקום להשתמש בפקודה.
חיבור שרת הדורש כניסה: הוספת שרת מתארח שדורש כניסה דרך הדפדפן לפני שהכלים שלו פועלים.

#מציאת ההגדרות שלך בדיסק

הפקודה claude mcp add כותבת את השרת לאחת משלוש רמות (scopes), המאוחסנות בשני קבצים, בהתאם לדגל --scope. אין צורך לערוך קבצים אלה ישירות, אך הידיעה היכן הם נמצאים מסייעת בניפוי שגיאות ובבקרת גרסאות.

רמה (`Scope`)	קובץ	זמין עבור
`local`	`~/.claude.json`, תחת הרשומה עבור פרויקט זה	רק אתה, רק פרויקט זה. ברירת המחדל
`project`	`.mcp.json` בתיקיית השורש של הפרויקט שלך	כל מי שמשכפל את הפרויקט
`user`	`~/.claude.json`, תחת המפתח `mcpServers` ברמה העליונה	רק אתה, כל הפרויקטים

ב-Windows, הנתיב ~/.claude.json מפוענח כ-%USERPROFILE%\.claude.json, בדרך כלל C:\Users\YourName\.claude.json. אם הגדרת את CLAUDE_CONFIG_DIR, Claude Code קורא את .claude.json מתוך אותה תיקייה במקום זאת.

הרץ claude mcp get claude-code-docs כדי לראות איזו רמה מחזיקה בהגדרת השרת. לגבי האופן שבו הרמות פועלות הדדית כאשר אותו שרת מוגדר ביותר מרמה אחת, ראה רמות התקנה של MCP.

#שינוי רמת השרת

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

claude mcp remove claude-code-docs --scope local

#שימוש בשרת בכל הפרויקטים שלך

הוסף מחדש את השרת ברמת user כדי שיהיה פעיל בכל פרויקט שתפתח, ועדיין יישאר פרטי עבורך:

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

#שיתוף שרת עם הצוות שלך

הוסף מחדש את השרת ברמת project, מה שכותב לקובץ .mcp.json בתיקיית השורש של הפרויקט:

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

בצע commit של .mcp.json למערכת בקרת הגרסאות. חברי צוות שישכפלו את המאגר ויפעילו את Claude Code יראו הנחיה לאשר את השרת, ולאחר מכן הוא יתחבר גם עבורם.

#דוגמאות נוספות לשרתי MCP

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

#הוספת שרת מקומי

שרת stdio מקומי הוא תוכנית ש-Claude Code מפעיל כתהליך משנה במחשב שלך, ולא כשירות שאליו הוא ניגש דרך כתובת URL. השתמש בו עבור כלים הזקוקים לגישה למשאבים מקומיים כמו דפדפן, מערכת הקבצים שלך או שקע (socket) של מסד נתונים.

שרת ה-MCP של Playwright הוא דוגמה טובה להתנסות: הוא מעניק ל-Claude דפדפן שבו הוא יכול לנווט, ללחוץ ולקרוא, והוא אינו דורש חשבון. הוא רץ באמצעות npx, ולכן דורש Node.js מגרסה 18 ומעלה.

הוספת שרת Playwright

רשום את השרת עם הפקודה שעל Claude Code להריץ כדי להפעיל אותו:
```
claude mcp add playwright -- npx -y @playwright/mcp@latest
```
פקודה זו שונה מדוגמת השרת המתארח בשלושה אופנים:
- אין דגל --transport, מכיוון ששרתים מקומיים משתמשים בתעבורת ברירת המחדל stdio.
- כל מה שאחרי המפריד -- הוא הפקודה ש-Claude Code מריץ כדי להפעיל את השרת.
- הדגל -y מורה ל-npx להתקין את החבילה ללא בקשת אישור.
הפקודה מדפיסה אישור כגון Added stdio MCP server playwright with command: npx -y @playwright/mcp@latest to local config, ולאחריו שורה File modified: המציגה את קובץ ההגדרות שנכתב.

Playwright מפעיל את הדפדפן Chrome המותקן במחשב שלך. כדי להשתמש בדפדפן אחר, הוסף בסוף --browser עם שם הדפדפן, לדוגמה --browser firefox, אחרי @playwright/mcp@latest.
בדיקת החיבור

אישור ה-Added מעיד שהרשומה נשמרה, ולא שהפקודה רצה. בדוק את החיבור:
```
claude mcp list
```
הבדיקה הראשונה עשויה להציג ✘ Failed to connect בזמן ש-npx מוריד את החבילה, לכן המתן רגע והרץ אותה שוב. ברגע שההורדה מסתיימת, הסטטוס משתנה ל-✔ Connected. אם עדיין מוצג ✘ Failed to connect לאחר כמה ניסיונות נוספים, ראה פתרון בעיות.
שימוש בדפדפן

תן ל-Claude משימה שדורשת דפדפן:
```
Use playwright to open https://example.com and tell me the page title
```
חלון דפדפן ייפתח כך שתוכל לצפות בו פועל, וקריאות הכלים בפלט של Claude מתויגות עם שם השרת playwright והפעולה, כמו browser_navigate.

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

#חיבור שרת הדורש כניסה

שירותים מתארחים כמו Sentry, Linear ו-Notion מפעילים את שרתי ה-MCP שלהם מאחורי OAuth: אתה מוסיף את כתובת ה-URL של השרת, ולאחר מכן נכנס דרך הדפדפן שלך.

השלבים שלהלן משתמשים ב-Sentry כדוגמה. כדי לחבר שירות אחר, החלף את כתובת ה-URL שלו, אותה תוכל למצוא ב-ספריית Anthropic או בתיעוד של השירות.

הוספת השרת

פקודת ה-add זהה לזו של שרת התיעוד, עם כתובת ה-URL של Sentry:
```
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
```
לאחר ההוספה, claude mcp list מציג את השרת עם ! Needs authentication. הדבר צפוי: השלב הבא משלים את הכניסה.
אימות בדפדפן שלך

התחל הפעלה של Claude Code ופתח את לוח ה-MCP:
```
/mcp
```
בחר ב-sentry מהרשימה, לחץ Enter ובחר ב-Authenticate. הדפדפן שלך ייפתח לדף הכניסה של Sentry. אשר את החיבור שם.

בחזרה ב-Claude Code, סטטוס השרת משתנה למוכן/מחובר. אם הכניסה נכשלת או שהדפדפן אינו נפתח, ראה פתרון בעיות.
שימוש בשרת

שאל את Claude משהו שדורש את השירות, כמו What Sentry projects do I have access to?, וחפש קריאות כלים המתויגות עם שם השרת sentry בפלט שלו.

שרתים שמבצעים אימות באמצעות טוקן סטטי במקום OAuth מקבלים את הטוקן בעת ההוספה באמצעות --header "Authorization: Bearer <token>". ראה את דוגמת GitHub לגרסה מעשית.

#עריכת .mcp.json ישירות

כל קובץ ב-טבלת הרמות משתמש באותו מבנה JSON עבור רשומות שרת. חלק זה עורך את .mcp.json, הקובץ ברמת הפרויקט. זהו הקובץ שהכי כדאי לכתוב ידנית מכיוון שהוא נשמר במאגר, ושם הוא משמש גם כהגדרה כקוד (configuration-as-code) עבור הצוות שלך.

צור את .mcp.json בתיקיית השורש של הפרויקט שלך. הדוגמה שלהלן מגדירה את שני השרתים ממדריך זה, שרת התיעוד המתארח שאליו מגיעים דרך HTTP ושרת Playwright כתהליך stdio מקומי:

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

השדות שונים לפי סוג השרת:

עבור שרתי HTTP, השדה url הוא נקודת הקצה ש-Claude Code מתחבר אליה.
עבור שרתי stdio, השדות command ו-args הם התוכנית שהוא מריץ.

לאחר שמירת הקובץ, התחל הפעלה חדשה של Claude Code בפרויקט. Claude Code קורא את .mcp.json בהפעלתו.

בפעם הראשונה ש-Claude Code נתקל בשרת ברמת פרויקט, הוא מבקש ממך לאשר אותו. הבקשה קיימת כדי שמאגר שאתה משכפל לא יוכל להפעיל תהליכים במחשב שלך ללא הסכמתך. אשר את הבקשה, או הרץ /mcp כדי לאשר מאוחר יותר אם פספסת אותה.

לאחר שאישרת, הרץ /mcp ובדוק שהשרתים מוצגים כמחוברים. אם אחד מהם מציג שגיאה במקום זאת, ראה פתרון בעיות.

#התחברות מממשקים אחרים

מדריך זה משתמש בפקודות ה-CLI של claude mcp, אך כל ממשק של Claude Code יכול להתחבר לשרתי MCP:

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

#פתרון בעיות

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

#`/mcp` מציג `No MCP servers configured`

Claude Code לא מצא שרתים כלשהם עבור התיקייה הנוכחית. הסיבות הנפוצות ביותר:

הרצת את claude mcp add מפרויקט אחר. שרתים ברמת local קשורים לפרויקט שבו הוספת אותם: שורש המאגר, או התיקייה המדויקת אם לא היית במאגר git. הוסף מחדש את השרת מהפרויקט שבו אתה נמצא כעת, או הוסף אותו עם --scope user כך שלא יהיה קשור לפרויקט.
ערכת קובץ הגדרות בנתיב הלא נכון. הקבצים הנכונים הם ~/.claude.json ו-<project>/.mcp.json. Claude Code אינו קורא נתיבים כגון ~/.claude/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json או %APPDATA%\Claude\mcp.json. עבור שרתים ברמת משתמש, הרץ claude mcp add --scope user, מה שכותב למפתח mcpServers ב-~/.claude.json. עבור שרתים ברמת פרויקט, ערוך את .mcp.json בשורש הפרויקט.
כתבת רשומה לא תקינה ב-.mcp.json. Claude Code מדלג על אותה רשומה ועדיין טוען את האחרות. הרץ claude mcp list מהמעטפת שלך וחפש את אזהרת הפענוח, שמציינת את השדה הבעייתי.

#הסטטוס מציג `Failed to connect` או `Connection error`

שני הסטטוסים מעידים על כך שהשרת לא הופעל או שכתובת ה-URL לא הגיבה. הם יכולים להופיע גם עבור שרתי HTTP שדוחים את הטוקן שהגדרת ב-headers.Authorization. שרת שמבקש טוקן שלא הגדרת מציג במקום זאת ! Needs authentication, כפי שמוסבר ב-חיבור שרת הדורש כניסה.

הצעד הראשון תלוי בסטטוס שאתה רואה:

Failed to connect: התחל בפרטי הכשל שעל גבי הסטטוס עצמו. claude mcp list ו-claude mcp get <name> מציגים את סטטוס ה-HTTP או קוד השגיאה וכל טקסט שגיאה שהשרת החזיר, אשר לעיתים קרובות מציין את הבעיה ישירות, כגון כותרת (header) חסרה או טוקן שנדחה. לפני גרסה v2.1.219, הסטטוס Failed to connect הציג רק את הסטטוס בלבד, והיה צורך בבדיקות curl והפקודות בהמשך סעיף זה כדי למצוא את הסיבה.
Connection error: Claude Code אינו מצרף פרטים לסטטוס זה באף גרסה, לכן עבור ישירות לבדיקות curl והפקודות בהמשך סעיף זה.

אם הפרטים מצביעים על פרטי זיהוי (credential) או על כתובת URL, בדוק גם את האזהרות בפלט של claude mcp list. Claude Code מתריע על ערכי הגדרות עם רווחים נסתרים בהתחלה או בסוף, סיבה נפוצה לכשלי אימות לאחר הדבקת טוקן.

אם שרת HTTP מחזיר 404 Not Found, Claude Code מציג MCP endpoint not found at <origin>. Check the URL in your MCP config. כאשר אתה בוחר את השרת ב-/mcp. ההודעה מציינת את מקור ה-URL (ה-origin), כגון https://mcp.example.com, ללא הנתיב שלו, לכן הרץ claude mcp get <name> כדי לראות את כתובת ה-URL המלאה שהגדרת. השווה את הנתיב שלה לנתיב נקודת הקצה של MCP המתועד של השרת, ולאחר מכן הרץ claude mcp remove <name> והוסף מחדש עם כתובת ה-URL הנכונה. לפני גרסה v2.1.219, ההודעה כללה גם את נתיב ה-URL, ולפני גרסה v2.1.191, שגיאת 404 הציגה הודעה כללית Error POSTing to endpoint ללא כתובת ה-URL.

עבור שרתי HTTP, וודא שכתובת ה-URL נגישה מהמחשב שלך:

curl -I https://mcp.sentry.dev/mcp

ב-PowerShell, השתמש ב-curl.exe במקום curl כדי שהבקשה תגיע לקובץ הבינארי האמיתי של curl ולא לכינוי של Invoke-WebRequest.

התגובה מציינת איזה סוג בעיה יש לך:

404 או 405: השרת פעיל. נקודות קצה רבות של MCP עונות רק לבקשות POST, כך שזה עדיין מאשר שכתובת ה-URL נגישה מהמחשב שלך.
401 או 403: השרת פעיל ואתה צריך לבצע אימות. השתמש בכניסה דרך הדפדפן ב-חיבור שרת הדורש כניסה, או עבור שרתים שמקבלים טוקן במקום זאת, כמו של GitHub, העבר אותו עם --header "Authorization: Bearer <token>" בפקודת claude mcp add.
אין תגובה כלל: בדוק את כתובת ה-URL ואת הרשת שלך.

עבור שרתי stdio, הרץ את הפקודה המוגדרת ישירות במסוף שלך כדי לראות את השגיאה הבסיסית. עבור שרת Playwright ממדריך זה, הרץ:

npx -y @playwright/mcp@latest

מה שקורה לאחר מכן מציין היכן הבעיה:

הפקודה מופעלת וממתינה לקלט: השרת עצמו עובד. הרץ claude mcp get <name> וודא שהפקודה המוצגת שם תואמת למה שהרצת הרגע. אם הפקודה המוצגת שונה ממה שהקלדת, סביר להניח שהשמטת את המפריד -- לפני פקודת השרת. הסר את השרת והוסף אותו מחדש עם -- במקומו. אם כתבת את .mcp.json ידנית, בדוק את התחביר והמיקום שלו.
הפקודה נכשלת בשגיאה: ההודעה מציינת מה חסר, כגון Node.js או דפדפן.

#החיבור חרג מפסק הזמן בעת ההפעלה

לשרת לקח יותר זמן מפסק הזמן של ברירת המחדל להפעלה, העומד על 30 שניות. הפעלה ראשונה של שרת stdio עשויה להיות איטית בזמן ש-npx מוריד את החבילה. הגדל את המגבלה באמצעות משתנה הסביבה MCP_TIMEOUT, במילישניות:

MCP_TIMEOUT=60000 claude

ב-PowerShell, הגדר את המשתנה לפני הפקודה באותה שורה:

$env:MCP_TIMEOUT = "60000"; claude

#השרת כבר קיים

כבר הוספת שרת בשם זה באותה רמה. הסר תחילה את הרשומה הקיימת או בחר שם אחר:

claude mcp remove claude-code-docs

אם השם קיים ביותר מרמה אחת, הפקודה remove מדווחת על exists in multiple scopes. העבר --scope כדי לבחור איזה עותק למחוק, לדוגמה claude mcp remove claude-code-docs --scope local.

#השרת מתחבר אך לא מופיעים כלים

הרץ /mcp בתוך הפעלה ובחר בשרת כדי לראות את רשימת הכלים שלו. אם הרשימה ריקה, השרת הופעל אך לא רשם כלים כלשהם, מה שבדרך כלל אומר שחסר לו משתנה סביבה נדרש כגון מפתח API.

העבר את המשתנה עם --env KEY=value בפקודה claude mcp add, או בשדה env של רשומת השרת ב-.mcp.json. התיעוד של השרת מפרט את המשתנים שהוא צריך.

#שינויים ב-.mcp.json אינם נכנסים לתוקף

Claude Code קורא את .mcp.json בתחילת ההפעלה. צא והפעל מחדש את ההפעלה לאחר עריכת הקובץ.

אם השרתים שלך עדיין אינם מופיעים, הרץ claude mcp list וחפש אזהרת פענוח. Claude Code מדלג על רשומות לא תקינות ומציג שם את השדה הבעייתי.

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

claude mcp reset-project-choices

#כניסת OAuth נכשלת או שהדפדפן אינו נפתח

הרץ /mcp, בחר את השרת ובחר שוב ב-Authenticate. אם הדפדפן אינו נפתח אוטומטית, העתק את כתובת ה-URL המוצגת במסוף ופתח אותה ידנית. ראה אימות מול שרתי MCP מרוחקים עבור יציאות callback קבועות ופרטי זיהוי מוגדרים מראש.

#הצעדים הבאים

כאשר שרת אחד מחובר, חקור את שאר היכולות ש-MCP מאפשר:

מציאת שרתי MCP נוספים בספריית Anthropic
שיתוף שרתים עם הצוות שלך באמצעות רמות התקנה
ניהול גישת MCP עבור ארגון עם הגדרות מנוהלות ובקרות מדיניות
התייחסות למשאבי MCP בהנחיות באמצעות אזכורי @
הפעלת הנחיות MCP כפקודות מתפריט ה-/
בניית שרת משלך באמצעות ה-SDK של MCP