Qlane 智能体插件

Installs Qlane MCP into your AI 编程编辑器，使你的智能体无需离开编辑器即可访问你的 Qlane 项目、测试目标和测试用例计数。

哪个区域？

Qlane 运行两个独立的区域堆栈。该插件为每个区域注册一台服务器，你连接托管你组织的那台：

对该服务器进行身份验证，另一台保持不动。未连接的服务器不会提供任何自己的工具——你的编辑器会显示它带有两个登录助手，没有其他内容——因此它不会消耗任何资源，也不是错误状态。如果你连接了错误的服务器，每次调用都会返回一个 403，指明正确的主机——不会丢失任何内容，解决方法是连接另一台服务器。

两者都是简单的静态 URL，因此在每个编辑器上的工作方式完全相同。无需配置、替换或输入。

Related MCP server: Gaffer MCP Server

安装

Qlane MCP 需要 Qlane 账户。你的编辑器在首次调用服务器时会提示你登录。

Claude Code

claude plugin marketplace add qlaneai/agent-plugin
claude plugin install qlane@qlane-plugin

然后运行 /mcp 并对 qlane-eu 或 qlane-us 进行身份验证——选择托管你组织的那一个。无需配置步骤，也无需输入任何内容。

VS Code 和 GitHub Copilot

将此仓库添加到 chat.plugins.marketplaces：

{
  "chat.plugins.marketplaces": ["qlaneai/agent-plugin"]
}

如果添加后没有任何显示，请检查 chat.plugins.enabled 是否为 true。

Cursor

Cursor 读取根目录下的 plugin.json 并直接加载此插件，无需修改。将仓库添加为市场，安装 qlane，然后验证你所在区域的服务器。

Kiro

与 Cursor 相同——添加仓库，安装，验证你所在区域的服务器。

Codex

Codex 将此分为两个部分：你在 CLI 中注册市场，但在 ChatGPT 桌面应用中安装。没有 CLI 安装命令。

codex plugin marketplace add qlaneai/agent-plugin

然后在 ChatGPT 桌面应用中打开插件目录，从中安装 qlane。Codex 会在首次调用服务器时提示你登录。

在 Claude Code 中打开此仓库

你会看到 qlane-eu 和 qlane-us 被列为待批准。这是预期的且无害的：Claude Code 将仓库根目录下的 .mcp.json 读取为项目范围的 MCP 配置，因此此仓库的 .mcp.json（插件自身的清单）被当作你的配置来读取。请拒绝它，然后使用上述命令安装插件。

不使用插件

任何 MCP 客户端都可以直接指向端点。对于 Claude Code：

claude mcp add --transport http --scope user qlane https://mcp-eu.qlane.ai/api/mcp

如果你的组织托管在美国，请将主机替换为 mcp-us.qlane.ai。

它能做什么

读取你的项目、测试目标和测试用例计数，并在拉取请求创建之前为本地差异规划测试。规划测试会消耗 Qlane 积分。

开发

npm ci
npm run check

check 运行 Prettier、markdownlint、可移植清单的 JSON Schema 验证以及单元测试。它不进行网络调用，因此可以离线运行，也可以在沙盒化 CI 运行器中运行。

npm run format      # apply Prettier
npm run lint:md:fix # apply markdownlint's safe fixes

两个检查需要 Claude Code CLI，因此不属于 check，后者必须在没有该 CLI 的运行器上运行：

claude plugin validate --strict .   # manifest shapes; --strict makes warnings fatal
claude plugin tag --dry-run         # what the next release tag would be

版本仅存在于 plugin.json 中。市场条目故意不声明自身的 version：plugin.json 在安装时胜出，因此额外的副本要么一致，要么会被静默忽略。

任何清单不得包含占位符。 两个区域 URL 在每个清单中都是字面字符串。${user_config.*} 仅在 Claude Code CLI 中解析——可移植 Agent Plugins 模式甚至无法表达 userConfig（additionalProperties: false），而 claude.ai 将 MCP url 视为不透明的连接标识符，因此模板化的主机将逐字注册并无法解析。测试强制执行此规则。

许可证

MIT。