Plugin del agente Qlane

Instala Qlane MCP en tu editor de código con IA, para que tu agente pueda acceder a tus proyectos de Qlane, objetivos de prueba y conteos de casos de prueba sin salir del editor.

¿Qué región?

Qlane ejecuta dos stacks regionales independientes. El plugin registra un servidor para cada uno, y te conectas al que aloja tu organización:

Autentica ese y deja el otro en paz. Un servidor no conectado no aporta ninguna de sus propias herramientas — tu editor lo muestra con dos asistentes de inicio de sesión y nada más — por lo que no te cuesta nada y no es un estado de error. Si te conectas al equivocado, cada llamada devuelve un 403 indicando el host correcto — no se pierde nada, y la solución es conectar el otro servidor.

Ambos son URLs estáticas simples, por lo que funciona de manera idéntica en todos los editores. No se configura, reemplaza ni escribe nada.

Related MCP server: Gaffer MCP Server

Instalar

Qlane MCP requiere una cuenta de Qlane. Tu editor te pedirá que inicies sesión la primera vez que llame al servidor.

Claude Code

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

Luego ejecuta /mcp y autentica qlane-eu o qlane-us — el que aloje tu organización. No hay paso de configuración ni nada que escribir.

VS Code y GitHub Copilot

Añade este repositorio a chat.plugins.marketplaces:

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

Si no aparece nada después de agregarlo, verifica que chat.plugins.enabled esté en true.

Cursor

Cursor lee el plugin.json raíz y carga este plugin sin cambios. Añade el repositorio como un marketplace, instala qlane, luego autentica el servidor de tu región.

Kiro

Igual que Cursor — añade el repositorio, instala, autentica el servidor de tu región.

Codex

Codex divide esto en dos lugares: registras el marketplace en la CLI, pero lo instalas desde la aplicación de escritorio de ChatGPT. No hay comando de instalación en la CLI.

codex plugin marketplace add qlaneai/agent-plugin

Luego abre el Directorio de Plugins en la aplicación de escritorio de ChatGPT e instala qlane desde allí. Codex te pedirá que inicies sesión la primera vez que llame al servidor.

Abrir este repositorio en Claude Code

Verás qlane-eu y qlane-us listados como Pending approval. Eso es esperado e inofensivo: Claude Code lee un .mcp.json en la raíz de un repositorio como configuración MCP de alcance del proyecto, por lo que el .mcp.json de este repositorio — el propio manifiesto del plugin — se interpreta como si fuera tuyo. Recházalo e instala el plugin con los comandos anteriores.

Sin el plugin

Cualquier cliente MCP puede apuntar directamente al endpoint. Para Claude Code:

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

Cambia el host por mcp-us.qlane.ai si tu organización está alojada en EE. UU.

Qué puede hacer

Leer tus proyectos, objetivos de prueba y conteos de casos de prueba, y planificar pruebas para un diff local antes de que exista una pull request. Planificar una prueba consume créditos de Qlane.

Desarrollo

npm ci
npm run check

check ejecuta Prettier, markdownlint, validación de esquema JSON de los manifiestos portátiles y las pruebas unitarias. No realiza llamadas de red, por lo que funciona sin conexión y en un ejecutor de CI alslado.

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

Dos verificaciones necesitan la CLI de Claude Code y, por lo tanto, no forman parte de check, que debe ejecutarse en un ejecutor que no la tenga:

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

La versión solo reside en plugin.json. La entrada del marketplace deliberadamente no declara una version propia: plugin.json prevalece en el momento de la instalación, por lo que una segunda copia solo podría coincidir o ser ignorada silenciosamente.

Ningún manifiesto puede contener un marcador de posición. Ambas URLs regionales son cadenas literales en todos los manifiestos. ${user_config.*} solo se resuelve en la CLI de Claude Code — el esquema portátil de Agent Plugins ni siquiera puede expresar userConfig (additionalProperties: false), y claude.ai trata una url de MCP como una identidad de conector opaca, por lo que un host con plantilla llega al registro textualmente y no se resuelve. Una prueba aplica esto.

Licencia

MIT.