Codex é o agente de programação da OpenAI e pode ser usado em três formatos: linha de comando, app desktop do ChatGPT ou extensão para IDE. Esses formatos usam a mesma configuração MCP, então, conectando o Survio uma vez, ele já fica disponível nas três formas.
💡 O ChatGPT pela web é diferente. Ele só aceita conectores criados pela própria OpenAI, então não dá para adicionar o Survio por lá. Use o app desktop, o CLI ou a extensão da IDE.
Antes de começar
Codex instalado e com login feito – pode ser pelo CLI, app desktop do ChatGPT ou extensão para IDE
Versão atualizada. Rode
codex --versione atualize se precisar; o suporte para servidores HTTP remotos já foi incluído.Conta Survio no Pro Business ou superior
Método 1 - Dois comandos
Passo 1 - Registrar o servidor
codex mcp add survio --url https://ai.survio.com/mcp
Passo 2 - Entrar
codex mcp login survio
Entre com sua Conta Survio no navegador e depois volte ao terminal.
Passo 3 - Testar
Liste as suas Pesquisas do Survio.
Método 2 - Pelo app desktop do ChatGPT
Passo 1 - Abrir as configurações do MCP
Configurações → Servidores MCP → Adicionar servidor.
Passo 2 - Digitar os dados do servidor
Nome:
survioTipo: HTTP streamable
URL:
https://ai.survio.com/mcp
Salvar, em seguida reinicie o aplicativo.
Passo 3 - Entrar
Entre com sua Conta Survio quando solicitado.
Método 3 - Pelo arquivo de configuração
Esse método dá mais controle. Toda alteração feita aqui vale tanto para o CLI quanto para o app desktop e a extensão para IDE.
Passo 1 - Abrir o arquivo de configuração
Escopo | Arquivo |
Todo o computador |
|
Projeto específico |
|
No Windows: %USERPROFILE%\.codex\config.toml. Crie o arquivo se ele ainda não existir.
Passo 2 - Adicionar o servidor do Survio
[mcp_servers.survio]url = "https://ai.survio.com/mcp"
O que vier depois do ponto (survio) é o nome que você vai usar nos comandos, então mantenha tudo minúsculo e sem espaços.
⚠️ TOML não é JSON. Se você copiar um bloco mcpServers em JSON para o config.toml, o Codex não vai iniciar. Use exatamente o bloco acima.
Passo 3 - Entrar
codex mcp login survio
A autorização fica salva em seu computador, então o config.toml guarda só o endereço do servidor.
Passo 4 - Conferir se deu certo
codex mcp list
O Survio precisa aparecer na lista.
Remover a conexão
codex mcp remove survio
Ou apague o bloco [mcp_servers.survio] do config.toml.