# qseow-mcp

qseow-mcp connects AI assistants to Qlik Sense Enterprise on Windows through QRS, Engine, and Proxy APIs. Helps inspect data models, troubleshoot KPI formulas, and monitor site tasks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 repo stars
- Author: rmterenzi
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rmterenzi/qseow-mcp
- Updated: 2026-08-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/qseow-mcp

## What it does

This server bridges AI agents with client-managed Qlik Sense Enterprise on Windows (QSEoW) via the Model Context Protocol. While Qlik Cloud provides a native MCP endpoint, on-prem setups lack built-in support. The project bridges this gap by exposing Engine (QIX), Repository (QRS), and Proxy endpoints as MCP tools. Agents can trace KPI definitions down to load scripts, query hypercubes, and verify field selections.

The toolkit groups functions into analyst, inspector, developer, and admin roles. Data query tools include expression validation warnings and current selection states with every result. This prevents a silent failure mode where a mistyped field name yields zero instead of raising an error.

Safety comes first: all mutating tools remain unregistered unless you set `QSEOW_ALLOW_MUTATIONS=true`. Connection requires PEM certificates exported from the Qlik Management Console or a JWT token. Because QIX hides scripts of published apps from regular identities, the server inspects copies generated through `copy_app`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `QSEOW_HOST`, `QSEOW_AUTH_MODE`, `QSEOW_CERT_PATH`, `QSEOW_CERT_KEY_PATH`, `QSEOW_ROOT_CERT_PATH`, `QSEOW_JWT`, `QSEOW_VP_PREFIX`, `QSEOW_ALLOW_MUTATIONS`, `QSEOW_TOOL_GROUPS`, `QSEOW_TLS_VERIFY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env QSEOW_HOST=<QSEOW_HOST> --env QSEOW_AUTH_MODE=<QSEOW_AUTH_MODE> --env QSEOW_CERT_PATH=<QSEOW_CERT_PATH> --env QSEOW_CERT_KEY_PATH=<QSEOW_CERT_KEY_PATH> --env QSEOW_ROOT_CERT_PATH=<QSEOW_ROOT_CERT_PATH> --transport stdio qseow-mcp -- npx -y qseow-mcp
```
Replace <…> with your own values. 5 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add qseow-mcp --env QSEOW_HOST=<QSEOW_HOST> --env QSEOW_AUTH_MODE=<QSEOW_AUTH_MODE> --env QSEOW_CERT_PATH=<QSEOW_CERT_PATH> --env QSEOW_CERT_KEY_PATH=<QSEOW_CERT_KEY_PATH> --env QSEOW_ROOT_CERT_PATH=<QSEOW_ROOT_CERT_PATH> -- npx -y qseow-mcp
```
Replace <…> with your own values. 5 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "qseow-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "qseow-mcp"
            ],
            "env": {
                "QSEOW_HOST": "<QSEOW_HOST>",
                "QSEOW_AUTH_MODE": "<QSEOW_AUTH_MODE>",
                "QSEOW_CERT_PATH": "<QSEOW_CERT_PATH>",
                "QSEOW_CERT_KEY_PATH": "<QSEOW_CERT_KEY_PATH>",
                "QSEOW_ROOT_CERT_PATH": "<QSEOW_ROOT_CERT_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values. 5 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "qseow-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "qseow-mcp"
            ],
            "env": {
                "QSEOW_HOST": "<QSEOW_HOST>",
                "QSEOW_AUTH_MODE": "<QSEOW_AUTH_MODE>",
                "QSEOW_CERT_PATH": "<QSEOW_CERT_PATH>",
                "QSEOW_CERT_KEY_PATH": "<QSEOW_CERT_KEY_PATH>",
                "QSEOW_ROOT_CERT_PATH": "<QSEOW_ROOT_CERT_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values. 5 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e QSEOW_HOST=<QSEOW_HOST> -e QSEOW_AUTH_MODE=<QSEOW_AUTH_MODE> -e QSEOW_CERT_PATH=<QSEOW_CERT_PATH> -e QSEOW_CERT_KEY_PATH=<QSEOW_CERT_KEY_PATH> -e QSEOW_ROOT_CERT_PATH=<QSEOW_ROOT_CERT_PATH> qseow-mcp npx -y qseow-mcp
```
Replace <…> with your own values. 5 more environment variables are in the server README

## When to use it
- diagnose metric discrepancies and expression errors across sheets
- inspect reload task failures directly from QRS execution logs
- audit security rules and track active proxy user sessions
- validate and generate visual sheets prior to rendering

## Example prompts
- Inspect the Sales app data model and evaluate the margin KPI formula.
- Check Qlik service statuses across nodes and get the log for the failed task.
- Duplicate the published executive app with copy_app and read its load script.

## Similar
- [windows-git-bash-paths](https://affpapa.org/en/nevibecode/skills/windows-git-bash-paths.md) — skill · 173 installs
- [MCP for Primavera P6](https://affpapa.org/en/nevibecode/mcp/mcp-for-primavera-p6.md) — MCP server · ★ 10 repo stars
- [msstore-cli](https://affpapa.org/en/nevibecode/skills/msstore-cli.md) — skill · 7000 installs
- [clr-activation-debugging](https://affpapa.org/en/nevibecode/skills/clr-activation-debugging.md) — skill · 4400 installs
- [windows-builder](https://affpapa.org/en/nevibecode/skills/windows-builder.md) — skill · 2900 installs
- [coinmarketcap-diamonds-premium-analytics](https://affpapa.org/en/nevibecode/skills/coinmarketcap-diamonds-premium-analytics.md) — skill · 953 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
