Qlik Cloud

Interactúa con aplicaciones de Qlik Cloud y extrae datos de visualizaciones usando la API de Qlik Cloud.

GitHub
11
Prueba este MCPPatrocinado

Documentación

MseeP.ai Security Assessment Badge

Qlik MCP Server

Servidor MCP para la API de Qlik Cloud, que permite a Claude interactuar con aplicaciones de Qlik y extraer datos de visualizaciones.

Herramientas

qlik_get_apps

Lista todas las aplicaciones de Qlik disponibles en el espacio de trabajo

  • Entradas opcionales:
    • limit (number, default: 100): Número máximo de aplicaciones a devolver
    • offset (string): Desplazamiento de paginación para la siguiente página
  • Devuelve: Lista de aplicaciones con sus IDs e información

qlik_get_app_sheets

Obtiene todas las hojas de una aplicación de Qlik

  • Entradas opcionales:
    • app_id (string): El ID de la aplicación de Qlik (por defecto, la variable de entorno QLIK_APP_ID)
  • Devuelve: Lista de hojas con sus IDs, títulos y metadatos

qlik_get_sheet_charts

Obtiene todos los gráficos de una hoja específica

  • Entradas requeridas:
    • sheet_id (string): El ID de la hoja de la que se obtienen los gráficos
  • Entradas opcionales:
    • app_id (string): El ID de la aplicación de Qlik (por defecto, la variable de entorno QLIK_APP_ID)
  • Devuelve: Lista de gráficos con sus IDs, tipos y posiciones

qlik_get_chart_data

Obtiene datos de un gráfico específico

  • Entradas requeridas:
    • sheet_id (string): El ID de la hoja que contiene el gráfico
    • chart_id (string): El ID del gráfico del que se obtienen los datos
  • Entradas opcionales:
    • app_id (string): El ID de la aplicación de Qlik (por defecto, la variable de entorno QLIK_APP_ID)
    • max_rows (number, default: 10000): Número máximo total de filas a recuperar
    • page_size (number, default: 1000): Número de filas por solicitud
    • include_metadata (boolean, default: true): Incluir metadatos del gráfico en la respuesta
  • Devuelve: Datos del gráfico con encabezados, filas y metadatos opcionales

Configuración

Crear una clave de API de Qlik Cloud:

  1. Inicia sesión en tu tenant de Qlik Cloud
  2. Ve a Configuración > Claves de API
  3. Crea una nueva clave de API con el acceso adecuado
  4. Guarda la clave de API de forma segura

Configurar el entorno:

Crea un archivo .env con tus credenciales de Qlik Cloud (consulta .env.example para una plantilla):

QLIK_API_KEY=your_api_key_here
QLIK_BASE_URL=your_tenant_url
QLIK_APP_ID=your_default_app_id
MAX_ROWS_PER_REQUEST=1000
MAX_TOTAL_ROWS=10000
REQUEST_DELAY_MS=100
MAX_RETRIES=3
RETRY_DELAY_MS=1000

Uso con Docker

También puedes ejecutar este servidor MCP usando Docker:

# Build the Docker image
docker build -t qlik-mcp .

# Run the container
# Make sure to create a .env file first (copy from .env.example)
docker run --env-file .env qlik-mcp

Uso con Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json:

Usando Deno (Recomendado)

{
  "mcpServers": {
    "qlik": {
      "command": "/path/to/deno",
      "args": ["run", "--allow-all", "--env-file=.env", "src/index.ts"],
      "cwd": "/path/to/qlik-mcp"
    }
  }
}

Usando Node.js

{
  "mcpServers": {
    "qlik": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "env": {
        "QLIK_API_KEY": "your_api_key_here",
        "QLIK_BASE_URL": "your_tenant_url",
        "QLIK_APP_ID": "your_default_app_id"
      },
      "cwd": "/path/to/qlik-mcp"
    }
  }
}

Uso con Cursor

  1. Abre la configuración de Cursor
  2. Ve a la sección de configuración de Claude
  3. Añade una nueva configuración de MCP:
{
  "name": "Qlik Cloud",
  "command": "/path/to/deno",
  "args": ["run", "--allow-all", "--env-file=.env", "src/index.ts"],
  "cwd": "/path/to/qlik-mcp"
}

Reemplaza /path/to/deno con la ruta de instalación de Deno (generalmente ~/.deno/bin/deno en sistemas Unix) y /path/to/qlik-mcp con la ruta absoluta a tu repositorio clonado.

Solución de problemas

Si encuentras errores, verifica que:

  • Tu clave de API tenga los permisos necesarios
  • La URL del tenant sea correcta y accesible
  • El ID de la aplicación exista y sea accesible
  • Las variables de entorno estén configuradas correctamente
  • Los ajustes de límite de velocidad sean apropiados para tu tenant

Problemas comunes:

  • 401 Unauthorized: Revisa tu clave de API
  • 403 Forbidden: Verifica los permisos de la clave de API
  • 429 Too Many Requests: Ajusta los ajustes de límite de velocidad
  • 404 Not Found: Verifica los IDs de la aplicación y de las hojas

Desarrollo

Requisitos previos

Configuración local

# Clone repository
git clone https://github.com/jwaxman19/qlik-mcp.git
cd qlik-mcp

# Install dependencies (for IDE support)
npm install

# Run server
deno task dev

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.

📊 Plataformas de datos

Plataformas de datos para integración de datos, transformación y orquestación de pipelines.

  • JordiNei/mcp-databricks-server - Conéctate a la API de Databricks, permitiendo a los LLMs ejecutar consultas SQL, listar trabajos y obtener el estado de los trabajos.
  • jwaxman19/qlik-mcp 📇 ☁️ - Servidor MCP para la API de Qlik Cloud que permite consultar aplicaciones, hojas y extraer datos de visualizaciones con soporte integral de autenticación y límite de velocidad.
  • keboola/keboola-mcp-server - interactúa con la Plataforma de Datos de Keboola Connection. Este servidor proporciona herramientas para listar y acceder a datos de la API de Keboola Storage.