Katalon True Platform MCP

从这里开始 · 快速入门 · 技能 · 生命周期 · 安装 · 连接 MCP · 贡献

让你的编码 Agent 阅读需求、设计测试用例、使用 AI 运行测试、上传报告，并告知你是否可以安全发布。技能通过 Katalon MCP 执行平台操作，因此 Agent 能够操作你的真实项目，而不是凭空猜测。

_{会话示例。你的需求键、测试套件和结论均来自你自己的工作区。}

快速入门

1. 安装技能。 skills CLI 会检测你当前使用的 Agent（支持 70 多种），并将技能放入其原生目录。

npx skills add katalon-labs/true-skills

2. 指向你的 Katalon 工作区。 将 MCP 服务添加到 Agent 的配置文件中（安装部分会说明你需要使用哪个文件）：

{
  "mcpServers": {
    "katalon-prod-mcp": {
      "type": "http",
      "url": "https://platform.katalon.io/mcp"
    }
  }
}

首次连接时会打开浏览器 OAuth 流程，让你选择工作区。无需填写任何内容、粘贴令牌或保存密钥。

3. 提出实际需求。

Set up Katalon MCP and verify my projects.
Create manual tests from requirement CEL-6 and link them.
Which requirements in this sprint have no test coverage?
Run that suite with AI and summarize what broke.
Generate a Playwright script from test case TC-1042.
Upload my Playwright report to Katalon and verify the run.
Is release 3.2 safe to ship?

也可以直接交办整个流程：“分析 CEL-6，设计并导入用例，创建测试套件，使用 AI 运行测试，并告诉我是否可以发布。”

从你当前的角色开始

四种工作场景。用自己的话描述情况，Agent 就会选择相应的技能。

还没有连接？从 platform-setup 开始，每个人都只需运行一次。

不确定自己属于哪种角色，或者请求涉及多个角色？询问 true-platform-testing，它会根据角色和阶段进行引导。从意图到技能的完整映射，以及尚未实现部分的备用方案，请参阅 lifecycle-map.md。

技能

共有 19 项技能，每项技能在 skills/ 下各有一个文件夹。Agent 会根据技能描述选择合适的技能，因此你通常不需要自己指定技能。

生命周期

七个阶段，每个阶段由一个技能负责。维护阶段会将差距清单反馈到计划中，从而形成闭环。

platform-setup 位于全部七个阶段之前，用于连接 MCP。每个技能都会说明所用的 Katalon MCP 工具，以及平台能力的边界。完整阶段图：lifecycle-map.md。每个工具各占一行：mcp-tool-index.md。面向人类读者的独立可视化页面：docs/lifecycle.html。

边界说明

每个技能都会事先说明自身限制，避免 Agent 承诺平台无法完成的工作。

**通过 MCP：**列出项目和代码仓库、读取需求、创建和更新测试用例并建立关联、管理测试套件和文件夹、创建手动运行、启动 Run with AI、轮询 AI 会话、读取结果、获取质量指标，以及提交关联 ALM 的缺陷。

**无法通过 MCP：**创建需求、创建正式的 Test Plan 实体、保证 AI 运行完成，或在没有浏览器工具的情况下检查运行中的应用 UI。使用命名的测试套件并关联版本或迭代，作为 Test Plan 实体的替代方案。

有些工作属于产品界面功能，而非 API 调用：在 Studio 中进行对象捕获和弹性设计，在 TestOps UI 中配置自定义字段、Git 配置和治理，执行自愈、Time Capsule 和 TrueTest 重新生成，以及重新运行、终止和 Live Monitor。完整列表见 unavailable-capabilities.md。

安装

所有安装方式都需要配置 Katalon MCP。

npx skills add katalon-labs/true-skills                          # all skills, this project
npx skills add katalon-labs/true-skills --skill platform-setup   # just one
npx skills add katalon-labs/true-skills -g                       # user-global, every agent
npx skills update                                                # pull the latest

claude plugin marketplace add katalon-labs/true-skills
claude plugin install katalon-true-platform@katalon-true-platform-marketplace

claude --plugin-dir plugins/katalon-true-platform

codex plugin marketplace add katalon-labs/true-skills

mkdir -p .github .vscode \
  && cp -R <checkout>/.github/skills .github/ \
  && cp -R <checkout>/.github/prompts .github/ \
  && cp <checkout>/.github/copilot-instructions.md .github/ \
  && cp <checkout>/.github/mcp.json .github/ \
  && cp <checkout>/.vscode/mcp.json .vscode/

cp -R <checkout>/.cursor .cursor

cp -R <checkout>/.kiro .kiro

# local/developer install: point Kiro Crew at the app directory
apps/katalon-testing-skills/

cp -R <checkout>/.windsurf .windsurf

cp -R <checkout>/.clinerules .clinerules

cp -R <checkout>/.continue .continue

连接 Katalon MCP

所有工作区共用一个端点：https://platform.katalon.io/mcp。登录时会显示工作区选择器，因此无需查找子域名。标准配置格式见 .mcp.json：

{
  "mcpServers": {
    "katalon-prod-mcp": {
      "type": "http",
      "url": "https://platform.katalon.io/mcp"
    }
  }
}

不支持原生远程 MCP 的 Agent（Kiro、Continue、Codex）需使用 mcp-remote 包装器连接同一端点：

npx -y mcp-remote https://platform.katalon.io/mcp --transport http-first

1. 完成首次连接时打开的浏览器 OAuth 流程。
2. 选择工作区。
3. 如果未显示工具，请重新加载 Agent。

如果使用专属 Katalon 域名，请将 https://<your-sub-domain>.katalon.io/mcp 替换为相应地址。

**仅支持通过浏览器 OAuth 进行身份验证。**切勿在聊天中粘贴密码、API 令牌、Cookie、JWT、多重身份验证代码或 OAuth 回调 URL，也切勿将其提交到代码库。这些技能会强制执行此要求。

构建方式

技能正文只保存一份。每个 Agent 所需的内容都由此生成，因此任何适配器都不会与之脱节。

  skills/                      13 SKILL.md files plus references/
     |
     |  node scripts/build-adapters.mjs      deterministic, checked in CI
     v
  Claude Code · Codex · Copilot · Cursor · Kiro · Windsurf · Cline · Continue · AGENTS.md
     |
     |  every adapter points at the same server
     v
  Katalon MCP  ->  requirements, test cases, suites, Run with AI, results, defects

skills/                              source of truth, 19 skills
scripts/build-adapters.mjs           generates every agent config
plugins/katalon-true-platform/       Claude Code and Codex plugin      (generated)
.claude-plugin/  .agents/            plugin marketplaces               (generated)
.cursor/  .kiro/  .github/           Cursor, Kiro, Copilot             (generated)
.windsurf/  .clinerules/  .continue/ Windsurf, Cline, Continue         (generated)
apps/katalon-testing-skills/         Kiro Crew app                     (generated)
.mcp.json  .vscode/mcp.json          MCP config                        (generated)
AGENTS.md  llms.txt                  agent-readable index              (generated)

贡献

仅编辑 skills/。其他所有内容均为生成文件。然后：

node scripts/validate-skills.mjs    # skills/ matches scripts/skills.config.mjs
node scripts/build-adapters.mjs     # regenerate every agent config

构建过程具有确定性。没有技能变更时重新运行，不会产生差异；CI 会拒绝不同步的适配器。详情请参阅 CONTRIBUTING.md。

ChatGPT 插件包在 chatgpt/ 下有自己的源文件（ChatGPT 的 plugin.json、每项技能对应的 agents/openai.yaml 覆盖配置、卡片工具映射和列表资源），并有自己的构建流程，该流程会将允许列表中的副本暂存到 dist/chatgpt/，并拒绝任何会被 OpenAI 插件目录拒绝的内容：

python3 scripts/build-chatgpt-plugin.py      # dist/chatgpt/katalon-true-platform/ and the ZIP
python3 -m unittest discover -s tests        # one bad fixture per forbidden item

列表文案、审核案例和提交清单位于 docs/chatgpt/。

支持

• 错误报告、问题和技能请求：提交问题
• Katalon 平台和 MCP 支持：support.katalon.com，或联系您的 Katalon 客户成功经理
• MCP 服务文档：docs.katalon.com

隐私

这些技能是纯 Markdown，在您已使用的 Agent 中运行。本仓库不会收集任何信息。平台操作通过 OAuth 连接到您自己的 Katalon 工作区；Katalon 如何处理这些数据，请参阅 Katalon Privacy Policy。

许可证

MIT © Katalon。“Katalon”和“Katalon True Platform”是 Katalon, Inc. 的商标。