$ man how-to/managing-mcp-servers
שרתי MCPintermediate
ניהול שרתי MCP
הוספה, דיבוג, עדכון וארגון של הגדרות שרתי MCP
by Shawn Tenam
CODE
היכן חיים ההגדרות
הגדרות שרתי MCP נמצאות בקבצי JSON. המיקום תלוי בכלי שלך:
Cursor (ברמת הפרויקט): .cursor/mcp.json בשורש הפרויקט
Cursor (גלובלי): ~/.cursor/mcp.json בתיקיית הבית שלך
Claude Code: ~/.claude/mcp.json או .claude/mcp.json ברמת הפרויקט
הגדרות ברמת הפרויקט דורסות הגדרות גלובליות. השתמש בהגדרות גלובליות לשרתים שאתה צריך בכל פרויקט (GitHub, Slack). השתמש בהגדרות ברמת הפרויקט לשרתים ספציפיים לפרויקט אחד.
שני הקבצים חולקים את אותו פורמט: אובייקט JSON עם מפתח "mcpServers" שמכיל בלוק אחד לכל שרת. כל בלוק מכיל "command" (איך להפעיל את השרת), "args" (ארגומנטים לפקודה), ו"env" (משתני סביבה, בדרך כלל מפתחות API).
PATTERN
הוספת שרת חדש
הskill /addmcp מאוטמט את זה, אבל הבנת התהליך הידני עוזרת כשדברים נשברים.
1. מצא את חבילת npm של שרת הMCP. רוב השרתים מפורסמים בnpm עם שמות כמו @company/mcp-server או mcp-server-toolname.
2. קבל את מפתח הAPI מהגדרות הכלי או מהדאשבורד.
3. הוסף בלוק חדש לmcp.json עם שם השרת, הפקודה (בדרך כלל "npx"), ארגומנטים (שם החבילה עם דגל "-y"), ו-env (מפתח הAPI שלך).
4. הפעל מחדש את העורך כדי שיאסוף את ההגדרות החדשות.
5. בדוק על ידי בקשה מClaude להשתמש בכלי. "רשום את ערוצי הSlack שלי" או "הראה את הקמפיינים שלי בHeyReach."
אם הבדיקה נכשלת, הבעיה היא כמעט תמיד מפתח הAPI (שגוי או שפג תוקפו) או שם החבילה (שגיאת הקלדה או גרסה לא נכונה).
PRO TIP
דיבוג בעיות חיבור
כששרת MCP מפסיק לעבוד, בדוק בסדר הזה:
1. מפתח API: האם פג תוקפו? האם עשית רוטציה? בדוק בדאשבורד של הכלי.
2. תחביר ההגדרות: האם הJSON תקין? פסיק או סוגר חסרים שוברים את כל קובץ ההגדרות, לא רק שרת אחד.
3. זמינות חבילה: האם אתה יכול להריץ את פקודת npx ידנית בטרמינל? אם זה נכשל שם, זה נכשל גם בIDE.
4. רשת: האם השירות החיצוני פעיל? בדוק את דף הסטטוס של הכלי.
5. מגבלות קצב: האם הגעת למגבלת הקצב של הAPI? חלק מהשירותים מגבילים אחרי יותר מדי בקשות. הוסף השהיות בין קריאות או הקטן גדלי אצווה.
הבעיה הנפוצה ביותר ללא ספק היא מפתחות API שפג תוקפם. אם שרת עבד אתמול ונכשל היום, בדוק את המפתח קודם. חסוך לעצמך 20 דקות של דיבוג על ידי התחלה עם הדבר הברור.
ANTI-PATTERN
שמירה על הגדרות נקיות
אל תוסיף שרתי MCP שאתה לא משתמש בהם באופן פעיל. כל שרת מוסיף זמן הפעלה. חלק מהשרתים מריצים תהליכי רקע שצורכים זיכרון. אם אתה לא משתמש בMCP של Figma מדי יום, הסר אותו. תמיד אפשר להוסיף אותו חזרה ב30 שניות.
אל תשריין מפתחות API בקבצים שנעשה להם commit. קובץ mcp.json צריך להיות ב.gitignore שלך. אם אתה משתף פרויקט עם שותפים, צור mcp.json.example עם ערכי מציין-מקום והוסף את mcp.json האמיתי ל.gitignore.
אל תתקין כל שרת MCP מרשימת "50 שרתי MCP מובילים." התקן את אלה שמסירים חיכוך מתהליכי עבודה שאתה כבר עושה. הערך של שרת MCP נמדד לפי כמה שלבים ידניים הוא מבטל מהתהליך היומי שלך. אפס שלבים ידניים מבוטלים פירושו אפס ערך, לא משנה כמה הכלי מגניב.
knowledge guide
מדריכים קשורים