Qlik Cloud

Interaja com aplicativos do Qlik Cloud e extraia dados de visualizações usando a API do Qlik Cloud.

Documentação

Servidor MCP Qlik

Servidor MCP para a API Qlik Cloud, permitindo que o Claude interaja com aplicativos Qlik e extraia dados de visualizações.

Ferramentas

qlik_get_apps

Lista todos os aplicativos Qlik disponíveis no workspace

Entradas opcionais:
- limit (número, padrão: 100): Número máximo de aplicativos a retornar
- offset (string): Deslocamento de paginação para a próxima página
Retorna: Lista de aplicativos com seus IDs e informações

qlik_get_app_sheets

Obtém todas as planilhas em um aplicativo Qlik

Entradas opcionais:
- app_id (string): O ID do aplicativo Qlik (padrão: variável de ambiente QLIK_APP_ID)
Retorna: Lista de planilhas com seus IDs, títulos e metadados

qlik_get_sheet_charts

Obtém todos os gráficos em uma planilha específica

Entradas obrigatórias:
- sheet_id (string): O ID da planilha da qual obter os gráficos
Entradas opcionais:
- app_id (string): O ID do aplicativo Qlik (padrão: variável de ambiente QLIK_APP_ID)
Retorna: Lista de gráficos com seus IDs, tipos e posições

qlik_get_chart_data

Obtém dados de um gráfico específico

Entradas obrigatórias:
- sheet_id (string): O ID da planilha que contém o gráfico
- chart_id (string): O ID do gráfico do qual obter os dados
Entradas opcionais:
- app_id (string): O ID do aplicativo Qlik (padrão: variável de ambiente QLIK_APP_ID)
- max_rows (número, padrão: 10000): Número máximo total de linhas a recuperar
- page_size (número, padrão: 1000): Número de linhas por solicitação
- include_metadata (booleano, padrão: true): Incluir metadados do gráfico na resposta
Retorna: Dados do gráfico com cabeçalhos, linhas e metadados opcionais

Configuração

Criar uma chave de API Qlik Cloud:

Faça login no seu tenant Qlik Cloud
Navegue até Configurações > Chaves de API
Crie uma nova chave de API com acesso apropriado
Salve a chave de API com segurança

Configurar o ambiente:

Crie um arquivo .env com suas credenciais Qlik Cloud (veja .env.example para um modelo):

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 com Docker

Você também pode executar 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 com Claude Desktop

Adicione o seguinte ao seu 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 com Cursor

Abra as configurações do Cursor
Navegue até a seção de configuração do Claude
Adicione uma nova configuração MCP:

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

Substitua /path/to/deno pelo caminho de instalação do seu Deno (geralmente ~/.deno/bin/deno em sistemas Unix) e /path/to/qlik-mcp pelo caminho absoluto do seu repositório clonado.

Solução de problemas

Se você encontrar erros, verifique se:

Sua chave de API tem as permissões necessárias
A URL do tenant está correta e acessível
O ID do aplicativo existe e está acessível
As variáveis de ambiente estão configuradas corretamente
As configurações de limite de taxa são apropriadas para o seu tenant

Problemas comuns:

401 Unauthorized: Verifique sua chave de API
403 Forbidden: Verifique as permissões da chave de API
429 Too Many Requests: Ajuste as configurações de limite de taxa
404 Not Found: Verifique os IDs do aplicativo e da planilha

Desenvolvimento

Pré-requisitos

Deno
Node.js (opcional, para suporte a IDE)

Configuração 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

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.

📊 Plataformas de Dados

Plataformas de Dados para integração de dados, transformação e orquestração de pipelines.

JordiNei/mcp-databricks-server - Conecte-se à API Databricks, permitindo que LLMs executem consultas SQL, listem jobs e obtenham status de jobs.
jwaxman19/qlik-mcp 📇 ☁️ - Servidor MCP para a API Qlik Cloud que permite consultar aplicativos, planilhas e extrair dados de visualizações com suporte abrangente a autenticação e limite de taxa.
keboola/keboola-mcp-server - Interaja com a Plataforma de Dados Keboola Connection. Este servidor fornece ferramentas para listar e acessar dados da API de Armazenamento Keboola.