Integración con Claude
El servidor MCP de Askalot permite que Claude gestione encuestas, campañas, encuestados y análisis de datos directamente mediante conversación. Esta guía explica la configuración en todas las interfaces de Claude.
Visión general
Sección titulada «Visión general»La integración expone 127 herramientas, cada una de las cuales pertenece exactamente a uno de diecisiete conjuntos de herramientas. Son los mismos nombres a los que puede limitar una conexión con ?toolsets=; consulte Limitar las herramientas que ve una conexión.
| Conjunto de herramientas | Herramientas | Ejemplos |
|---|---|---|
sampling |
23 | Encuestados, grupos, estrategias de muestreo: crear, seleccionar, renovar, obtener vista previa |
fielding |
21 | Encuestas, invitaciones, carga de trabajo de los entrevistadores, el flujo de respuesta, llenados sintéticos |
analysis |
20 | Paquetes, el proceso Bronce/Plata/Oro, selección de codificación, calidad, exportación |
questionnaire |
17 | Crear y gestionar archivos QML, validar con Z3, publicar, cargar |
campaign |
8 | Crear campañas, asociar un cuestionario, asignar un grupo |
project |
7 | Crear proyectos, gestionar la propiedad |
documents |
4 | Buscar y leer sus documentos de investigación indexados |
methodology |
4 | Buscar en 24 artículos de metodología revisados por pares |
audit |
3 | Consultar el registro de auditoría |
session |
4 | Ver en qué organizaciones puede actuar la sesión, moverla entre ellas, buscar usuarios |
conversation |
4 | Registrar y volver a leer la conversación de una ejecución de un agente |
docs |
3 | Buscar y leer la documentación de Askalot |
paper |
3 | Leer y editar con anclas el artículo de investigación del proyecto, seguir la cadena de respuesta a los objetivos |
composite |
3 | Ejecutar toda una cadena en una sola llamada: trabajo de campo, simulación o el proceso de conjuntos de datos |
tasks |
1 | get_task_status: consultar un trabajo de larga duración mediante el task_id que devolvió |
entitlements |
1 | Leer qué cubre su suscripción |
discovery |
1 | list_toolsets: qué contiene cada conjunto de herramientas y cuáles nombró esta conexión |
Las ocho últimas filas se admiten en todas las conexiones, nombren lo que nombren; las nueve primeras son las que filtra ?toolsets=.
Autenticación
Sección titulada «Autenticación»Askalot usa OAuth 2.1 con PKCE y registro dinámico de clientes (RFC 7591). Claude gestiona todo el flujo automáticamente: usted solo inicia sesión con sus credenciales de Askalot cuando se le pide.
Cómo funciona
Sección titulada «Cómo funciona»- Claude descubre los puntos de conexión OAuth de Askalot mediante
/.well-known/oauth-authorization-server - Claude se registra como cliente OAuth mediante
POST /register(una sola vez, automáticamente) - Se abre una ventana del navegador para que inicie sesión en
oidc.platform.askalot.io - Tras el inicio de sesión, Claude recibe un token de acceso y se conecta al servidor MCP
No hace falta ninguna clave de API ni gestionar tokens a mano.
Puntos de conexión OAuth
Sección titulada «Puntos de conexión OAuth»| Punto de conexión | Finalidad |
|---|---|
GET /.well-known/oauth-authorization-server |
Descubrimiento de los metadatos del servidor |
GET /.well-known/oauth-protected-resource/mcp |
Metadatos del recurso protegido |
POST /register |
Registro dinámico de clientes |
GET /authorize |
Autorización (redirige al inicio de sesión OIDC) |
POST /token |
Intercambio de tokens (authorization_code, refresh_token) |
POST /revoke |
Revocación de tokens |
Funciones admitidas: código de autorización con PKCE (S256), tokens de actualización, ámbitos (mcp:read, mcp:write, mcp:admin).
URL del inquilino
Sección titulada «URL del inquilino»Sustituya <tenant> por el identificador de su inquilino en todas las URL siguientes. Inquilinos habituales:
dev: prueba gratuita y demostración (organización ACME Corp)eu1: producción en la UE (clientes de pago y universidades)
Punto de conexión MCP: https://portor.<tenant>.askalot.io/mcp
Claude.ai (web)
Sección titulada «Claude.ai (web)»- Vaya a claude.ai y abra Settings
- Vaya a Integrations (o Connectors)
- Haga clic en Add Custom MCP Server
- Introduzca:
- Name:
Askalot - URL:
https://portor.<tenant>.askalot.io/mcp
- Name:
- Haga clic en Connect: se abre una ventana del navegador para iniciar sesión con OAuth
- Inicie sesión con sus credenciales de Askalot y autorice el acceso
Claude Desktop
Sección titulada «Claude Desktop»Claude Desktop se conecta a Askalot como un conector personalizado remoto: obtiene solo las herramientas / la API de MCP (sin agentes, skills ni comandos), y no hay ninguna extensión de escritorio (.mcpb) que instalar, porque Portor es un servidor remoto.
Añadir un conector personalizado (recomendado)
Sección titulada «Añadir un conector personalizado (recomendado)»- Abra Settings → Connectors (en algunas versiones está en Customize → Connectors)
- Haga clic en Add custom connector
- Introduzca:
- Name:
Askalot - Remote MCP server URL:
https://portor.<tenant>.askalot.io/mcp
- Name:
- Haga clic en Add: se abre una ventana del navegador para iniciar sesión con OAuth
- Inicie sesión con sus credenciales de Askalot y autorice el acceso
El consentimiento de OAuth es interactivo y se da una sola vez; Claude Desktop guarda y renueva el token por usted. Una vez conectado, las herramientas de encuestas, campañas, conjuntos de datos y análisis aparecen en la lista de herramientas del conector. No hay ninguna clave de API ni token estático que pegar: Askalot usa OAuth 2.1.
Alternativa mediante el archivo de configuración
Sección titulada «Alternativa mediante el archivo de configuración»Si prefiere editar directamente el archivo de configuración, añada el servidor remoto en mcpServers en el archivo correspondiente a su sistema:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{ "mcpServers": { "askalot": { "type": "http", "url": "https://portor.<tenant>.askalot.io/mcp" } }}Reinicie Claude Desktop después de guardar. En el primer uso, se abre una ventana del navegador para iniciar sesión con OAuth.
Claude Code (CLI)
Sección titulada «Claude Code (CLI)»Claude Code puede conectarse de dos maneras.
Instalar el plugin de Askalot (funcionalidad completa)
Sección titulada «Instalar el plugin de Askalot (funcionalidad completa)»/plugin marketplace add askalot-io/askalot-plugin/plugin install askalot@askalotEl plugin incluye los agentes, skills y comandos de barra de Askalot y las herramientas MCP. Su configuración MCP (.mcp.json) es de type: http, apunta a ${ASKALOT_MCP_URL} y usa OAuth interactivo: sin token bearer estático. Defina ASKALOT_MCP_URL en su shell antes de iniciar Claude Code:
export ASKALOT_MCP_URL="https://portor.<tenant>.askalot.io/mcp"Si no la define, el plugin se conecta al inquilino de prueba gratuita. Si su cuenta está en otro inquilino, el inicio de sesión se completa igualmente y termina con user_not_in_tenant. El mensaje indica el inquilino que se comprobó, el inquilino para el que era su inicio de sesión y la URL exacta de ese inquilino. Defina la variable con esa URL y vuelva a iniciar Claude Code.
Añadir solo el servidor MCP
Sección titulada «Añadir solo el servidor MCP»Si solo quiere las herramientas (sin agentes, skills ni comandos):
claude mcp add --transport http askalot https://portor.<tenant>.askalot.io/mcpEn el primer uso, Claude Code abre un navegador para iniciar sesión con OAuth. Tras la autenticación, el token se guarda localmente y se renueva automáticamente.
Ejemplos de uso
Sección titulada «Ejemplos de uso»Crear una campaña de encuestas
Sección titulada «Crear una campaña de encuestas»You: Create a customer satisfaction campaign with 50 test respondents.
Claude: I'll set up that campaign for you.
→ list_projects() — found "Customer Research" project→ create_campaign("CSAT Q1 2026", project_id, questionnaire_id, admits_volunteers=false, offers_ai_channel=false)→ bulk_create_respondents(50, project_id)→ create_respondent_pool("CSAT Pool", respondent_ids=...)→ assign_pool_to_campaign(campaign_id, pool_id)
Done! Campaign "CSAT Q1 2026" is ready with 50 respondents.Analizar los resultados de una encuesta
Sección titulada «Analizar los resultados de una encuesta»You: Extract and weight the results from my latest campaign.
Claude: I'll build a Bundle and derive a weighted dataset from your campaign data.
→ list_campaigns(status="completed")→ create_bundle("CSAT Results", project_id, questionnaire_id, campaign_ids=[campaign_id])→ create_bronze_dataset(bundle_id)→ code_open_ends(bundle_id) # codes open-ends, then weights the coded case base→ get_dataset(silver_dataset_id) # poll until "ready" — comparing earlier returns a conflict→ compare_bundle_quality(bundle_id)
The weighted dataset reduced RMSE from 0.08 to 0.02.Gender distribution now matches targets within 1%.Validar un cuestionario
Sección titulada «Validar un cuestionario»You: Check my new questionnaire for logical errors.
Claude: I'll run Z3 analysis on your QML file.
→ validate_qml_file("satisfaction.qml")
The questionnaire has 12 items across 3 blocks.Found 1 issue: Item 'q_followup' is unreachable becauseits precondition requires q_satisfied < 3, but q_satisfieduses a scale of 1-5 with no path setting it below 3.Anotaciones de las herramientas
Sección titulada «Anotaciones de las herramientas»Todas las herramientas incluyen anotaciones MCP para una interacción segura con la IA:
- Herramientas de solo lectura (
list_*,get_*,search_*): marcadas conreadOnlyHint=true; Claude puede llamarlas libremente - Herramientas de escritura (
create_*,update_*): marcadas condestructiveHint=false; modificaciones seguras - Herramientas de eliminación (
delete_*,remove_*): marcadas condestructiveHint=true; Claude pedirá confirmación antes de ejecutarlas - Herramientas externas (
send_*_invitation): marcadas conopenWorldHint=true; envían correos electrónicos reales
La anotación de solo lectura no es solo una recomendación para Claude: en una organización sellada es lo que usa el propio Askalot para decidir qué llamadas rechazar. Todo lo que no está marcado como de solo lectura se trata allí como una escritura y se responde con org_sealed, salvo las herramientas de diseño que solo inician o recorren una vista previa, que no cambian nada del registro de investigación y siguen funcionando.
Paginación
Sección titulada «Paginación»Las herramientas de listado admiten paginación para que las respuestas sean concisas:
→ list_respondents(name="Smith", limit=10)→ list_campaigns(status="active", limit=5)→ list_surveys(status="completed", limit=20)Todas las herramientas de listado tienen limit=100 como valor predeterminado y devuelven metadatos:
{ "items": [...], "count": 10, "limit": 100}