Ir al contenido
Documentation

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.

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:

ServicioSolo lecturaLeer y modificar
CHAMPREP Codecode:read_apicode:api
Granja de ejecutoresrunner_farm:readrunner_farm:write
Control de calidadqa:readqa:write

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.

  • 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 git en su equipo. Solicite, en su lugar, un plan de clonación: code_clone_group_plan enumera todos los proyectos del grupo (incluidos los subgrupos) y devuelve comandos listos para ejecutarse git clone comandos 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.

  • 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).
  • 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.

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.

  • 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.

  • 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.

  • «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?»

  • 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.

No disponible a través de MCP¿Por qué?Dónde realizarlo
Ejecución git (clonar, enviar) en su equipoLas herramientas de MCP se ejecutan en CHAMPREP, no en su ordenadorEjecute 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 ejecutorLas credenciales no deben introducirse nunca en un chat, una solicitud ni un registroLas 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 proporcionarLa configuración de CI/CD del proyecto en Code
Ejecutar comandos o editar archivos dentro de una sesión de IDE en la nubeLa 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/CDLas credenciales y los secretos permanecen en CodeConfiguración de Code
Modificación de las protecciones (ramas protegidas, reglas de aprobación, miembros, visibilidad)Code solicita una confirmación adicionalConfiguración de Code
Descartar un hallazgo de secretosLa 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 conectorEl código de emparejamiento y el secreto son credencialesEl á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.