Ce face codex mcp și /mcp
codex mcp administrează intrările de servere MCP din ~/.codex/config.toml. add suportă două transporturi: stdio (o comandă de lansare dată după --) și streamable HTTP (--url). Acțiunile OAuth (login, logout) funcționează doar cu serverele streamable HTTP care suportă OAuth.
În TUI, /mcp listează uneltele MCP configurate pe care Codex le poate apela în sesiune. /mcp verbose adaugă diagnostice detaliate despre servere, iar /mcp login <nume> te autentifică la un server configurat.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
list [--json] |
Serverele configurate. |
get <nume> [--json] |
Configurația unui server; --json afișează intrarea brută. |
add <nume> -- <comandă...> |
Server stdio: executabilul și argumentele, după --. |
add <nume> --url <url> |
Server streamable HTTP (exclusiv cu comanda stdio). |
--env CHEIE=VALOARE |
Variabile de mediu pentru serverul stdio (se poate repeta). |
--bearer-token-env-var <VAR> |
Variabila al cărei conținut se trimite ca bearer token la serverul HTTP. |
--oauth-client-id / --oauth-resource |
Client ID-ul și parametrul resource pentru OAuth; cer --url. |
remove <nume> |
Șterge definiția serverului. |
login <nume> [--scopes a,b] |
Pornește autentificarea OAuth (servere HTTP cu OAuth). |
logout <nume> |
Șterge credențialele OAuth salvate. |
/mcp [verbose] | /mcp login <nume> |
În sesiune: uneltele MCP, diagnostice sau autentificare. |
Exemple practice
Exemplul 1: Server stdio cu o variabilă de mediu
codex mcp add docs --env API_TOKEN=abc123 -- npx -y server-docsExemplul 2: Server HTTP cu OAuth
codex mcp add tracker --url https://mcp.exemplu.ro/mcp
codex mcp login trackerExemplul 3: Verificarea din sesiune
> /mcp verboseGreșeli frecvente și bune practici
- Rulezi
codex mcp loginpentru un server stdio; OAuth merge doar cu streamable HTTP. - Uiți separatorul
--înaintea comenzii serverului stdio.