🔗 פרק 10

תאימות בין כלים

מפתחים רבים משתמשים במספר סביבות פיתוח וסוכני AI במקביל: קלוד קוד בטרמינל, גרוק CLI לחקירת בעיות מורכבות, ו-Cursor או VS Code בעת עריכת קוד יומיומית.

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

#מנוע התאימות האוטומטי של גרוק CLI

כדי לחסוך מכם את הצורך להגדיר את אותם שרתים שוב ושוב, גרוק CLI כולל מנוע תאימות מובנה הסורק ומייבא אוטומטית הגדרות שרתי MCP מקבצי התצורה של כלים אחרים במערכת:

#סדר העדיפויות בטעינה ופתרון התנגשויות

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

1. .grok/config.toml של התיקייה/הפרויקט (העדיפות הגבוהה ביותר).
2. ~/.grok/config.toml הגלובלי של המשתמש.
3. הגדרות Claude Code (~/.claude.json).
4. הגדרות Cursor (.cursor/mcp.json).
5. הגדרות .mcp.json הכלליות בשורש המאגר.

הגדרה ידנית בקובץ של גרוק תדרוס תמיד הגדרה המיובאת מכלי אחר.

#ניטרול ספקי תאימות (Compatibility Flags)

אם אתם נתקלים בהתנגשות בין כלים או רוצים לבודד לחלוטין את גרוק מהגדרות של קלוד או Cursor, ניתן לכבות את היבוא האוטומטי בקובץ ~/.grok/config.toml:

# כיבוי טעינה אוטומטית מהגדרות קלוד
[compat.claude]
mcps = false

# כיבוי טעינה אוטומטית מהגדרות Cursor
[compat.cursor]
mcps = false

#זיהוי מקור השרת באמצעות grok inspect

כדי לבדוק מאיזה קובץ בדיוק נטען כל שרת בסביבה שלכם, הריצו:

grok inspect

בפלט תופיע תווית מקור ליד כל שרת (לדוגמה [claude], [cursor], [grok] או [project]).

#עקרונות לשיתוף הגדרות בריפו צוותי

כאשר משתפים הגדרות MCP בין חברי צוות במאגר Git:

1. השתמשו בקובץ תקני בשורש הפרויקט: שמרו את שרתי הפרויקט בקובץ .mcp.json בשורש הריפו. פורמט זה נתמך ישירות על ידי Claude Code, Cursor וגרוק CLI.
2. הימנעו מנתיבים אבסולוטיים מקומיים ב-stdio:
   • לא מומלץ: args: ["/Users/dan/my-project/data"] (יישבר במחשב של מפתח אחר).
   • מומלץ: שימוש בנתיב יחסי args: ["./data"] או הרמת שרת HTTP מרוחק.
3. שרתי HTTP מרוחקים כברירת מחדל לשיתוף: שרתי HTTP בעלי כתובת ענן אחידה (כגון Linear או Sentry) עובדים מיד אצל כל חברי הצוות ללא צורך בהתקנת חבילות מקומיות.
4. אף פעם אל תכניסו סודות לקובץ משותף: הגדירו את כתובת השרת בקובץ המשותף, אך את כותרות האימות והטוקנים שמרו בהגדרות המשתמש המקומיות (~/.claude.json או משתני סביבה).