Conecte o Codex

Q: Funciona com o ChatGPT?

Sim, com o app de desktop do ChatGPT, que lê o mesmo config.toml. O ChatGPT no navegador não o lê.

Q: O token deve ficar no arquivo ou em uma variável?

Uma variável é mais seguro: com bearer_token_env_var, o token nunca fica no arquivo. O arquivo também funciona, desde que nunca vá para o Git nem para uma pasta compartilhada.

Leitura de 2 minAtualizado 8 de nov. de 2026Markdown

O Codex se conecta ao servidor MCP do LanaChat por um bloco no arquivo de configuração dele, config.toml. Você precisa do Codex instalado (guia) e do seu token (guia); leva dois minutos.

O app de desktop do ChatGPT, o Codex CLI e a extensão do Codex para editores de código compartilham este mesmo arquivo, então você configura o LanaChat uma só vez para os três. O ChatGPT no navegador não o lê: use o app de desktop ou o CLI.

Onde fica o arquivo #

Mac e Linux: ~/.codex/config.toml (a pasta oculta .codex na sua pasta pessoal).
Windows: %USERPROFILE%\.codex\config.toml.

Se o arquivo ainda não existir, crie-o. É um arquivo de texto simples.

Adicione o bloco #

Abra o arquivo em um editor de texto e adicione estas linhas no final. Troque YOUR_MCP_TOKEN pelo seu token.

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

Salve o arquivo.

Mais seguro: mantenha o token fora do arquivo #

O Codex pode ler o token de uma variável de ambiente. Use este bloco no lugar do acima:

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

Depois defina a variável antes de iniciar o Codex. No Mac ou no Linux:

read -s LANACHAT_MCP_TOKEN && export LANACHAT_MCP_TOKEN && codex

Cole o token quando o cursor ficar esperando (nada aparece), pressione Enter, e o Codex inicia com o token.

Confira se está conectado #

Inicie o Codex: codex.
Digite /mcp e pressione Enter.
lanachat está na lista de servidores ativos.

No terminal, codex mcp list mostra os servidores configurados. No app de desktop, digite /mcp na caixa de mensagem para ver os servidores conectados.

Teste #

Peça ao Codex, em palavras simples: List my LanaChat creators. O Codex chama uma ferramenta do LanaChat e responde com as suas criadoras. Se responder, você está conectado. O teste completo está em Teste a conexão.

Erros comuns #

O que você vê	Causa provável e correção
`lanachat` não está na lista do `/mcp`	O bloco está no arquivo errado ou tem um erro de digitação. Confira o caminho acima e os colchetes, salve e reinicie o Codex.
`401` ou "invalid or expired MCP grant"	O token está errado, expirou ou foi rotacionado. Crie ou copie o token de novo (guia) e atualize o arquivo.
A variável está vazia	Com `bearer_token_env_var`, o Codex deve ser iniciado no mesmo terminal em que você definiu a variável.
Falta uma ferramenta	O token não a permite. Altere as caixas do token com Edit e reinicie o Codex.

Mais ajuda: Solução de problemas.

Nota Estes passos seguem a documentação oficial do Codex sobre servidores MCP (página "MCP", na documentação do Codex).

Nota Depois de uma rotação do token, coloque o novo token no arquivo (ou na variável) e reinicie o Codex. Depois de alterar as caixas do token com Edit, reinicie o Codex também.

Próximo passo: teste a conexão.

FAQ #

Funciona com o ChatGPT? #

Sim, com o app de desktop do ChatGPT, que lê o mesmo config.toml. O ChatGPT no navegador não o lê.

O token deve ficar no arquivo ou em uma variável? #

Uma variável é mais seguro: com bearer_token_env_var, o token nunca fica no arquivo. O arquivo também funciona, desde que nunca vá para o Git nem para uma pasta compartilhada.

Por que o lanachat não aparece no `/mcp`? #

O bloco está no arquivo errado ou tem um erro de digitação. Confira o caminho e os colchetes, salve e reinicie o Codex.