O Claude Code é o assistente de linha de comandos da Anthropic. Ao ligar o Survio, pode importar resultados de inquérito para aquilo que está a desenvolver, sem sair do terminal.

Registe o Survio com um comando ou insira-o num ficheiro de configuração residente no seu projeto. Ambos acabam no mesmo local.

Antes de começar

Claude Code instalado (guia de instalação)
Uma conta Survio em Pro Business ou superior

Qual o método?

	Um comando	Um ficheiro de configuração
Esforço	Uma linha	Criar ou editar um ficheiro
Onde se aplica	Todos os projetos, com `--scope user`	O projeto onde está o ficheiro
Partilhado com equipa	Não	Sim – acompanha o projeto

Cada pessoa entra com a sua própria conta Survio, por isso um ficheiro de configuração partilhado nunca partilha os seus dados nem a sessão.

Método 1 – Um comando

Passo 1 – Registar o servidor

claude mcp add survio --scope user --transport http https://ai.survio.com/mcp

--scope user torna o Survio disponível em todos os seus projetos. --scope project grava no .mcp.json do projeto atual; sem parâmetro, permanece apenas no projeto atual, apenas para si.

Passo 2 – Abrir o menu MCP

Inicie o Claude Code e execute:

/mcp

Selecione Survio da lista.

Passo 3 – Autenticar

Escolha Autenticar e, em seguida, inicie sessão com a sua conta Survio no navegador. O estado do Survio muda para Ligado.

Passo 4 – Testar

Listar os meus inquéritos Survio.

Método 2 – .mcp.json

Para quando a ligação deve residir no projeto, pronta para todos que nele trabalham.

Passo 1 – Criar o .mcp.json na raiz do projeto

O ponto inicial é relevante.

Passo 2 – Adicionar o servidor Survio

{  "mcpServers": {    "survio": {      "type": "http",      "url": "https://ai.survio.com/mcp"    }  }}

Se o ficheiro já tiver servidores, adicione "survio" dentro do objeto mcpServers existente, sem duplicar:

{  "mcpServers": {    "some-other-server": {      "type": "http",      "url": "https://example.com/mcp"    },    "survio": {      "type": "http",      "url": "https://ai.survio.com/mcp"    }  }}

Passo 3 – Aprovar os servidores do projeto

Inicie o Claude Code nessa pasta e aprove quando lhe for perguntado se confia nos servidores do .mcp.json. O aviso não é por acaso: um ficheiro que veio de outro repositório só se pode ligar se autorizar.

Passo 4 – Autenticar

Execute /mcp, selecione Survio, escolha Autenticar e faça login.

O .mcp.json guarda apenas o endereço do servidor. A sua autenticação é guardada separadamente na sua máquina.

Onde as definições são guardadas

Âmbito	Ficheiro	Aplica-se a
`--scope user`	`~/.claude.json`	Todos os seus projetos
`--scope project`	`.mcp.json` na raiz do projeto	Esse projeto, partilhado
predefinido (local)	`~/.claude.json`	Esse projeto, apenas para si

A aplicação de desktop Claude Code

A aplicação de desktop permite ambos os métodos.

Adicione no ecrã. Vá a Personalizar → Conectores, clique em Adicionar e escolha Adicionar conector personalizado. Nomeie como Survio, cole o endereço do servidor e faça login ao abrir o navegador. O Survio aparecerá com um visto verde e as ferramentas respetivas listadas.

Ou use o comando acima. A aplicação desktop lê a mesma configuração do terminal, logo, um servidor registado com --scope user já está presente – não é preciso mais nada.

Duas notas importantes:

Não faça ambos. Um conector mais um claude mcp add deixa-o com as ferramentas em duplicado.
Uma conversa carrega a configuração ao iniciar. Uma conversa aberta antes de adicionar o Survio não o verá; e se o Survio aparecer como precisando de autenticação, execute /mcp, selecione Survio e escolha Autenticar.

Comandos úteis

claude mcp list              # servidores configurados e respetivo estado
claude mcp get survio        # detalhes para o servidor Survio
claude mcp remove survio     # remover a ligação

Como ligar o Survio ao Claude Code