תיעוד 47

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

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

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

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

[!NOTE]

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

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

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

ודא שיש לך:

Claude Code מותקן ומאומת
טרמינל פתוח בתיקיית פרויקט. כל תיקייה מתאימה, כולל תיקייה ריקה.

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

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

השלבים זהים לכל שרת: להוסיף אותו, לבדוק את סטטוס החיבור, ואז להשתמש בו בסשן, עם שלב ניקוי אופציונלי בסוף. חלק מהשרתים מוסיפים שלב, כמו כניסה בדפדפן, שמוצג בדוגמאות נוספות לשרתי 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, כפי שמכוסה בשינוי היקף השרת.

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

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

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` של הפרויקט. ראה השבתת שרת בלי להסיר אותו
`✘ Blocked by enterprise managed policy`	אחת ממדיניות הארגון שלך חוסמת את השרת הזה, ולכן Claude Code לא יתחבר. שאל את מנהל המערכת איזו מדיניות. ראה סטטוס שרת

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

שימוש בשרת

התחל סשן ובקש מ-Claude להשתמש בשרת החדש לפי שם:

claude

Use the claude-code-docs server to look up what MCP_TIMEOUT does

[!NOTE]

בדרך כלל אין צורך לנקוב בשם שרת בהנחיה, כי 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: שמראה את הקובץ שעודכן.

[!NOTE]

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

#איפה השרתים נשמרים

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

[!NOTE]

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

יש דרכים נוספות להוסיף שרת, לכל אחת סעיף משלה:

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

#מציאת התצורה בדיסק

הפקודה claude mcp add כותבת את השרת לאחד משלושה היקפים, שנשמרים בשני קבצים, בהתאם לדגל --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 של מסד נתונים.

שרת Playwright MCP הוא שרת טוב לניסיון: הוא נותן ל-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, קובץ היקף הפרויקט. זה הקובץ שהכי שווה לכתוב ידנית כי הוא נכנס למאגר, שם הוא משמש גם כתצורה כקוד לצוות.

צור .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.
סשנים בענן: מחוץ לשרשורים של פרויקט, בצע commit ל-.mcp.json במאגר. סשן עם מאגר אחד טוען אותו. שרשורי ענן בפרויקט משתמשים במחברי claude.ai שלך במקום. ראה עריכת .mcp.json ישירות ומה עובר מההגדרה שלך.
Claude.ai: מחברים שמוסיפים ב-claude.ai/customize/connectors נטענים אוטומטית ב-CLI כשנכנסים עם החשבון הזה. ראה שימוש בשרתי MCP מ-Claude.ai.

#פתרון בעיות

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

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

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

הרצת את claude mcp add מפרויקט אחר. שרתים בהיקף מקומי קשורים לפרויקט שבו הוספת אותם: שורש המאגר, או הספרייה המדויקת אם לא היית במאגר 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 או את קוד השגיאה וכל טקסט שגיאה שהשרת החזיר, ולעיתים קרובות זה מציין את הבעיה ישירות, למשל כותרת חסרה או אסימון שנדחה. לפני v2.1.219, Failed to connect הציג רק את הסטטוס החשוף, והיה צריך את בדיקות ה-curl והפקודה בהמשך הסעיף הזה כדי למצוא את הסיבה.
Connection error: Claude Code לא מוסיף פירוט לסטטוס הזה בשום גרסה, אז עבור ישר לבדיקות ה-curl והפקודה בהמשך הסעיף הזה.

אם הפירוט מצביע על אישור או על 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. ההודעה מציינת את ה-origin של ה-URL, למשל 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 ידנית, בדוק את התחביר ואת המיקום שלו. לפני v2.1.285, claude mcp get לא הדפיס שורת Command עבור רשומת stdio שנשמרה בלי שדה type, למשל רשומת .mcp.json שנכתבה ידנית. בגרסאות האלה, הרץ במקום זאת claude mcp list, שמדפיס את שורת הפקודה בכל מקרה.
הפקודה נכשלת בשגיאה: ההודעה מציינת מה חסר, למשל Node.js או דפדפן.

#`Connection timed out at startup`

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

MCP_TIMEOUT=60000 claude

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

$env:MCP_TIMEOUT = "60000"; claude

לפני v2.1.299, חלק מהחיבורים לשרתי HTTP שהיו פעילים הגיעו לפסק זמן בהפעלה בלי קשר ל-MCP_TIMEOUT. אם אתה משתמש באחת מהגרסאות האלה ושרת HTTP שפעיל עדיין מגיע לפסק זמן אחרי שהעלית את המגבלה, עדכן את Claude Code.

#`Server already exists`

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

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 של השרת. התיעוד של השרת מפרט את המשתנים שהוא צריך.

לפני v2.1.302, /mcp הציג את הסטטוס tools fetch failed עבור שרת שהשתמש בגרסת פרוטוקול 2026-07-28 והשמיט את resultType, ttlMs, או cacheScope מהתשובות שלו. אם אתה משתמש באחת מהגרסאות האלה ושרת מציג את הסטטוס הזה, עדכן את Claude Code.

#שינויים ב-`.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 Directory
שתף שרתים עם הצוות שלך באמצעות היקפי התקנה
נהל גישת MCP לארגון עם הגדרות מנוהלות ובקרות מדיניות
הפנה למשאבי MCP בהנחיות עם אזכורי @
הרץ הנחיות MCP כפקודות מתפריט /
בנה שרת משלך עם MCP SDK