Collegare Codex

Q: Funziona con ChatGPT?

Sì, con l'app desktop di ChatGPT, che legge lo stesso config.toml. ChatGPT nel browser web non lo legge.

Q: Il token va nel file o in una variabile?

Una variabile è più sicura: con bearer_token_env_var, il token non resta mai nel file. Va bene anche il file, purché non finisca mai su Git o in una cartella condivisa.

2 min di letturaAggiornato 8 nov 2026Markdown

Codex si collega al server MCP di LanaChat tramite un blocco nel suo file di configurazione, config.toml. Le servono Codex installato (guida) e il Suo token (guida); bastano due minuti.

L'app desktop di ChatGPT, la CLI di Codex e l'estensione Codex per gli editor di codice condividono questo stesso file, quindi Lei configura LanaChat una sola volta per tutti e tre. ChatGPT nel browser web non lo legge: usi l'app desktop o la CLI.

Dov'è il file #

Mac e Linux: ~/.codex/config.toml (la cartella nascosta .codex nella Sua cartella home).
Windows: %USERPROFILE%\.codex\config.toml.

Se il file non esiste ancora, lo crei. È un semplice file di testo.

Aggiunga il blocco #

Apra il file in un editor di testo e aggiunga queste righe in fondo. Sostituisca YOUR_MCP_TOKEN con il Suo token.

[mcp_servers.lanachat]
url = "https://api.lanachat.ai/mcp"
http_headers = { "Authorization" = "Bearer YOUR_MCP_TOKEN" }

Salvi il file.

Più sicuro: tenere il token fuori dal file #

Codex può leggere il token da una variabile d'ambiente. Usi questo blocco al posto di quello precedente:

[mcp_servers.lanachat]
url = "https://api.lanachat.ai/mcp"
bearer_token_env_var = "LANACHAT_MCP_TOKEN"

Poi imposti la variabile prima di avviare Codex. Su Mac o Linux:

read -s LANACHAT_MCP_TOKEN && export LANACHAT_MCP_TOKEN && codex

Incolli il token quando il cursore attende (non appare nulla), prema Invio, e Codex si avvia con il token.

Verifichi che sia collegato #

Avvii Codex: codex.
Digiti /mcp e prema Invio.
lanachat è nell'elenco dei server attivi.

Dal terminale, codex mcp list mostra i server configurati. Nell'app desktop, digiti /mcp nella casella del messaggio per vedere i server collegati.

Lo provi #

Chieda a Codex, con parole semplici: List my LanaChat creators. Codex chiama uno strumento di LanaChat e risponde con le Sue creator. Se lo fa, è collegato. Il test completo è in Provare la connessione.

Errori frequenti #

Cosa vede	Causa probabile e rimedio
`lanachat` non è nell'elenco di `/mcp`	Il blocco è nel file sbagliato o contiene un errore di battitura. Controlli il percorso indicato sopra e le parentesi quadre, salvi e riavvii Codex.
`401` o "invalid or expired MCP grant"	Il token è sbagliato, scaduto o è stato ruotato. Crei o copi di nuovo il token (guida) e aggiorni il file.
La variabile è vuota	Con `bearer_token_env_var`, Codex deve essere avviato dallo stesso terminale in cui ha impostato la variabile.
Manca uno strumento	Il token non lo consente. Modifichi le caselle del token con Edit, poi riavvii Codex.

Altro aiuto: Risoluzione dei problemi.

Nota Questi passaggi seguono la documentazione ufficiale di Codex sui server MCP (pagina "MCP", nella documentazione di Codex).

Nota Dopo una rotazione del token, inserisca il nuovo token nel file (o nella variabile) e riavvii Codex. Anche dopo aver modificato le caselle del token con Edit, riavvii Codex.

Passo successivo: provi la connessione.

FAQ #

Funziona con ChatGPT? #

Sì, con l'app desktop di ChatGPT, che legge lo stesso config.toml. ChatGPT nel browser web non lo legge.

Il token va nel file o in una variabile? #

Una variabile è più sicura: con bearer_token_env_var, il token non resta mai nel file. Va bene anche il file, purché non finisca mai su Git o in una cartella condivisa.

Perché lanachat manca da `/mcp`? #

Il blocco è nel file sbagliato o contiene un errore di battitura. Controlli il percorso e le parentesi quadre, salvi e riavvii Codex.