MCP para código, CI, granja de ejecutores y control de calidad
El CHAMPREP Servidor MCP permite que su asistente de IA trabaje con CHAMPREP Código, Granja de ejecutores y Control de calidad en su nombre: busque proyectos y sus URL de clonación, compruebe los flujos de trabajo, lea los registros de tareas, supervise los ejecutores y los grupos de ejecutores, realice un seguimiento de los análisis de control de calidad y clasifique los resultados. El asistente actúa siempre como usted: sus roles, su plan, las políticas de su organización y (con una claveAPI) los ámbitos de la clave se aplican exactamente igual que en las aplicaciones web.
Conéctese
Sección titulada «Conéctese»Conecte su cliente de IA a https://ai-api.champrep.com/mcp/v1 tal y como se describe en
Servidor MCP. El inicio de sesión mediante navegador funciona para usuarios que utilicen un teclado; para scripts y CI, utilice una API clave. Los ámbitos que son relevantes en este caso:
| Servicio | Solo lectura | Leer y modificar |
|---|---|---|
| CHAMPREP Code | code:read_api | code:api |
| Granja de ejecutores | runner_farm:read | runner_farm:write |
| Control de calidad | qa:read | qa:write |
Encontrar la operación adecuada
Sección titulada «Encontrar la operación adecuada»Cuando su cuenta alcance un catálogo extenso (más de unas 1.000 operaciones, cifra que casi alcanza Code por sí solo), su cliente verá dos herramientas auxiliares en lugar de una herramienta por lectura: champrep_search_tools y champrep_read. Su asistente realiza búsquedas con unas pocas palabras sencillas, lee la entrada exacta que necesita y, a continuación, ejecuta la operación. Búsquedas como registro de tareas, última secuencia de comandos,
Etiquetas de «runner», proyectos de grupo o control de calidad Funcionamiento: cada palabra se compara por separado y las mejores coincidencias aparecen en primer lugar. En ese modo, las lecturas pasan por
champrep_read; con un catálogo más reducido, cada operación aparece como una herramienta independiente. Cada cambio tiene siempre su propia herramienta con nombre, por lo que su cliente puede consultarle antes de ejecutarla.
CHAMPREP Code
Sección titulada «CHAMPREP Code»
Proyectos, grupos y clonación
Sección titulada «Proyectos, grupos y clonación»- Obtenga una lista de los proyectos a los que tiene acceso, o de todos los proyectos de un grupo con todos sus subgrupos. Cada proyecto incluye sus URL de clonación HTTPS y SSH.
- Clone un grupo completo. MCP no puede ejecutarse
giten su equipo. Solicite, en su lugar, un plan de clonación:code_clone_group_planenumera todos los proyectos del grupo (incluidos los subgrupos) y devuelve comandos listos para ejecutarsegit clonecomandos que conservan la estructura de carpetas del grupo. Las carpetas que ya existen se omiten, por lo que puede ejecutar la lista de nuevo. Ejecútelos usted mismo en un shell POSIX o deje que un agente de programación local (Claude Code, Codex, Cursor) los ejecute en su terminal. - La clonación por SSH requiere una clave SSH en su perfil de Code. La clonación por HTTPS le solicita su nombre de usuario y un token de acceso personal que debe crear en Code: nunca pegue un token en el chat.
Pipelines y trabajos
Sección titulada «Pipelines y trabajos»- Estado del pipeline por rama, el pipeline más reciente de una rama, los trabajos de un pipeline y el resumen del informe de pruebas.
- Registros de tareas. Lea el registro de un trabajo; en el caso de registros largos, el asistente lo lee por partes indicando un rango de bytes, de modo que puede saltar al final de un trabajo fallido.
- Ejecute un nuevo pipeline, reintente o cancele un pipeline, ejecute una tarea manual, reintente o cancele una tarea.
- Enumere y descargue los artefactos de los trabajos (archivos pequeños; los archivos grandes se descarguen desde Code).
Runners
Sección titulada «Runners»- Visualice una lista de sus ejecutores, los ejecutores de un proyecto (los propios, los de sus grupos y los ejecutores de la instancia que puede utilizar) y los ejecutores de un grupo, con el estado, el estado en línea, las etiquetas, el estado en pausa y el último contacto.
- Consulte los detalles de un ejecutor y los trabajos que ha ejecutado, así como el número de trabajos que están a la espera de un ejecutor.
- Registre un nuevo «runner». El asistente abre la página «nuevo ejecutor» de Code para el proyecto o grupo. Allí obtendrá el token del ejecutor: este nunca se muestra al asistente.
- Modificar un «runner»: añada o elimine etiquetas, póngalo en pausa o reanúdelo, modifique su descripción, si ejecuta trabajos sin etiquetar, su protección o su tiempo de espera máximo . Las etiquetas se envían como una nueva lista completa, por lo que el asistente lee primero el ejecutor. Cada cambio se ejecuta únicamente después de que usted lo apruebe.
- Asignar un ejecutor de proyecto existente a otro proyecto del que sea responsable.
- Eliminar un ejecutor, o desvincularlo de un proyecto: acciones destructivas (véase Lo que requiere su aprobación).
- El código determina quién puede modificar cada ejecutor: los ejecutores de proyecto y de grupo requieren el rol de «Responsable de mantenimiento» o «Propietario», mientras que los ejecutores de instancia requieren un «Administrador de código».
- El asistente también puede proporcionarle un enlace directo a la página de configuración de un ejecutor en Code.
Solicitudes de fusión y incidencias
Sección titulada «Solicitudes de fusión y incidencias»Enumere, lea, abra, actualice, apruebe y fusione solicitudes de fusión; comente las solicitudes de fusión y los incidencias; enumere, cree y actualice incidencias. Al aprobar, se especifica la rama de destino que ha leído el asistente, de modo que una solicitud de fusión reorientada no se apruebe por error.
Granja de ejecutores
Sección titulada «Granja de ejecutores»- Sus cuentas y espacios de trabajo de Runner Farm, su rol y las clases de máquinas y los límites máximos de su plan.
- Conexiones con servidores de código: visualícelas y léalas; cambie el nombre, pause, reanude o etiquete una conexión.
- Grupos: visualícelos y consúltelos (incluidos los tiempos de espera), cree un grupo, cámbiele el nombre, póngalo en pausa, reanúdelo o escala (concurrencia y tiempo de espera de la tarea), y restaurar un grupo o una conexión desde «Eliminados recientemente».
- Créditos y uso: su saldo de créditos, el uso mensual, por clase, grupo o proyecto, y el registro de créditos.
- Tareas: tareas en curso, en espera y rechazadas, así como los detalles de una tarea concreta.
- Conexión de un host de código y su token de ejecución, así como los secretos del conector, se realizan en la aplicación Runner Farm: el asistente le proporciona un enlace seguro y nunca tiene acceso a las credenciales.
Control de calidad
Sección titulada «Control de calidad»- Repositorios: vea una lista de los repositorios conectados y disponibles, actívelos y sincronícelos; lo mismo ocurre con los proyectos de códigoCHAMPREP.
- Análisis: inicie un análisis, siga su estado, lea su registro (los secretos se ocultan) y consulte los totales de sus análisis.
- Hallazgos: mostrar una lista de hallazgos con filtros, desestimar un hallazgo indicando un motivo y un comentario, o reabrirlo.
- Control de calidad: el veredicto del control de calidad para un repositorio o una rama, con cada condición y el motivo por el que no se cumple. Funciona para repositorios de CHAMPREP Code, GitHub yGitLab Bitbucket que estén conectados a QA.
- Vistas previas: Iniciar una compilación de vista previa de una rama, ver la lista de vistas previas, leer sus registros y los registros de compilación, ampliar una vista previa o modificar su visibilidad. Los repositorios que requieren secretos se inician desde la aplicación de control de calidad.
- IDE en la nube: Inicie una sesión de IDE en un repositorio o un espacio de trabajo vacío, a continuación, ábralo desde el enlace a su página en la aplicación de control de calidad; consulte y revise sus sesiones. El token de acceso de la sesión nunca se muestra al asistente.
- Al iniciar una vista previa o una sesión de IDE se consume el cupo de control de calidad de su plan y se ejecuta solo después de que usted lo apruebe.
Ejemplos de mensajes de solicitud
Sección titulada «Ejemplos de mensajes de solicitud»- «Muestre el estado más reciente de los pipelines de todos los proyectos del grupo acme/platform».
- «Muestre el registro del trabajo fallido en el último pipeline de acme/web».
- «Vuelva a intentar los trabajos fallidos del pipeline 4211 en acme/web».
- «¿Qué ejecutores utiliza acme/web y cuáles están desconectados?»
- «Añada la etiqueta gpu al ejecutor 12». (El asistente lee las etiquetas actuales y le solicita que apruebe la nueva lista).
- «Ponga en pausa el ejecutor 12 hasta que finalice el mantenimiento de mañana».
- «Inicie una vista previa de control de calidad de la rama feature/login de acme/web».
- «Abra una sesión de IDE en la nube en acme/web».
- «Registre un nuevo ejecutor para el grupo acme». (Aparecerá la página «nuevo ejecutor» de Code).
- «Facilítenme los comandos de clonación para todos los proyectos del grupo acme, incluidos los subgrupos».
- «¿Cuántos trabajos están a la espera de un ejecutor en acme/web en este momento?»
- «Amplíe mi grupo de mi granja de ejecutores «build-large» a 20 trabajos simultáneos».
- «¿Cuántos créditos de Runner Farm he utilizado este mes, por clase de máquina?»
- «Inicie un análisis de control de calidad de acme/web y avíseme cuando haya finalizado».
- «Enumere los hallazgos de control de calidad de alta gravedad pendientes en acme/web».
- «Descartar QA-0970 como falso positivo: la clave es un dispositivo de prueba».
- «¿Supera acme/web su control de calidad en la rama principal?»
Lo que requiere su aprobación
Sección titulada «Lo que requiere su aprobación»- Lecturas (listas, detalles, registros, uso) no modifican nada. En catálogos de gran tamaño se ejecutan a través de
champrep_read. - Cambios (ejecutar, reintentar o cancelar pipelines y trabajos, abrir o fusionar solicitudes de fusión, comentar, modificar, pausar, reanudar o asignar ejecutores, crear o escalar grupos, iniciar análisis, descartar hallazgos, iniciar vistas previas de control de calidad y sesiones de IDE) cada una tiene su propia herramienta. Su cliente MCP decide cómo le solicita que confirme: revise su configuración de aprobación antes de permitir los cambios.
- Acciones destructivas (eliminar un pipeline, eliminar un runner o desvincularlo de un proyecto, eliminar un pool, detener todos los trabajos en ejecución de Runner Farm) permanecen ocultas hasta que la conexión permita acciones destructivas y la URL termine en
?destructive=true. Véase Servidor MCP. - Cada cambio es comprobado de nuevo por el servicio en función de su rol y su plan.
Qué no está disponible y por qué
Sección titulada «Qué no está disponible y por qué»| No disponible a través de MCP | ¿Por qué? | Dónde realizarlo |
|---|---|---|
Ejecución git (clonar, enviar) en su equipo | Las herramientas de MCP se ejecutan en CHAMPREP, no en su ordenador | Ejecute los comandos desde code_clone_group_plan, o utilice un agente de programación local |
| Ver un token de ejecutor, un token de ejecutor de Runner Farm o un secreto de conector, o modificar la fecha de caducidad de un token de ejecutor | Las credenciales no deben introducirse nunca en un chat, una solicitud ni un registro | Las páginas de ejecutores de Code y la aplicación Runner Farm (el asistente le proporciona el enlace) |
| Modificar la configuración de CI/CD de un proyecto (por ejemplo, activar ejecutores de instancia o de grupo) | Code solicita una confirmación adicional que solo usted puede proporcionar | La configuración de CI/CD del proyecto en Code |
| Ejecutar comandos o editar archivos dentro de una sesión de IDE en la nube | La ejecución de código arbitrario se realiza en el IDE que abra. | El IDE en la nube de QA |
| Creación de tokens de acceso, tokens de implementación o claves; lectura de variables de CI/CD | Las credenciales y los secretos permanecen en Code | Configuración de Code |
| Modificación de las protecciones (ramas protegidas, reglas de aprobación, miembros, visibilidad) | Code solicita una confirmación adicional | Configuración de Code |
| Descartar un hallazgo de secretos | La confirmación de que se ha revocado un secreto es su propia declaración. | La aplicación de control de calidad |
| Combinación de Code con Runner Farm y su secreto de conector | El código de emparejamiento y el secreto son credenciales | El área de administración de Code |
Las operaciones que vea también dependen de su plan, de las políticas de su organización, de sus permisos de IA por servicio y, en el caso de una API clave, de sus ámbitos de aplicación.