Ir al contenido
Base de conocimiento

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.

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=.

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.

  1. Claude descubre los puntos de conexión OAuth de Askalot mediante /.well-known/oauth-authorization-server
  2. Claude se registra como cliente OAuth mediante POST /register (una sola vez, automáticamente)
  3. Se abre una ventana del navegador para que inicie sesión en oidc.platform.askalot.io
  4. 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.

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).

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

  1. Vaya a claude.ai y abra Settings
  2. Vaya a Integrations (o Connectors)
  3. Haga clic en Add Custom MCP Server
  4. Introduzca:
    • Name: Askalot
    • URL: https://portor.<tenant>.askalot.io/mcp
  5. Haga clic en Connect: se abre una ventana del navegador para iniciar sesión con OAuth
  6. Inicie sesión con sus credenciales de Askalot y autorice el acceso

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.

Sección titulada «Añadir un conector personalizado (recomendado)»
  1. Abra Settings → Connectors (en algunas versiones está en Customize → Connectors)
  2. Haga clic en Add custom connector
  3. Introduzca:
    • Name: Askalot
    • Remote MCP server URL: https://portor.<tenant>.askalot.io/mcp
  4. Haga clic en Add: se abre una ventana del navegador para iniciar sesión con OAuth
  5. 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 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@askalot

El 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:

Ventana de terminal
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.

Si solo quiere las herramientas (sin agentes, skills ni comandos):

Ventana de terminal
claude mcp add --transport http askalot https://portor.<tenant>.askalot.io/mcp

En 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.

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.
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%.
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 because
its precondition requires q_satisfied < 3, but q_satisfied
uses a scale of 1-5 with no path setting it below 3.

Todas las herramientas incluyen anotaciones MCP para una interacción segura con la IA:

  • Herramientas de solo lectura (list_*, get_*, search_*): marcadas con readOnlyHint=true; Claude puede llamarlas libremente
  • Herramientas de escritura (create_*, update_*): marcadas con destructiveHint=false; modificaciones seguras
  • Herramientas de eliminación (delete_*, remove_*): marcadas con destructiveHint=true; Claude pedirá confirmación antes de ejecutarlas
  • Herramientas externas (send_*_invitation): marcadas con openWorldHint=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.

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
}