Servidor MCP

MCP Server

Model Context Protocol (MCP) es un estándar que permite a los modelos de IA (Claude, Cursor, Copilot, etc.) conectarse a SurveyNinja y trabajar con sus datos directamente: leer encuestas, respuestas, analíticas y realizar acciones sin copiar manualmente.

1. Conexión

Endpoint

Dos formas de conectarse

• Permitir acceso (recomendado). Agregue la dirección del servidor a su asistente, inicie sesión en SurveyNinja cuando se lo pida, elija un espacio de trabajo y haga clic en Permitir acceso. No necesita clave: el asistente trabaja en el espacio que eligió y renueva el acceso por sí solo.
• Clave API. Para clientes que no pueden iniciar sesión, o cuando un asistente debe trabajar en todos los espacios donde usted es propietario o miembro. Pase la clave en un encabezado, como se muestra abajo.

Claude

1. En Claude en la web o en la app de escritorio, abra Settings, luego Connectors, y haga clic en Add custom connector.
2. Escriba un nombre, por ejemplo SurveyNinja, y la dirección del servidor.
3. Haga clic en Add, luego en Connect, y permita el acceso en SurveyNinja.

En los planes Team y Enterprise de Claude, primero el propietario de la organización agrega el conector y después cada miembro lo conecta.

ChatGPT

1. Active el modo de desarrollador en la configuración de ChatGPT. Está disponible en algunos planes de ChatGPT.
2. Cree un conector con la dirección del servidor y autenticación OAuth.
3. Permita el acceso en SurveyNinja.

Claude Code

Ejecute el comando en la terminal, luego escriba /mcp en Claude Code, elija surveyninja e inicie sesión.

claude mcp add --transport http surveyninja https://mcp.surveyninja.io/mcp/v1

Con las skills listas, como plugin que agrega el servidor y todas las skills en una sola instalación:

/plugin marketplace add surveyninjaio/surveyninja-mcp /plugin install surveyninja@surveyninja

Cursor

Agregue el servidor a ~/.cursor/mcp.json para todos los proyectos, o a .cursor/mcp.json para uno solo. Luego abra la sección MCP en la configuración de Cursor e inicie sesión en el servidor surveyninja.

{
  "mcpServers": {
    "surveyninja": {
      "url": "https://mcp.surveyninja.io/mcp/v1"
    }
  }
}

VS Code

Agregue el servidor a .vscode/mcp.json en su proyecto, inícielo desde el archivo e inicie sesión cuando VS Code lo pida. El servidor funciona en GitHub Copilot Chat en modo agente.

{
  "servers": {
    "surveyninja": {
      "type": "http",
      "url": "https://mcp.surveyninja.io/mcp/v1"
    }
  }
}

Obtener una clave API

1. Inicie sesión en su cuenta de SurveyNinja.
2. Vaya a Settings → API / MCP.
3. Haga clic en "Crear clave API" y cópiela — la clave solo se muestra una vez.

Autenticación

Pase la clave API en el encabezado Authorization :

Para un cliente que acepta el formato mcpServers con encabezados, reemplace YOUR_API_KEY por su clave:

{
  "mcpServers": {
    "surveyninja": {
      "url": "https://mcp.surveyninja.io/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Configuraciones para cada cliente y las skills como archivos: github.com/surveyninjaio/surveyninja-mcp.

Límites de frecuencia

• 180 solicitudes por minuto por usuario (tools/call, resources/read, etc.)
• Los enlaces de exportación son válidos durante 1 hora

2. Recursos

Los recursos son de solo lectura. Para utilizarlos, envíe una solicitud resources/read con el URI correspondiente.

3. Herramientas

Las herramientas son acciones ejecutadas en el lado de SurveyNinja a solicitud de un modelo de IA mediante el método tools/call .

Gestión de encuestas

Contenido y estructura de la encuesta

Temas de diseño

Variables de encuesta

Opciones ocultas

Respuestas, analíticas y enlaces públicos

Exportación

Todas las herramientas aceptan quiz_id (requerido). El enlace de descarga es válido durante 1 hora.

Códigos promocionales (plan de pago)

4. Detalles técnicos

Métodos JSON-RPC estándar

Ejemplo de solicitud

POST https://mcp.surveyninja.io/mcp/v1 Authorization: Bearer 42|xK7mP9nQ2wL5eH8jR3vU6tY0iD4aF1bG Content-Type: application/json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "rename_quiz", "arguments": { "quiz_id": 123, "name": "New survey name" } } }

Formato de respuesta de error

{ "jsonrpc": "2.0", "id": 1, "error": { "code": -32602, "message": "Invalid params: quiz_id is required" } }

5. Escenarios típicos