Qlane 에이전트 플러그인

AI 코딩 편집기에 Qlane MCP를 설치하여, 에이전트가 편집기를 떠나지 않고도 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로 바꾸세요.

할 수 있는 작업

프로젝트, 테스트 대상 및 테스트 케이스 수를 읽고, 풀 리퀘스트가 생성되기 전에 로컬 diff에 대한 테스트를 계획합니다. 테스트 계획에는 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에 포함되지 않습니다. 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.