Servidor Qlik MCP

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

Herramientas

qlik_get_apps

Enumere todas las aplicaciones Qlik disponibles en el espacio de trabajo

• Entradas opcionales:

  • limit (número, predeterminado: 100): número máximo de aplicaciones a devolver

  • offset (cadena): desplazamiento de paginación para la página siguiente

• Devoluciones: Listado de aplicaciones con sus IDs e información

qlik_get_app_sheets

Obtener todas las hojas en una aplicación Qlik

• Entradas opcionales:

  • app_id (cadena): el ID de la aplicación Qlik (el valor predeterminado es la variable de entorno QLIK_APP_ID)

• Devuelve: Lista de hojas con sus ID, títulos y metadatos

qlik_get_sheet_charts

Obtener todos los gráficos en una hoja específica

• Entradas requeridas:

  • sheet_id (cadena): El ID de la hoja de la que se obtendrán los gráficos

• Entradas opcionales:

  • app_id (cadena): el ID de la aplicación Qlik (el valor predeterminado es la variable de entorno QLIK_APP_ID)

• Devuelve: Lista de gráficos con sus ID, tipos y posiciones

qlik_obtener_datos_del_gráfico

Obtener datos de un gráfico específico

• Entradas requeridas:

  • sheet_id (cadena): El ID de la hoja que contiene el gráfico

  • chart_id (cadena): El ID del gráfico del que se obtendrán los datos

• Entradas opcionales:

  • app_id (cadena): el ID de la aplicación Qlik (el valor predeterminado es la variable de entorno QLIK_APP_ID)

  • max_rows (número, predeterminado: 10000): Total máximo de filas a recuperar

  • page_size (número, predeterminado: 1000): Número de filas por solicitud

  • include_metadata (booleano, valor predeterminado: verdadero): incluir metadatos del gráfico en la respuesta

• Devuelve: datos del gráfico con encabezados, filas y metadatos opcionales

Related MCP server: Metabase MCP

Configuración

Crear una clave API de Qlik Cloud:

1. Inicie sesión en su inquilino de Qlik Cloud

2. Vaya a Configuración > Claves API

3. Cree una nueva clave API con el acceso adecuado

4. Guarde la clave API de forma segura

Configurar entorno:

Cree un archivo .env con sus credenciales de Qlik Cloud (consulte .env.example para ver 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

Agregue lo siguiente a su claude_desktop_config.json :

Uso de 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. Abrir la configuración del cursor

2. Vaya a la sección de configuración de Claude

3. Agregar 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"
}

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

Solución de problemas

Si encuentra errores, verifique que:

• Su clave API tiene los permisos necesarios

• La URL del inquilino es correcta y accesible

• El ID de la aplicación existe y es accesible

• Las variables de entorno están configuradas correctamente

• Las configuraciones de limitación de velocidad son apropiadas para su inquilino

Problemas comunes:

• 401 Unauthorized : Verifique su clave API

• 403 Forbidden : Verificar permisos de clave API

• 429 Too Many Requests : Ajustar la configuración de limitación de velocidad

• 404 Not Found : verificar los ID de la aplicación y la hoja

Desarrollo

Prerrequisitos

• Deno

• Node.js (opcional, para compatibilidad con IDE)

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 cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.

📊 Plataformas de datos

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

• JordiNei/mcp-databricks-server - Conéctese a la API de Databricks, lo que permite a los LLM ejecutar consultas SQL, enumerar 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 autenticación integral y soporte de limitación de velocidad.

• keboola/keboola-mcp-server : interactúa con la plataforma de datos de conexión de Keboola. Este servidor proporciona herramientas para listar y acceder a los datos desde la API de almacenamiento de Keboola.