适用于克劳德桌面的Qlik Cloud MCP应用程序

一个功能齐全的模型上下文协议（MCP）服务器，将Claude Desktop连接到Qlik Cloud，提供丰富的交互式UI组件，用于管理应用程序、空间、用户、自动化、警报、人工智能助手等。

特性

59个具有丰富UI的MCP工具

类别	工具	描述
搜索与发现	`search`	使用过滤器搜索Qlik Cloud中的所有项目
应用	`app_details`, `app_context`, `generate_app`	查看应用程序详细信息，获取完整上下文，生成应用程序
空间	`spaces`, `space_details`	列出并探索空间及其内容
用户	`users`, `user`	列出并查看用户信息
租户	`tenant`, `health`, `license`	租户信息、系统健康状况、许可证详细信息
给重新装入	`reload`, `reload_status`, `reload_cancel`, `reload_info`	触发、监控、取消重新加载
自动化	`automations`, `automation`, `automation_run`, `automation_runs`	管理和运行自动化
警报	`alerts`, `alert`, `alert_trigger`, `alert_delete`	管理数据警报
Qlik答案	`assistants`, `assistant`, `ask_assistant`	用于问答的人工智能助手
洞察顾问	`insight`	带有真实数据的自然语言图表
自动ML	`experiments`, `experiment`, `deployments`, `deployment`	机器学习实验和部署
数据	`lineage`, `dataset`, `dataset_profile`	数据沿袭、数据集详细信息、分析
选集	`select`, `clear_selections`, `selections`, `fields`, `field_values`	通过引擎API进行交互式应用程序选择
表格	`list_sheets`, `sheet_details`	列出应用程序工作表和查看对象
主项目	`master_dimensions`, `master_measures`	探索主维度和度量
书签	`bookmarks`, `apply_bookmark`	列出并应用书签
变量	`variables`, `set_variable`	列出并修改应用程序变量
故事	`stories`	列出数据故事
脚本	`app_script`	使用语法高亮显示查看应用程序加载脚本
连接	`app_connections`, `data_connections`, `data_connection_details`	应用程序和租户级数据连接
术语表	`glossaries`, `glossary_details`, `glossary_term`, `create_glossary_term`, `delete_glossary_term`	业务术语管理
数据产品	`data_products`, `data_product_details`	数据产品目录

UI组件

MCP应用程序在Claude Desktop中呈现美观的交互式UI组件：

统一设计系统：一致 results-panel 在所有视图中使用绿色重音标题的样式
网格视图：应用程序、空间、用户、自动化、警报、助手、表格、术语表、数据产品、与搜索过滤器的连接、排序和分页
详细视图：应用程序、工作表、书签、变量、故事、实验、部署的丰富信息面板
图表：实时Insight Advisor图表（条形图、折线图、饼图、散点图、极坐标图、雷达图、甜甜圈图、面积图）
数据表：带尺寸和度量的多列表
时间线：重新加载历史记录，使用状态指示器自动运行
谱系视图:

- 具有表、行、字段统计信息的应用程序数据模型 - 带有节点和边的基于图形的上游/下游谱系

脚本编辑器:

- 脚本部分的垂直选项卡导航 - 完整的Qlik语法高亮显示（关键字、函数、变量、字符串、注释） - 隐藏 ///$tab 保留行号的标记

数据集分析：带有类型徽章、不同值、标签的字段统计
主项目：带表达式的尺寸和度量
交互式元素：操作按钮、3点菜单、书签应用、变量编辑
主题支持：通过MCP SDK自动设置暗/亮主题

智能图表类型检测

询问自然语言中的特定图表类型：

"Show revenue by region as a polar chart"
"Display sales by category in a pie chart"
"Revenue vs profit by customer as a scatter plot"
"Product details as a table"

支持的图表类型：条形图、折线图、饼图、圆环图、极坐标图、雷达图、散点图、面积图、树状图、表格

发动机API集成

通过WebSocket（Enigma.js）全面支持Qlik引擎API：

选集：通过自动元素编号解析按字段名称选择值
字段值：浏览任何字段中的所有值
书签：应用书签以恢复选择状态
变量：读取并更新应用程序变量
脚本：带制表符解析的满载脚本
表格：列出图纸及其对象
主项目：带公式的尺寸和度量

静默模式和上下文收集

对于报告生成等复杂任务，Claude需要收集应用程序元数据，而不会在UI中充斥面板。有两个功能可以解决这个问题：

1.静音模式参数

元数据工具支持 silent=true 返回数据而不显示UI：

fields(appId, silent=true)           # Data model - no UI
list_sheets(appId, silent=true)      # Sheets - no UI
master_dimensions(appId, silent=true) # Dimensions - no UI
master_measures(appId, silent=true)   # Measures - no UI
bookmarks(appId, silent=true)         # Bookmarks - no UI
variables(appId, silent=true)         # Variables - no UI

2.app_context工具

在一次调用中获取所有应用元数据（无UI）：

app_context(appId) → Returns:
  - App info
  - Data model (tables & fields)
  - Sheets
  - Master dimensions
  - Master measures
  - Bookmarks
  - Variables

工作流程示例：

User: "Create an executive report for the Sales app"

# Without silent mode (bad UX):
Claude calls: fields → UI, sheets → UI, master_dims → UI, insight → UI
Result: 4 UI panels flooding the screen 😵

# With app_context (good UX):
Claude calls: app_context → no UI, insight → final UI
Result: 1 clean visualization 🎉

建筑

qlik-claude-mcp-app/
├── server.ts              # MCP Server - API client & tool definitions
├── main.ts                # Entry point - stdio transport
├── mcp-app.html           # HTML template for UI
├── src/
│   ├── mcp-app.tsx        # React UI components
│   ├── global.css         # Global styles with theme support
│   └── vite-env.d.ts      # TypeScript environment
├── dist/                  # Build output
│   ├── index.js           # Bundled entry point
│   ├── server.js          # Bundled server
│   └── mcp-app.html       # Single-file UI bundle (~1MB)
├── package.json
├── tsconfig.json
├── tsconfig.server.json
└── vite.config.ts

关键组件

server.ts-MCP服务器

应用程序的核心包含：

Qlik客户端类：完整的Qlik Cloud API客户端，具有以下方法：

- 搜索项目API（&M） - 应用程序API（详细信息、重新加载、缩略图） - 空间API（列表、详细信息、项目） - 用户API（列表、搜索、详细信息） - 重新加载API（触发器、状态、取消、历史记录） - 自动化API（列表、详细信息、运行、历史记录） - 警报API（列表、详细信息、触发、删除） - Qlik回答API（助手、线程、调用） - Insight Advisor API（建议、图表数据） - AutoML API（实验、部署） - 数据线API（带节点/边的图形） - 数据集API（详细信息，配置文件） - 术语表API（术语表、术语、类别） - 数据连接API（租户和应用程序级别） - 引擎API通过Enigma.js（选择、字段值、工作表、主项目、书签、变量、故事、脚本、应用程序生成）

工具注册：58个使用Zod模式进行输入验证的工具

自动分页：使用基于光标的分页获取所有结果

WebSocket集成：Enigma.js用于Qlik引擎通信

智能ID解析：自动将数据集项ID转换为QRI分辨率

mcp-app.tsx-React用户界面

使用MCP SDK v1.0.1的全面UI组件：

主题挂钩: useHostStyleVariables(), useHostFonts(), useDocumentTheme()
网格组件：应用程序网格、空间网格、用户网格、自动化网格、警报网格、助手网格、实验网格、部署网格、数据集网格、表格网格、术语表网格、数据产品网格、数据连接网格
详细组件：AppDetail、SpaceDetail、UserDetail、Automation Detail、AlertDetail、AssistantDetail、ExperimentDetail、Deployment Detail、DatasetDetail、SheetDetail、GlossaryDetail、GlossaryTermView、DataProductDetails、DataConnectionDetail
可视化：ChartView（8种图表类型）、LineageView（图形）、AppLineageView
应用程序内容：表格网格、主维度视图、主度量视图、书签视图、变量视图、故事视图、AppScriptView（带语法高亮显示）、AppConnectionsView、字段值视图、选择面板
交互式：重新加载时间线、自动化运行、项目菜单（3点上下文菜单）
共同：分页、状态徽章、错误卡、操作成功
40色调色板 用于丰富的饼图/甜甜圈图/极图/雷达图

global.css-样式

完整的造型系统，包括：

黑暗和光明主题支持
统一 results-panel 绿色设计
Qlik脚本语法高亮显示（关键字、函数、变量、字符串、注释、数据类型）
垂直脚本选项卡导航
网格视图和列表视图
图表样式
状态徽章和类型指示器
响应式设计
动画和过渡

安装

第一步：安装Node.js

macOS（带Homebrew）：

brew install node

macOS（不含Homebrew）：

# First install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node

窗户：

下载自https://nodejs.org（LTS版本，18+）
运行安装程序

验证：

node --version   # Should be v18 or higher

第二步：安装Bun

macOS/Linux：

curl -fsSL https://bun.sh/install | bash

Windows（PowerShell作为管理员）：

powershell -c "irm bun.sh/install.ps1 | iex"

重要提示： 安装后，将Bun添加到PATH中：

# Run these commands (or close and reopen terminal)
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

验证：

bun --version

步骤3：安装克劳德桌面

下载自https://claude.ai/download
安装并使用您的帐户登录

步骤4：创建Qlik Cloud API密钥

登录您的Qlik Cloud租户（例如。， https://your-tenant.eu.qlikcloud.com)
点击您的 配置文件图标 （右上）
选择设置
点击 API密钥 在左侧菜单中
点击 生成新密钥
立即复制密钥 （只显示一次！）

步骤5：克隆和构建

# Clone the repository
git clone https://github.com/undsoul/qlik-claude-mcp-app.git

# IMPORTANT: Enter the project directory
cd qlik-claude-mcp-app

# Install dependencies
npm install

# Build
npm run build

步骤6：配置Claude桌面

macOS： 打开或创建 ~/Library/Application Support/Claude/claude_desktop_config.json

# Create directory if needed
mkdir -p ~/Library/Application\ Support/Claude

# Edit config file
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

窗户： 打开 %APPDATA%\Claude\claude_desktop_config.json

添加此配置：

{
  "mcpServers": {
    "Qlik Mcp App": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/qlik-claude-mcp-app/dist/index.js", "--stdio"],
      "env": {
        "QLIK_TENANT_URL": "https://your-tenant.region.qlikcloud.com",
        "QLIK_API_KEY": "your-api-key-here"
      }
    }
  }
}

替换： - YOUR_USERNAME 使用您的实际用户名 - your-tenant.region 与您的Qlik Cloud租户（例如。， mycompany.eu) - your-api-key-here 使用步骤4中的API密钥

找到你的完整路径：

# macOS/Linux
pwd   # Run this inside the project folder

# Windows (PowerShell)
Get-Location

步骤7：重新启动克劳德桌面

完全退出并重新打开Claude Desktop。

第8步：测试

在Claude Desktop中，尝试：

Show me my Qlik Cloud apps

或

List spaces in Qlik

______________________________________________________________________

多平台支持

此MCP服务器可与Claude Desktop之外的多个AI助手配合使用。

VS代码/GitHub副本

该项目包括 .vscode/mcp.json 用于VS Code和GitHub Copilot集成。

在VS Code中打开项目
VS Code将自动检测MCP配置
系统将提示您输入Qlik Cloud凭据

手动设置：

// .vscode/mcp.json (already included)
{
  "servers": {
    "qlikCloud": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js", "--stdio"],
      "env": {
        "QLIK_TENANT_URL": "${input:qlikTenantUrl}",
        "QLIK_API_KEY": "${input:qlikApiKey}"
      }
    }
  }
}

ChatGPT桌面

ChatGPT桌面需要具有公共URL的HTTP传输。

步骤1:启动HTTP服务器

cd qlik-claude-mcp-app
export QLIK_TENANT_URL="https://your-tenant.region.qlikcloud.com"
export QLIK_API_KEY="your-api-key"
npm run serve
# Server runs at http://localhost:3001/mcp

步骤2：使用Cloudflare隧道进行公开

# Install cloudflared
brew install cloudflared   # macOS
# Or download from https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation

# Create tunnel (no account needed)
cloudflared tunnel --url http://localhost:3001
# Returns URL like: https://random-words.trycloudflare.com

步骤3：配置ChatGPT桌面

使用配置文件 chatgpt-mcp-config.json:

{
  "name": "Qlik Cloud",
  "description": "Connect to Qlik Cloud for analytics, apps, and insights",
  "url": "https://your-tunnel-url.trycloudflare.com/mcp",
  "transport": "http"
}

注：替换 your-tunnel-url 使用来自cloudflared的实际URL。

______________________________________________________________________

故障排除

错误	解决方案
`bun: command not found`	运行： `export BUN_INSTALL="$HOME/.bun"` 和 `export PATH="$BUN_INSTALL/bin:$PATH"`
`ENOENT: no such file or directory, package.json`	确保你跑了 `cd qlik-claude-mcp-app` 克隆后
`Unauthorized`	检查您的API密钥是否正确
`Connection refused`	确保QLIK_TENANT_URL以开头 `https://`
找不到MCP服务器	验证配置中的路径是否与您的实际安装位置匹配

使用示例

搜索应用程序

Search for apps containing "sales"

查看带有沿袭的应用程序详细信息

Show me details for the Sales Dashboard app including its data lineage

获取Insight Advisor图表

Show me revenue by region for the Sales app
Show revenue by category as a pie chart
Display profit vs revenue by customer as a scatter plot
Show sales data as a polar chart
Get product breakdown in table format

问Qlik答案

List the AI assistants and ask one about total revenue

检查重新加载状态

Show me recent reloads for the Sales app and trigger a new one

查看自动化

List all automations and show the run history for the data refresh automation

进行选择

Select "USA" in the Country field for the Sales app
Show me field values for Product Category in the Sales app
Clear all selections in the Sales app

查看应用程序脚本

Show me the load script for the Sales app

生成应用程序

Generate a Qlik Sense app for tracking sales performance with revenue, profit, and customer metrics

数据集分析

Show me the profile for dataset 697b4aac376930e8e2843ee9

发展

脚本

# Build everything
npm run build

# Development mode (UI hot reload)
npm run dev

# Type checking
npx tsc --noEmit

添加新工具

添加API方法 到 QlikClient 类在 server.ts:

async myNewEndpoint(param: string): Promise {
  return this.fetch(`/my-endpoint/${param}`);
}

注册工具 随着 registerAppTool():

registerAppTool(server, "my_tool", {
  title: "My Tool",
  description: "Description for Claude",
  inputSchema: {
    param: z.string().describe("Parameter description"),
  },
  _meta: { ui: { resourceUri } },
}, async (args): Promise => {
  const result = await qlik.myNewEndpoint(args.param);
  return {
    content: [{ type: "text", text: `Result: ${result.name}` }],
    structuredContent: { type: "my-view", ...result },
  };
});

添加UI组件 在 mcp-app.tsx:

function MyView({ data }: { data: any }) {
  return (
    

      

        Title
        Badge
      

      {/* Your content here */}
    

  );
}

添加路由 在 ContentRouter:

const views: Record = {
  // ... existing views
  "my-view": ,
};

添加样式 在 global.css 如有需要

工具类型

带UI的工具：使用 registerAppTool() -退货 structuredContent 用于渲染
没有UI的工具：使用 server.registerTool() -仅返回纯文本

环境变量

变量	描述	必填
`QLIK_TENANT_URL`	您的Qlik Cloud租户URL（例如。， `https://tenant.region.qlikcloud.com`)	是
`QLIK_API_KEY`	具有适当权限的API密钥	是

需要API权限

API密钥需要访问以下Qlik云API：

物品 -搜索并列出项目
应用 -读取应用程序详细信息，触发重新加载
空间 -阅读空间及其内容
用户 -读取用户信息
自动化 -读取并执行自动化
警报 -读取、触发和删除警报
Qlik答案 -访问助手、创建线程、调用
洞察顾问 -获取建议和图表数据
自动机器学习 -阅读实验和部署
数据血缘 -读取沿袭信息
数据集 -读取数据集详细信息和配置文件
发动机 -WebSocket访问选项、字段、书签、变量、脚本

技术栈

组件	技术
运行时	Node.js 18+
邦德勒	邦恩
MCP SDK	@modelcontextprotocol/SDK
MCP应用程序	@modelcontextprotocol/ext应用程序v1.0.1
UI框架	React 19
语言	TypeScript
图表	Chart.js+react-chartjs-2
图标	Lucide React
Qlik引擎	Enigma.js
构建工具	Vite
单个文件	vite插件单个文件

运作原理

服务器注册：MCP服务器注册带有元数据的工具，将它们链接到UI资源(ui://qlik/mcp-app.html)

工具调用：当Claude调用工具时，服务器从Qlik Cloud API获取数据

UI渲染：答复包括 structuredContent Claude Desktop使用注册的UI资源渲染

主题整合：UI使用MCP SDK挂钩自动适应Claude Desktop的主题

用户交互：UI可以使用以下命令回调服务器 callTool() 或提示克劳德 sendAction()

发动机集成：对于选择等高级功能，服务器通过Enigma.js打开与Qlik引擎的WebSocket连接，并自动解析元素编号

智能ID解析：沿袭工具自动将数据集项ID解析为其QRI标识符

许可证

麻省理工学院

作者

使用克劳德代码构建

Qlik Claude MCP App

快速接入

详细介绍