O Codex é o agente de programação da OpenAI, disponível em três formatos: ferramenta de linha de comando, aplicativo desktop do ChatGPT e extensão para IDE. Todos partilham a mesma configuração MCP, então, ao ligar o Survio uma vez, estará disponível em qualquer uma dessas opções.
💡 O ChatGPT na web funciona de maneira diferente. Utiliza apenas conectores fornecidos pela OpenAI, por isso não é possível adicionar o Survio nessa versão. Use o aplicativo desktop, o CLI ou a extensão para IDE.
Antes de começar
Codex instalado e sessão iniciada – via CLI, aplicativo desktop do ChatGPT ou extensão para IDE
Versão atualizada do Codex. Execute
codex --versione atualize, se necessário. O suporte para servidores HTTP remotos foi introduzido gradualmente.Conta Survio ativa com plano Pro Business ou superior
Método 1 – Dois comandos
Passo 1 – Registar o servidor
codex mcp add survio --url https://ai.survio.com/mcp
Passo 2 – Iniciar sessão
codex mcp login survio
Inicie sessão com a sua conta Survio no navegador e depois retorne ao terminal.
Passo 3 – Testar ligação
Listar os meus inquéritos Survio.
Método 2 – Aplicativo desktop do ChatGPT
Passo 1 – Abrir definições MCP
Definições → Servidores MCP → Adicionar servidor.
Passo 2 – Inserir os dados do servidor
Nome:
survioTipo: HTTP transmitido
URL:
https://ai.survio.com/mcp
Guardar e reiniciar o aplicativo.
Passo 3 – Iniciar sessão
Inicie sessão com a sua conta Survio quando solicitado.
Método 3 – O ficheiro de configuração
Esta é a opção que oferece mais controlo. As alterações aqui aplicam-se ao CLI, ao aplicativo desktop e à extensão para IDE.
Passo 1 – Abrir o ficheiro de configuração
Abrangência | Ficheiro |
Toda a máquina |
|
Apenas um projeto |
|
No Windows: %USERPROFILE%\.codex\config.toml. Crie o ficheiro caso não exista.
Passo 2 – Adicionar o servidor Survio
[mcp_servers.survio]url = "https://ai.survio.com/mcp"
A parte após o ponto – survio – é o nome utilizado nos comandos, por isso mantenha em minúsculas e sem espaços.
⚠️ TOML não é JSON. Se um bloco JSON mcpServers for adicionado ao config.toml, o Codex não inicia. Use apenas o exemplo acima, exatamente como está.
Passo 3 – Iniciar sessão
codex mcp login survio
A autorização será guardada na máquina, por isso o config.toml contém apenas o endereço do servidor.
Passo 4 – Confirmar que funcionou
codex mcp list
O Survio deve aparecer na lista.
Remover a ligação
codex mcp remove survio
Ou elimine o bloco [mcp_servers.survio] do config.toml.