Codex

Codex no VS Code — extensão oficial da OpenAI + config.toml.

Como conectar

O endpoint é sempre o mesmo. O que muda de sistema para sistema é só onde a configuração entra.

1
Instale a extensão Codex
No VS Code, abra as extensões com Ctrl + Shift + X, pesquise por “Codex” e instale a extensão oficial da OpenAI. Depois abra o painel pelo ícone do Codex; se ele não aparecer, use a Command Palette e execute Codex: Open Codex Sidebar.
2
Faça login
Entre na sua conta ChatGPT/OpenAI pelo próprio painel do Codex.
3
Gere sua SEA API Key
Entre em searchitect.pro com sua conta, vá em Minha Conta → SEA API Keys e gere uma chave. Ela aparece uma única vez: copie e guarde em local seguro.
Formato da chave
sea_live_xxxxxxxxxxxxxxxxx
4
Grave a chave como variável de ambiente
Para não deixar a chave em texto puro no config.toml, registre-a como variável de ambiente do usuário pelo terminal PowerShell do VS Code:
setx SEA_API_KEY "SUA_CHAVE_SEA"
Esperado
```
Feche completamente o VS Code e abra de novo — só assim a extensão recebe a nova variável.
```
5
Abra o config.toml
No painel do Codex: engrenagem → Codex Settings → Open config.toml. A configuração pessoal fica em ~/.codex/config.toml, e a extensão do VS Code compartilha esse arquivo com o CLI.
No Windows
C:\Users\SEU_USUARIO\.codex\config.toml
6
Adicione o servidor SEA
O Codex suporta MCP Streamable HTTP com Bearer Token, e bearer_token_env_var é justamente a opção que envia o token no header Authorization — sem a chave no arquivo.
config.toml
[mcp_servers.SEA-Systems-Enterprise-Architect] url = "https://mcp.searchitect.pro/mcp" bearer_token_env_var = "SEA_API_KEY" enabled = true required = true
7
Salve e reinicie a extensão
Pela própria interface: engrenagem → MCP servers → Restart extension.
8
Confirme no painel do Codex
O comando /mcp lista os servidores MCP ativos.
/mcp
Esperado
```
SEA-Systems-Enterprise-Architect
Connected
```

A documentação oficial também permite adicionar MCPs por MCP servers → Add server, mas para o SEA o config.toml é preferível: é ele que permite usar a chave via variável de ambiente em vez de armazená-la em texto puro.

Precisa da chave? Ela é exibida uma única vez ao ser gerada, e pode ser rotacionada ou revogada a qualquer momento.

Gerar minha API Key

Caso de uso

Migrar uma rotina antiga para o padrão atual

A situação

Existe uma customização escrita há anos que ainda usa um caminho desaconselhado, e ninguém tem certeza do que deve substituí-la.

O que você pede no Codex

Esta rotina usa uma abordagem antiga de acesso a dados no Sankhya. Qual é o padrão atual e como fica a reescrita preservando o comportamento?

O que volta

O Codex consulta o SEA para confirmar qual é o padrão vigente e o que mudou de comportamento entre os dois, e só então reescreve. Sem isso, a migração troca um problema conhecido por um desconhecido.

Teste se está funcionando

Primeiro um teste explícito, para confirmar que a ferramenta responde:

Use o SEA - Systems Enterprise Architect para analisar CRUDServiceProvider.loadRecords no Sankhya. Consulte o SEA antes de responder.

Depois o teste real, sem mencionar o SEA nem o Expert esperado. A ideia é verificar se o agente decide consultar o SEA automaticamente: ele deve chamar o servidor por conta própria, receber o roteamento do Core e responder com a evidência do Specialist.

Preciso consultar registros no Sankhya usando CRUDServiceProvider.loadRecords, retornando apenas alguns campos e aplicando critérios. Como devo estruturar essa chamada?

Deu 401 Unauthorized?

Confira, nesta ordem:

A chave foi copiada inteira, sem espaços nas pontas.
A chave não foi revogada nem rotacionada depois de configurada.
Sua conta Searchitect está ativa.
O acesso MCP está habilitado para a conta (mcp_enabled).
A chave não expirou.
O cliente realmente está enviando o header Authorization: Bearer.
No Claude web: o aplicativo não foi desconectado em Minha Conta → SEA API Keys. Se foi, refaça a conexão pelo próprio Claude.

Chaves revogadas e contas bloqueadas param de funcionar imediatamente. Se a chave se perdeu, rotacione-a em SEA API Keys — a antiga é invalidada na hora.