Qase Test Management

Qase MCP 服务

适用于 Qase Test Management Platform 的官方 Model Context Protocol（MCP）服务——将 AI 助手连接到您的测试用例、测试运行、缺陷等内容。

目录

• 概述
• 使用场景
• 快速开始
  • 使用托管的 Qase MCP（推荐）
  • 自行运行
• 基于此服务进行开发
• 从 v1 升级
• 工具
• 文档
• 参与贡献
• 许可证
• 支持
• 链接

概述

Qase MCP 服务让 AI 助手（Claude、Cursor、Codex 以及任何其他 MCP 客户端）能够读取和写入 Qase 测试用例、测试运行、测试结果、缺陷、测试套件、里程碑等内容——通过标准化协议完成，无需编写自定义集成代码。

功能：

• 40 个面向任务的工具（共 42 个，包含 qase_discover_tools 和 qase_tool_help）——由 83 个 v1 工具整合而来，降低令牌用量并提升大模型准确率
• 组合式工具——通过一次调用完成多步工作流：CI 报告、缺陷分类、回归测试运行设置
• 支持 QQL——Qase 查询语言，可跨测试用例、测试运行、测试结果、缺陷和计划进行高级搜索
• 项目上下文初始化——一次调用即可返回完整项目结构（测试套件、里程碑、环境、用户、自定义字段）
• 测试用例评审——提出新用例或变更以供评审、分配评审者并跟踪状态（批准和合并仍只能通过 UI 完成）
• 简短描述，按需查阅文档——首次请求即可列出所有工具；Agent 首次使用某个工具时，qase_tool_help 会返回该工具的完整文档，qase_discover_tools 则可按任务搜索目录
• 托管或自行运行——只需使用 Qase 登录信息，即可连接到 https://mcp.qase.io/mcp（或欧盟集群上的 https://mcp-eu.qase.io/mcp）；也可使用自己的 API 令牌在本地运行服务
• 租户安全的缓存与 HTTP 弹性——两级缓存（内存 + 可选 Redis）、连接池、带退避机制的重试
• 备用通道——通过 qase_api 直接访问任意端点的 REST API

使用场景

场景	提示词示例	工具
初始化项目上下文	“显示 DEMO 项目的结构——测试套件、里程碑、环境”	qase_project_context
创建或更新测试用例	“在 DEMO 项目中创建一个高优先级的冒烟测试用例，标题为‘使用有效凭据登录’”	qase_case_upsert
报告 CI 结果	“报告 DEMO 项目的这些 CI 结果：用例 1 通过，用例 2 失败，错误为‘超时错误’”	qase_ci_report
分析失败的测试	“为测试运行 #42 中的登录超时故障创建一个严重缺陷”	qase_triage_defect
使用 QQL 搜索	“查找 DEMO 项目过去 7 天内所有失败的测试结果”	qql_search

请参阅工具和 docs/tools.md 获取完整参考。

快速开始

使用托管的 Qase MCP（推荐）

无需安装，也无需 API 令牌——连接到 Qase 托管服务，并使用你的 Qase 账号登录。

注意：托管的 Qase MCP 面向所有付费套餐开放。使用免费套餐或专用实例时，请自行运行服务，并使用你自己的 API 令牌——此方式适用于所有场景。

**选择适合你所在区域的 URL：**主云（app.qase.io）使用 https://mcp.qase.io/mcp，欧盟集群（app-eu.qase.io）使用 https://mcp-eu.qase.io/mcp。以下示例使用主云；在欧盟集群中，替换为欧盟 URL，其他内容保持不变。

• Claude — 打开设置 → 连接器，找到 Qase Test Management，点击连接。（目录中的连接器面向主云；在欧盟集群中，请将 https://mcp-eu.qase.io/mcp 添加为自定义连接器。）
• Cursor — 将 {"mcpServers": {"qase": {"url": "https://mcp.qase.io/mcp"}}} 添加到 .cursor/mcp.json。
• Codex — 在设置 → MCPs → 添加服务中添加 URL https://mcp.qase.io/mcp，或为 CLI 配置 ~/.codex/config.toml。
• VS Code — 将 {"servers": {"qase": {"type": "http", "url": "https://mcp.qase.io/mcp"}}} 添加到 .vscode/mcp.json，或运行 MCP: Add Server。

各客户端的完整步骤、其他客户端以及活动工作区模型：docs/connect.md。

自行运行

安装软件包并提供你自己的 API 令牌：

npm install -g @qase/mcp-server
export QASE_API_TOKEN=your_api_token_here

然后将 MCP 客户端的 stdio 配置指向 @qase/mcp-server 二进制文件。完整的安装选项、客户端配置（Claude Desktop、Cursor、Claude Code、Codex、OpenCode）、环境变量和传输方式（stdio/SSE/streamable-HTTP）：docs/self-run.md。

在此服务之上构建

仅面向集成开发者——如果你直接使用此服务，以下内容与你无关。

如果你的产品驱动此服务（例如插件、Agent、包装 CLI），可以标识自身，以便在 Qase 分析中将其使用情况归因到该产品，而不受所连接的 AI 宿主影响：

QASE_MCP_INTEGRATION=quality-supervisor/1.4.0   # <name>/<version>, version optional

名称必须在 src/utils/integration-marker.ts 的允许列表中——请通过 PR 添加你的名称。未列入列表或格式错误的内容会被忽略，API 调用仍会成功。HTTP 传输也支持在每个请求中提供标识（X-Qase-Integration 标头或 ?integration=）。详情见：docs/self-run.md。

升级

**从 2.x 升级到 3.0.0：**没有工具重命名，也没有参数变更，因此提示词和自动化仍可正常工作。变化在于底层协议——服务使用 MCP 2026-07-28 协议，不再使用会话，每个工具都会从第一个请求开始列出，删除操作需要往返两次。现在自托管多个副本需要设置 QASE_MCP_REQUEST_STATE_KEY。

从 v1 升级到 v2：v2 将 83 个 v1 工具整合为29 个面向任务的工具（总计 30 个，包含一个发现工具），此后已扩展至 40 个（总计 42 个）。工具名称和响应结构均已变更。

两种升级方式的说明，以及完整的 v1 → v2 工具映射表和前后示例：docs/migration.md。

工具

共有 42 个工具，分为 6 组（40 个面向任务的工具，另有两个元工具：qase_discover_tools 用于搜索目录，qase_tool_help 用于查看工具的完整文档）。首次请求时会列出所有工具：

分组	数量	描述
读取	2	按类型／ID 获取任意实体，或通过一次调用初始化完整项目上下文
QQL	2	使用 Qase Query Language 搜索用例、运行、结果、缺陷和计划
写入	32	创建、更新和删除用例（单次或最多 100 个）、运行、结果、缺陷、套件、里程碑、计划、共享步骤、环境和附件；将用例和运行关联到 Jira 问题；提出并管理测试用例评审
组合	3	通过一次调用执行多步骤工作流：CI 报告、缺陷分诊、回归运行设置
备用通道	1	直接访问 REST API，调用上述工具未涵盖的任意端点
元工具	2	qase_discover_tools — 根据你要执行的操作搜索目录；qase_tool_help — 按需查看某个工具的完整文档

包含参数的完整工具参考：docs/tools.md。

文档

• docs/connect.md — 连接到托管的 Qase MCP（Claude、Cursor、Codex 和其他客户端）
• docs/self-run.md — 自行安装并运行服务（配置、客户端、传输方式）
• docs/tools.md — 完整的工具参考、分组和发现模型
• docs/troubleshooting.md — 身份验证、OAuth／连接器和 SSL 问题
• docs/migration.md — 升级指南：2.x → 3.0.0，以及 v1 → v2 工具映射

参与贡献

欢迎贡献！有关开发环境设置、测试和代码检查指南，请参阅 CONTRIBUTING.md。

许可证

MIT 许可证 — 详情请参阅 LICENSE。

支持

• 文档：https://docs.qase.io/en/articles/14984302-qase-mcp-server
• 电子邮件：[email protected]
• GitHub 问题：https://github.com/qase-tms/qase-mcp-server/issues

链接

• Qase 平台：https://qase.io
• Qase 文档：https://help.qase.io
• API 文档：https://developers.qase.io
• MCP 协议：https://modelcontextprotocol.io
• 问题跟踪器：https://github.com/qase-tms/qase-mcp-server/issues