Claude Code é o assistente de linha de comando da Anthropic. Conectar o Survio permite trazer os resultados das suas Pesquisas direto para o que você está desenvolvendo, sem sair do terminal.

Você pode registrar o Survio por comando ou colocar num arquivo de configuração no projeto. No fim, o resultado é o mesmo.

Antes de começar

Claude Code instalado (guia de instalação)
Conta Survio no plano Pro Business ou superior

Faça assim no Survio

Abra qualquer Pesquisa e clique em Coletar respostas. No menu à esquerda, em Integrações, clique em MCP. Em Conectar ferramentas, selecione Claude Code – o Survio mostra o passo a passo e o endereço do servidor, além de um botão Copiar.

Survio MCP page with the Claude Code tab selected under Connect tools

Qual método usar?

	Comando	Arquivo de configuração
Esforço	Apenas uma linha	Criar ou ajustar um arquivo
Onde vale	Todos seus projetos, usando `--scope user`	Só no projeto onde está o arquivo
Compartilha com a equipe?	Não	Sim – vai junto com o projeto

Cada pessoa entra com a própria Conta Survio, então o arquivo de configuração compartilhado nunca compartilha seus dados ou Login.

Método 1 - Comando

Passo 1 - Registrar o servidor

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

--scope user deixa o Survio disponível em todos os seus projetos. --scope project grava no .mcp.json do projeto atual; se não passar nenhum parâmetro, vale só para aquele projeto e só para você.

Passo 2 - Abrir o menu MCP

Abra o Claude Code e digite:

/mcp

Escolha Survio na lista.

Passo 3 - Autenticar

Selecione Autenticar, depois faça Login com sua Conta Survio no navegador. O status do Survio vai mudar para Conectado.

Passo 4 - Testar

Liste minhas Pesquisas Survio.

Método 2 - .mcp.json

Use quando quiser deixar a conexão disponível para toda a equipe, direto no projeto.

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

O ponto no começo do nome é importante.

Passo 2 - Adicione o servidor Survio

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

Se o arquivo já tiver outros servidores, adicione "survio" dentro do objeto mcpServers que já existe, não precisa criar outro:

{
  "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

Abra o Claude Code na pasta do projeto e aprove quando aparecer o aviso perguntando se você confia nos servidores do .mcp.json. Esse aviso é intencional: um arquivo que veio de outro repositório não pode conectar a nada sem sua autorização.

Passo 4 - Autenticar

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

O .mcp.json só guarda o endereço do servidor. Seu Login fica salvo separado, só na sua máquina.

Onde ficam as configurações

Escopo	Arquivo	Vale para
`--scope user`	`~/.claude.json`	Todos os seus projetos
`--scope project`	`.mcp.json` na raiz do projeto	Aquele projeto, acessível à equipe
Padrão (local)	`~/.claude.json`	Aquele projeto, só para você

O app desktop do Claude Code

No app desktop, dá pra fazer dos dois jeitos.

Adicione direto na tela. Vá em Configurações → Conectores (ou 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 abrir o navegador. O Survio vai ficar listado lá com um tique verde e as ferramentas disponíveis.

Ou use o comando acima. O app desktop usa a mesma configuração do terminal, então se você registrar o servidor com --scope user, já aparece lá – não precisa repetir.

Dicas importantes:

Não faça os dois jeitos. Um conector mais o claude mcp add faz as ferramentas aparecerem duplicadas.
Cada conversa lê a configuração só ao abrir. Se já estava aberta quando você adicionou o Survio, ele não vai aparecer. E se o Survio mostrar que precisa de autenticação, rode /mcp, escolha Survio e clique em Autenticar.

Comandos úteis

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

Como conectar o Survio ao Claude Code