📘 תיעוד 8

שרתי MCP

שרתי MCP (Model Context Protocol) חושפים כלים חיצוניים ל-Grok. אחרי ההגדרה, הכלים שלהם זמינים לצד הכלים המובנים, במרחב שמות <server>__<tool>.

#הוספת שרת

הדרך המהירה ביותר היא הפקודה grok mcp:

# Local stdio server; everything after -- is the server command
grok mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# Remote server over HTTP (OAuth handled automatically)
grok mcp add --transport http linear https://mcp.linear.app/mcp

# Remote server with a static auth header (--header is repeatable)
grok mcp add --transport http api https://mcp.example.com/mcp --header "Authorization: Bearer ${API_TOKEN}"

grok mcp list מציג שרתים מוגדרים, grok mcp remove <name> מוחק אחד, ו-grok mcp doctor [name] מאבחן הגדרות וקישוריות. list ו-doctor מקבלים --json לפלט קריא למכונה.

אפשר גם להצהיר על שרתים ישירות ב-~/.grok/config.toml:

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
env = { API_KEY = "${MY_API_KEY}" }   # ${VAR} expands at load time
startup_timeout_sec = 30              # default 30
tool_timeout_sec = 6000               # default 6000

[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
headers = { "x-mcp-session-id" = "{{session_id}}" }

Grok מרחיב את ${VAR} (ואת ${VAR:-default}) ב-url, ב-command, ב-args, ב-env וב-headers, כך שסודות יכולים להישאר בסביבה. שרתים שדורשים OAuth מפעילים זרימת דפדפן בשימוש הראשון. אסימונים נשמרים תחת ~/.grok/mcp_credentials.json.

#היקף פרויקט

העבירו --scope project ל-grok mcp add (הפקודה כותבת את .grok/config.toml בתיקייה הנוכחית) כדי להגדיר שרתים שמגיעים עם המאגר. בזמן הטעינה, Grok עולה מהתיקייה הנוכחית עד לשורש ה-git וקורא כל .grok/config.toml, ושרת פרויקט עם אותו שם כמו שרת משתמש מחליף אותו במלואו.

#ב-TUI

/mcps פותח את לשונית MCP של חלון התוספים: החלפת מצב שרת עם Space, רענון אחרי עריכות הגדרות עם r, אימות שרתי OAuth עם i, והוספה או הסרה עם a ו-x.

#תאימות

Grok טוען גם הגדרות MCP מקבצי ~/.claude.json, .cursor/mcp.json ו-.mcp.json של הפרויקט, וממזג אותן מתחת ל-config.toml בעדיפות. משביתים ספק עם [compat.claude] mcps = false או [compat.cursor] mcps = false. grok inspect מציג כל שרת שנטען ואת המקור שלו.

#פתרון בעיות

grok mcp doctor הוא התחנה הראשונה. עבור שרתי stdio שמתחילים אבל נכשלים בחיבור, Grok לוכד את stderr אל ~/.grok/logs/mcp/<server>.stderr.log. שרתי npx בהפעלה קרה שמורידים חבילות בהפעלה הראשונה עשויים להזדקק ל-startup_timeout_sec גבוה יותר.