Servidor MCP de Qlik Sense

Servidor del Protocolo de Contexto de Modelo (MCP) para Qlik Sense Enterprise. Expone las API de Repositorio (HTTP) y Motor (WebSocket) de Qlik como 24 herramientas MCP para que un cliente LLM pueda descubrir aplicaciones, inspeccionar modelos de datos, crear hipercubos y gestionar tareas de recarga a través de una interfaz única y uniforme.

¿Qué incluye?

Lista completa con descripciones: docs/tools.md.

Related MCP server: Opik MCP Server

Inicio rápido

uvx qlik-sense-mcp-server

El servidor se inicia en modo HTTP transmitible en http://127.0.0.1:8000/mcp. Configúrelo mediante variables de entorno — consulte docs/configuration.md.

Para el modo stdio (transporte MCP heredado), pase --stdio.

Documentación

Datos clave sobre la línea v1.4.0

• Conexiones WebSocket del motor en caché. Una vez que se abre una aplicación, cada llamada de herramienta posterior contra el mismo app_id reutiliza el mismo WebSocket y el mismo documento abierto. Cambiar de app_id cierra el documento antiguo y abre el nuevo en el mismo socket. Las conexiones caídas se vuelven a abrir de forma transparente. Implementación: engine_api.py y docs/architecture.md.

• Transporte HTTP transmitible por defecto. El servidor es un proceso de larga duración; varios clientes MCP pueden comunicarse con él en paralelo. El modo stdio heredado sigue funcionando detrás de --stdio.

• tool_call_seconds se inyecta como la primera clave de cada respuesta de herramienta — tiempo de reloj de pared de la llamada en milisegundos. Úselo para detectar herramientas lentas.

• Límites estrictos de hipercubos. engine_create_hypercube rechaza solicitudes con max_rows > 5000 o columns * max_rows > 9900 inmediatamente, con un error estructurado y una sugerencia que apunta a patrones de set-analysis o top-N. El propio motor de Qlik devuelve el error 7009 calc-pages-too-large para cualquier página individual de más de 10000 celdas.

• Control de tiempo de espera único. QLIK_WS_TIMEOUT (por defecto 180.0 segundos) controla tanto el saludo (handshake) de WebSocket como cada llamada a la API del motor.

Requisitos

• Python 3.12 (el paquete se compila y prueba con esta versión; consulte pyproject.toml)

• Qlik Sense Enterprise (Repositorio en el puerto 4242, Motor en el puerto 4747 — los puertos estándar)

• Certificado de cliente, clave privada y CA raíz del nodo de Qlik Sense

• Acceso de red desde el host que ejecuta este servidor a Qlik

Aviso legal

Este proyecto es una integración independiente creada por la comunidad. NO está afilado, respaldado, patrocinado ni apoyado por Qlik Technologies Inc., QlikTech International AB, ni ninguna otra entidad de Qlik. "Qlik", "Qlik Sense", "QlikView" y todos los nombres de productos relacionados son marcas comerciales de sus respectivos propietarios.

Toda la información sobre las API de Qlik Sense, asignaciones de puertos, códigos de error, comportamiento del protocolo y patrones de uso utilizados en este proyecto se obtuvo exclusivamente de fuentes disponibles públicamente: el Portal de Desarrolladores de Qlik (help.qlik.com, qlik.dev), los foros de la Comunidad Qlik y otra documentación pública. No se utiliza material propietario, confidencial o de ingeniería inversa.

Licencia

MIT © 2025-2026 Stanislav Chernov