O Claude Code é o assistente de linha de comando da Anthropic. Conectar o Survio puxa resultados das suas Pesquisas direto para o que você estiver construindo, sem sair do terminal.

Cadastre o Survio por comando ou insira em um arquivo de configuração no projeto. No final, dá no mesmo.

Antes de começar

Claude Code instalado (veja como instalar)
Conta Survio em um plano Pro Business ou superior

Qual método escolher?

	Comando	Arquivo de configuração
Trabalho	Uma linha só	Criar ou editar um arquivo
Onde é válido	Todos os seus projetos, usando `--scope user`	Somente no projeto onde está o arquivo
Dá para compartilhar com a equipe?	Não	Sim, vai junto com o projeto

Cada um faz login na sua própria Conta Survio, então um arquivo de configuração compartilhado nunca compartilha seus dados ou login.

Método 1 - Pelo comando

Etapa 1 - Registrar o servidor

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

--scope user deixa o Survio acessível para todos os seus projetos. --scope project grava no .mcp.json do projeto atual; sem flag, vale só para o projeto e só para você.

Etapa 2 - Abrir o menu do MCP

Abra o Claude Code e execute:

/mcp

Selecione Survio na lista.

Etapa 3 - Fazer a autenticação

Escolha Autenticar e faça Login com sua Conta Survio no navegador. O status do Survio vai mudar para Conectado.

Etapa 4 - Testar

Veja a lista das suas Pesquisas Survio.

Método 2 - Usando .mcp.json

Esta opção é ideal quando a conexão deve ficar salva no projeto, pronta para todos que trabalharem nele.

Etapa 1 - Crie o .mcp.json na raiz do projeto

O ponto antes do nome é importante.

Etapa 2 - Adicionar o servidor Survio

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

Se o arquivo já tiver servidores, adicione "survio" dentro do objeto mcpServers existente, não crie outro:

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

Etapa 3 - Aprovar os servidores do projeto

Inicie o Claude Code na pasta do projeto e confirme quando ele perguntar se você confia nos servidores do .mcp.json. O aviso é proposital: um arquivo que veio de outro repositório só pode se conectar a qualquer lugar se você aprovar.

Etapa 4 - Fazer a autenticação

Digite /mcp, escolha Survio, clique em Autenticar e faça Login.

O .mcp.json armazena somente o endereço do servidor. Seu Login é salvo separado, só no seu computador.

Onde as configurações ficam salvas

Escopo	Arquivo	Para onde vale
`--scope user`	`~/.claude.json`	Todos os seus projetos
`--scope project`	`.mcp.json` na raiz do projeto	Esse projeto, compartilhado
Padrão (local)	`~/.claude.json`	Esse projeto, só para você

O app desktop do Claude Code

O aplicativo para desktop aceita as duas formas.

Adicione pela tela. Vá em Personalizar → Conectores, clique em Adicionar e escolha Adicionar conector personalizado. Dê o nome Survio, cole o endereço do servidor e faça Login quando o navegador abrir. O Survio aparece com tique verde e suas ferramentas aparecem listadas.

Ou use o comando acima. O app de desktop lê a mesma configuração do terminal, então um servidor registrado com --scope user já estará lá — não precisa fazer mais nada.

Atenção para algumas coisas:

Não use os dois modos juntos. Registrar um conector e usar claude mcp add vai mostrar as ferramentas em dobro.
Cada conversa carrega a configuração ao ser aberta. Uma que já estava aberta quando você adicionou o Survio não vai ver. Se o Survio pedir autenticação, rode /mcp, escolha Survio e clique em Autenticar.

Comandos úteis

claude mcp list              # mostra os servidores configurados e status
claude mcp get survio        # detalhes do servidor Survio
claude mcp remove survio     # remove a conexão

Como conectar o Survio ao Claude Code