O Codex é o agente de programação da OpenAI, disponível em três versões: a ferramenta de linha de comandos, a aplicação Codex e a extensão para IDE. Todas utilizam uma configuração MCP única, portanto, basta ligar o Survio uma vez para funcionar em todas.
💡 Está a usar o ChatGPT? Liga-se separadamente, pelo modo de programador – veja ChatGPT mais abaixo.
Antes de começar
Codex já instalado e sessão iniciada – seja a CLI, a aplicação Codex ou a extensão para IDE
Ter uma versão recente instalada. Digite
codex --versione atualize se necessário; recentemente foi incluído suporte para servidores HTTP remotos.Uma a Minha Conta Survio num plano Pro Business ou superior
Encontre as etapas no Survio
Abra qualquer Inquérito e aceda a Recolher Respostas. No painel à esquerda, em Automatizações & Integrações, clique em MCP. Em Ligar Ferramentas, selecione Codex – o Survio mostrará os passos de ligação e o endereço do servidor com um botão Copiar.
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 a Minha Conta Survio no navegador, depois volte ao terminal.
Passo 3 – Experimentar
Listar os meus inquéritos Survio.
Método 2 – A aplicação Codex
Passo 1 – Abrir as definições MCP
Nas Definições da Aplicação Codex, abra Plugins, clique em Adicionar e escolha Adicionar Servidor MCP.
Passo 2 – Introduzir os dados do servidor
Nome:
survioTipo: HTTP transmissível
URL:
https://ai.survio.com/mcp
Deixe os restantes campos em branco, clique em Guardar e reinicie a aplicação.
Passo 3 – Iniciar sessão
Inicie sessão com a Minha Conta Survio quando solicitado.
Método 3 – O ficheiro de configuração
A opção mais controlada. As alterações aqui aplicam-se à CLI, à aplicação e à extensão para IDE igualmente.
Passo 1 – Abrir o ficheiro de configuração
Âmbito | Ficheiro |
Toda a Máquina |
|
Projeto Individual |
|
No Windows: %USERPROFILE%\.codex\config.toml. Crie se ainda não existir.
Passo 2 – Adicionar o servidor Survio
[mcp_servers.survio] url = "https://ai.survio.com/mcp"
A parte após o ponto – survio – é o nome a usar nos comandos, por isso utilize minúsculas e sem espaços.
⚠️ TOML não é JSON. Se colar um bloco mcpServers em JSON no config.toml, o Codex não será iniciado. Utilize exatamente o bloco acima.
Passo 3 – Iniciar sessão
codex mcp login survio
A autorização fica guardada na máquina, por isso o config.toml só deverá conter o endereço do servidor.
Passo 4 – Verificar se funcionou
codex mcp list
O Survio deve aparecer na lista.
Remover a ligação do Codex
codex mcp remove survio
Ou elimine o bloco [mcp_servers.survio] do config.toml.
ChatGPT
O ChatGPT liga-se ao Survio como uma aplicação criada em modo de programador.
Encontre as etapas no Survio
Abra qualquer Inquérito e aceda a Recolher Respostas. No painel à esquerda, em Automatizações & Integrações, clique em MCP. Em Ligar Ferramentas, escolha Chat GPT – o Survio mostrará os passos de ligação e o endereço do servidor com um botão Copiar.
Passo 1 – Ativar o modo de programador
No ChatGPT, aceda a Definições → Aplicações → Definições Avançadas e ative o Modo de Programador.
Passo 2 – Criar a aplicação Survio
Volte a Definições → Aplicações e clique em Criar Aplicação. Preencha Survio como nome, cole o endereço do servidor e selecione OAuth como método de autenticação.
https://ai.survio.com/mcp
Passo 3 – Iniciar sessão
Clique em Criar e entre com a Minha Conta Survio para autorizar o acesso.
Passo 4 – Experimentar
Num novo chat, selecione Survio no menu + e peça:
Listar os meus inquéritos Survio.