# Conecte o Codex

_Conectar Claude / Codex · Leitura de 2 min · Atualizado 2026-11-08 · https://lanachat.ai/guides/pt/ai-connect-codex/_

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](https://lanachat.ai/guides/pt/ai-install-assistant/)) e do seu token ([guia](https://lanachat.ai/guides/pt/ai-create-mcp-token/)); 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.

```toml
[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:

```toml
[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:

```bash
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

1. Inicie o Codex: `codex`.
2. Digite `/mcp` e pressione Enter.
3. `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](https://lanachat.ai/guides/pt/ai-test-connection/).

## 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](https://lanachat.ai/guides/pt/ai-create-mcp-token/)) 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](https://lanachat.ai/guides/pt/ai-troubleshooting/).

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

> Note: 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](https://lanachat.ai/guides/pt/ai-test-connection/).

## 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.

## Artigos relacionados

- [Crie seu token MCP](https://lanachat.ai/guides/pt/ai-create-mcp-token/)
- [Teste a conexão](https://lanachat.ai/guides/pt/ai-test-connection/)
- [Solução de problemas do MCP: 401, 403, ferramentas ausentes](https://lanachat.ai/guides/pt/ai-troubleshooting/)