Puntos de integración
Askalot ofrece tres puntos de integración complementarios. Comparten las mismas capacidades de la plataforma y el mismo modelo de permisos: elija el que mejor se adapte a la forma en que su sistema se comunica con Askalot.
| Integración | Ideal para | Autenticación |
|---|---|---|
| Claude (MCP + plugin) | Agentes de IA que dirigen el ciclo de vida de la investigación conversando | Inicio de sesión en el navegador con OAuth 2.1 |
| API REST | Automatización entre servidores, CI, aplicaciones a medida | Token de API personal (encabezado X-Api-Token) |
| Formato de presentación de encuestas | Presentar encuestas en curso dentro de la interfaz de su propia aplicación | Las mismas credenciales REST |
Claude mediante MCP
Sección titulada «Claude mediante MCP»El servidor MCP de Askalot permite que Claude (Claude.ai, Claude Desktop, Claude Code) gestione proyectos, cuestionarios, campañas y análisis de datos directamente mediante conversación. Los usuarios de Claude Code pueden instalar además el plugin de Askalot: skills, comandos de barra y las herramientas MCP en un solo paquete. La autenticación es un flujo interactivo de OAuth 2.1; no hay claves de API que gestionar.
→ Guía de integración con Claude
API REST
Sección titulada «API REST»Todas las entidades de la plataforma —proyectos, cuestionarios, campañas, encuestados, encuestas, paquetes, grupos, estrategias— están disponibles en https://portor.<tenant>.askalot.io/api/v1, con una especificación OpenAPI 3.0 y una interfaz Swagger interactiva en /api/v1/docs.
La autenticación usa un token de API personal:
- Inicie sesión en
https://roundtable.<tenant>.askalot.ioy abra Configuración del perfil → Tokens de API - Genere un token (usted elige la caducidad; el token solo se muestra una vez)
- Envíelo en el encabezado
X-Api-Tokenen cada solicitud
El token hereda los roles y permisos de su cuenta y puede revocarse en cualquier momento; la revocación surte efecto de inmediato. El encabezado Authorization: Bearer de la API REST está reservado para los tokens de acceso OAuth (la credencial que usa el transporte MCP); los tokens de API viajan siempre en X-Api-Token.
Formato de presentación de encuestas
Sección titulada «Formato de presentación de encuestas»En lugar de incrustar una página de encuesta con el estilo de Askalot, su aplicación puede conducir una sesión de encuesta ítem a ítem y presentar cada pregunta con sus propios componentes de interfaz. Cada paso llega como un documento JSON autónomo —título de la pregunta, especificación del control de entrada y opciones válidas—, mientras el motor de Askalot mantiene en el servidor la lógica del flujo, la ramificación y la validación.
→ Formato de presentación de encuestas
Esta documentación en Markdown
Sección titulada «Esta documentación en Markdown»Los agentes y las herramientas de IA pueden leer esta documentación como Markdown puro en lugar de HTML:
| Lo que necesita | Dónde obtenerlo |
|---|---|
| Un índice de todas las páginas, con un resumen de una línea de cada una | https://docs.askalot.io/llms.txt |
| Toda la documentación en un solo archivo | https://docs.askalot.io/llms-full.txt |
| Una página | Añada index.md a la dirección de la página, por ejemplo https://docs.askalot.io/integrations/claude/index.md |
| Una página, sin cambiar su dirección | Solicite la página con el encabezado Accept: text/markdown |
El Markdown tiene el mismo contenido que ve en la página, y los enlaces que contiene son absolutos, de modo que un agente puede seguirlos desde cualquier punto de partida. Claude, conectado mediante MCP, también puede buscar y leer la documentación con las herramientas de documentación.