Claude Code es el asistente de línea de comandos de Anthropic. Al conectar Survio podrás importar los resultados de las encuestas directamente mientras trabajas, sin salir de la terminal.

Puedes registrar Survio con un comando o añadirlo a un archivo de configuración dentro de tu proyecto. Ambos métodos te llevan al mismo resultado.

Antes de empezar

Claude Code instalado (guía de instalación)
Una cuenta de Survio en PRO Business o superior

¿Qué método elegir?

	Un comando	Un archivo de configuración
Esfuerzo	Solo una línea	Crear o editar un archivo
Dónde aplica	Todos tus proyectos con `--scope user`	Solo el proyecto donde está el archivo
Compartido con el equipo	No	Sí, viaja junto al proyecto

Cada quien inicia sesión con su cuenta de Survio, así que compartir el archivo de configuración nunca comparte tus datos ni tu acceso.

Método 1 - Un comando

Paso 1 - Registra el servidor

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

--scope user hace que Survio esté disponible en todos tus proyectos. --scope project lo agrega al .mcp.json del proyecto actual; sin bandera solo quedará en el proyecto donde lo ejecutaste, solo para ti.

Paso 2 - Abre el menú MCP

Abre Claude Code y ejecuta:

/mcp

Selecciona Survio de la lista.

Paso 3 - Autenticar

Selecciona Autenticar e inicia sesión con tu cuenta de Survio en el navegador. El estado de Survio cambiará a Conectado.

Paso 4 - Pruébalo

Lista mis encuestas de Survio.

Método 2 - .mcp.json

Úsalo cuando quieras que la conexión esté disponible para todo el equipo que trabaje en el proyecto.

Paso 1 - Crea .mcp.json en la raíz de tu proyecto

Recuerda: el punto inicial es importante.

Paso 2 - Agrega el servidor de Survio

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

Si el archivo ya tiene otros servidores, solo añade "survio" dentro del objeto mcpServers que exista, no crees uno nuevo:

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

Paso 3 - Aprueba los servidores del proyecto

Abre Claude Code en esa carpeta y acepta cuando te pregunte si confías en los servidores de .mcp.json. Ese mensaje aparece porque, por seguridad, un archivo que llega desde el repositorio de otra persona no puede conectarse a nada sin que tú lo autorices.

Paso 4 - Autenticar

Ejecuta /mcp, selecciona Survio, pulsa Autenticar e inicia sesión.

.mcp.json solo guarda la dirección del servidor. Tu acceso personal se almacena aparte, solo en tu equipo.

Dónde se almacenan los ajustes

Ámbito	Archivo	Se aplica a
`--scope user`	`~/.claude.json`	Todos tus proyectos
`--scope project`	`.mcp.json` en la raíz del proyecto	Ese proyecto, compartido con el equipo
Predeterminado (local)	`~/.claude.json`	Ese proyecto, solo para ti

La app de escritorio de Claude Code

La app de escritorio te permite seguir cualquiera de las dos rutas.

Añádelo en pantalla. Ve a Adaptar → Conectores, haz clic en Añadir y elige Añadir conector personalizado. Nómbralo Survio, pega la dirección del servidor e inicia sesión cuando se abra el navegador. Survio aparecerá marcado en verde y con sus herramientas listadas.

O usa el comando anterior. La app de escritorio utiliza la misma configuración que la terminal, así que si ya registraste el servidor con --scope user, no tienes que hacer nada más.

Dos cosas importantes:

No hagas las dos cosas. Un conector más un claude mcp add te dejarán con las herramientas duplicadas.
Una conversación carga la configuración al iniciarse. Si ya está abierta cuando añades Survio puede que no lo veas, y si aparece como que requiere autenticación, ejecuta /mcp, selecciona Survio y pulsa Autenticar.

Comandos útiles

claude mcp list              # servidores configurados y su estado
claude mcp get survio        # detalles para el servidor de Survio
claude mcp remove survio     # elimina la conexión

Cómo conectar Survio a Claude Code