7. חיבור לכלים חיצוניים (MCP)

Codex יכול לכתוב ולהריץ קוד, אבל מחוץ לפרויקט שלכם הוא "עיוור" — הוא לא יודע לגשת לתיעוד עדכני, לפיגמה, לדפדפן או ל-GitHub שלכם. MCP (Model Context Protocol) הוא הפרוטוקול שפותח לו את הדלת לכלים ולמידע חיצוניים. בפרק הזה נלמד מה זה, איך מחברים שרת MCP ל-Codex, ואיך שומרים על שליטה ועל בטיחות.

מה זה MCP, בשפה פשוטה

MCP הוא תקן פתוח שמחבר מודלים לכלים ולהקשר (context) חיצוניים. שרת MCP הוא תוכנה קטנה שחושפת בפני Codex יכולות מוגדרות: לדוגמה, "חפש בתיעוד של React", "קרא קובץ מפיגמה" או "פתח דף בדפדפן ועשה לו צילום מסך". Codex מדבר עם השרת דרך הפרוטוקול, מקבל רשימת כלים, ויכול לקרוא להם בדיוק כמו שהוא קורא לכלים המובנים שלו (קריאת קבצים, הרצת פקודות וכו').

ה-CLI, תוסף ה-IDE ואפליקציית הדסקטופ של ChatGPT חולקים אותה הגדרת MCP. מגדירים שרת פעם אחת, והוא זמין בכל הממשקים.

שני סוגי שרתים

Codex גם קורא את שדה ה-instructions שהשרת מחזיר באתחול, ומשתמש בו כהנחיה כללית לגבי איך להשתמש בכלים שלו — לצד רשימת הכלים עצמה.

איך מוסיפים שרת MCP

הדרך המהירה היא הפקודה codex mcp add:

codex mcp add <server-name> --env VAR1=VALUE1 --env VAR2=VALUE2 -- <stdio server-command>

לדוגמה, לחבר את Context7 — שרת MCP חינמי לתיעוד מפתחים עדכני:

codex mcp add context7 -- npx -y @upstash/context7-mcp

מכאן, בכל שיחה עם Codex (בטרמינל, ב-IDE או בדסקטופ) הכלים של context7 זמינים לו אוטומטית.

ניהול משורת הפקודה

• codex mcp list — רשימת השרתים המוגדרים.
• codex mcp --help — כל הפקודות הזמינות.
• codex mcp login <server-name> — מתחיל תהליך התחברות OAuth, לשרתים שתומכים בכך (עובד רק עם שרתי HTTP).

מה-TUI (המצב האינטראקטיבי)

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

הגדרה ידנית ב-config.toml

לשליטה מדויקת יותר, עורכים ישירות את ~/.codex/config.toml, או קובץ מקומי לפרויקט .codex/config.toml (רק בפרויקטים מהימנים). כל שרת מקבל טבלת [mcp_servers.<server-name>] משלו.

שרת STDIO

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env_vars = ["LOCAL_TOKEN"]

[mcp_servers.context7.env]
MY_ENV_VAR = "MY_ENV_VALUE"

שרת Streamable HTTP

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
http_headers = { "X-Figma-Region" = "us-east-1" }

אפשרויות נוספות שרלוונטיות לכל שרת

[mcp_servers.chrome_devtools]
url = "http://localhost:3000/mcp"
enabled_tools = ["open", "screenshot"]
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20

[mcp_servers.chrome_devtools.tools.open]
approval_mode = "approve"

שרתי MCP שימושיים להתחלה

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

שדה ה-instructions שהשרת שולח, ותוצאות הכלים שלו, הם תוכן שמגיע ממקור חיצוני — בדיוק כמו דף אינטרנט. התייחסו אליהם בזהירות דומה, ואל תניחו שכל מה שהשרת "מבקש" מ-Codex הוא בהכרח לגיטימי.

codex mcp login <server-name> --oauth-client-registration cimd
codex mcp login <server-name> --oauth-client-registration dcr

codex mcp add example --url https://mcp.example.com --oauth-client-id my-client

[mcp_servers.example]
url = "https://mcp.example.com"

[mcp_servers.example.oauth]
client_id = "my-client"
callback_url = "http://127.0.0.1/callback"

mcp_oauth_callback_port = 5555
mcp_oauth_callback_url = "https://devbox.example.internal/callback"

[plugins."sample@test".mcp_servers.sample]
enabled = true
default_tools_approval_mode = "prompt"
enabled_tools = ["read", "search"]