Qlane エージェントプラグイン

Qlane MCP を AI コーディングエディタにインストールすると、エージェントがエディタを離れることなく Qlane のプロジェクト、テストターゲット、テストケース数にアクセスできるようになります。

どのリージョン？

Qlane は 2 つの独立したリージョナルスタックを運用しています。プラグインは リージョンごとに 1 つのサーバー を登録し、あなたの組織がホストされている方に接続します。

該当する方を認証し、もう一方はそのままにしておきます。接続されていないサーバーは独自のツールを一切提供しません — エディタには 2 つのサインインヘルパーとそれ以外何も表示されないため、コストはかからず、エラー状態でもありません。間違った方に接続した場合、すべての呼び出しで正しいホスト名を示す 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 ではこれを 2 か所に分割します。マーケットプレイスは CLI で登録しますが、インストールは ChatGPT デスクトップアプリから行います。CLI のインストールコマンドはありません。

codex plugin marketplace add qlaneai/agent-plugin

次に、ChatGPT デスクトップアプリで プラグインディレクトリ を開き、そこから qlane をインストールします。Codex はサーバーを初めて呼び出す際にサインインを促します。

このリポジトリを Claude Code で開く

qlane-eu と qlane-us が Pending approval として表示されます。これは想定内で無害です。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

2 つのチェックは Claude Code CLI を必要とするため、check の一部ではありません。check はそれを備えていないランナーで実行する必要があります。

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 が優先されるため、2 番目のコピーは一致するか、静かに無視されるかのどちらかです。

どのマニフェストにもプレースホルダーを含めてはいけません。 両方のリージョナル URL はすべてのマニフェストでリテラル文字列です。${user_config.*} は Claude Code CLI でのみ解決されます — ポータブルな Agent Plugins スキーマは userConfig を表現することすらできず（additionalProperties: false）、claude.ai は MCP の url を不透明なコネクタ識別子として扱うため、テンプレート化されたホストはそのまま登録され、解決に失敗します。テストでこれを強制しています。

ライセンス

MIT。