MCP para Código, CI, Farm de Executores e QA
O CHAMPREP Servidor MCP permite que seu assistente de IA trabalhe com CHAMPREP Código, Fazenda de Executores e QA em seu nome: encontre projetos e suas URLs de clonagem, verifique pipelines, leia logs de tarefas, monitore executores e pools de executores, acompanhe varreduras de controle de qualidade e classifique os resultados. O assistente sempre atua como você: suas funções, seu plano, as políticas da sua organização e (com uma API chave) os escopos da chave se aplicam exatamente como nos aplicativos da web.
Conecte-se
Seção intitulada “Conecte-se”Conecte seu cliente de IA a https://ai-api.champrep.com/mcp/v1 conforme descrito em
Servidor MCP. O login pelo navegador funciona para pessoas que estejam digitando no teclado; para scripts e CI, utilize uma API chave. Os escopos relevantes aqui são:
| Serviço | Somente leitura | Leia e altere |
|---|---|---|
| CHAMPREP Code | code:read_api | code:api |
| Fazenda de Executores | runner_farm:read | runner_farm:write |
| QA | qa:read | qa:write |
Encontrando a operação correta
Seção intitulada “Encontrando a operação correta”Quando sua conta atingir um catálogo extenso (mais de cerca de 1.000 operações, o que o Code por si só já quase atinge), seu cliente verá duas ferramentas auxiliares em vez de uma ferramenta por leitura: champrep_search_tools e champrep_read. Seu assistente realiza a pesquisa com algumas palavras simples, lê a entrada exata de que precisa e, em seguida, executa a operação. Pesquisas como registro de tarefas, pipeline mais recente,
tags do runner, projetos em grupo ou controle de qualidade Funcionamento: cada palavra é comparada individualmente e as melhores correspondências aparecem primeiro. Nesse modo, as leituras passam por
champrep_read; com um catálogo menor, cada operação é listada como uma ferramenta própria. Cada alteração sempre tem sua própria ferramenta nomeada, para que seu cliente possa consultar você antes de executá-la.
CHAMPREP Code
Seção intitulada “CHAMPREP Code”
Projetos, grupos e clonagem
Seção intitulada “Projetos, grupos e clonagem”- Liste os projetos aos quais o(a) senhor(a) tem acesso ou todos os projetos de um grupo com todos os seus subgrupos. Cada projeto vem com suas URLs de clonagem HTTPS e SSH.
- Clone um grupo inteiro. O MCP não pode ser executado
gitem sua máquina. Solicite, em vez disso, um plano de clonagem:code_clone_group_planlista todos os projetos do grupo (incluindo subgrupos) e retorna comandos prontos para execuçãogit clonecomandos que mantêm a estrutura de pastas do grupo. As pastas que já existem são ignoradas, de modo que você pode executar a lista novamente. Execute-os você mesmo em um shell POSIX ou permita que um agente de programação local (Claude Code, Codex, Cursor) os execute em seu terminal. - A clonagem via SSH requer uma chave SSH no seu perfil do Code. A clonagem via HTTPS solicita seu nome de usuário e um token de acesso pessoal que você cria no Code: nunca cole um token no chat.
Pipelines e tarefas
Seção intitulada “Pipelines e tarefas”- Status do pipeline por ramificação, o pipeline mais recente de uma ramificação, as tarefas de um pipeline e o resumo do relatório de testes.
- Logs de tarefas. Leia o log de uma tarefa; no caso de logs longos, o assistente os lê em partes com um intervalo de bytes, para que possa pular para o final de uma tarefa com falha.
- Execute um novo pipeline, repita ou cancele um pipeline, execute uma tarefa manual, repita ou cancele uma tarefa.
- Liste e baixe artefatos de tarefas (arquivos pequenos; arquivos grandes são baixados do Code).
Executores
Seção intitulada “Executores”- Liste seus executores, os executores de um projeto (os próprios, os de seus grupos e os executores da instância que ele pode utilizar) e os executores de um grupo, com status, estado online, tags, estado pausado e último contato.
- Veja os detalhes de um executor e as tarefas que ele executou, além de quantas tarefas estão aguardando por um executor.
- Registre um novo runner. O assistente abre a página “novo executor” do Code para o projeto ou grupo. Lá, o senhor obtém o token do executor: ele nunca é exibido para o assistente.
- Alterar um executor: adicione ou remova tags, pause ou retome a execução, altere sua descrição, defina se ela executa tarefas sem tags, sua proteção ou seu tempo máximo de espera. As tags são enviadas como uma nova lista completa, de modo que o assistente lê o executor primeiro. Cada alteração só é executada após sua aprovação.
- Atribuir um executador de projeto existente para outro projeto de que o senhor é responsável.
- Excluir um executor ou desvincule-o de um projeto: ações destrutivas (consulte O que precisa da sua aprovação).
- O código determina quem pode alterar qual executor: os executores de projeto e de grupo exigem a função de Mantenedor ou Proprietário, enquanto os executores de instância exigem um administrador de código.
- O assistente também pode fornecer a você um link direto para a página de configurações de um executor no Code.
Solicitações de mesclagem e issues
Seção intitulada “Solicitações de mesclagem e issues”Listar, ler, abrir, atualizar, aprovar e mesclar solicitações de mesclagem; comentar sobre solicitações de mesclagem e issues; listar, criar e atualizar issues. A aprovação especifica o ramo de destino que o assistente leu, para que uma solicitação de mesclagem redirecionada não seja aprovada por engano.
Fazenda de Executores
Seção intitulada “Fazenda de Executores”- Suas contas e espaços de trabalho no Runner Farm, sua função e as classes de máquinas e limites máximos do seu plano.
- Conexões com hosts de código: liste-as e leia-as; renomeie, pause, retome ou rotule uma conexão.
- Pools: liste-os e leia-os (incluindo tempos de espera), crie um pool, renomeie, pausar, retomar ou escala (concorrência e tempo limite da tarefa) e restaurar um pool ou conexão a partir da seção “Excluídos recentemente”.
- Créditos e uso: seu saldo de créditos, uso por mês, por turma, pool ou projeto, e o registro de créditos.
- Tarefas: tarefas ativas, suspensas e recusadas, além dos detalhes de uma tarefa.
- Conectando um host de código e seu token de executor, além dos segredos do conector, são realizadas no aplicativo Runner Farm: o assistente fornece um link seguro e nunca tem acesso às credenciais.
- Repositórios: liste os repositórios conectados e disponíveis, ative-os e sincronize-os; o mesmo vale para projetos de códigoCHAMPREP.
- Varreduras: inicie uma varredura, acompanhe seu status, leia seu log (os segredos são ocultados) e visualize os totais das suas varreduras.
- Constatações: liste as constatações com filtros, rejeitar uma constatação com um motivo e um comentário, ou reabri-la.
- Controle de qualidade: o veredicto do controle de qualidade para um repositório ou ramo, com cada condição e o motivo da falha. Funciona para repositórios do CHAMPREP Code, GitHub GitLabe Bitbucket que estejam conectados ao QA.
- Pré-visualizações: inicie uma compilação de pré-visualização de um ramo, listar pré-visualizações, ler seus logs e logs de compilação, estender uma pré-visualização ou alterar sua visibilidade. Repositórios que exigem segredos são iniciados a partir do aplicativo de QA.
- IDE na nuvem: inicie uma sessão de IDE em um repositório ou em um espaço de trabalho vazio, em seguida, abra-o a partir do link para sua página no aplicativo de QA; liste e leia suas sessões. O token de acesso da sessão nunca é exibido ao assistente.
- Iniciar uma pré-visualização ou uma sessão de IDE utiliza a cota de QA do seu plano e é executada somente após a sua aprovação.
Exemplos de solicitações
Seção intitulada “Exemplos de solicitações”- “Liste o status mais recente do pipeline para cada projeto no grupo acme/platform.”
- “Mostre o log da tarefa com falha no último pipeline de acme/web.”
- “Repita as tarefas com falha do pipeline 4211 em acme/web.”
- “Quais runners o acme/web utiliza e quais estão offline?”
- “Adicione a tag gpu ao executor 12.” (O assistente lê as tags atuais e solicita que você aprove a nova lista.)
- “Pause o executor 12 até que a manutenção de amanhã seja concluída.”
- “Inicie uma pré-visualização de QA do ramo feature/login de acme/web.”
- “Abra uma sessão do IDE na nuvem em acme/web.”
- “Registre um novo executor para o grupo acme.” (Você acessa a página “novo executor” do Code.)
- “Forneça-me os comandos de clonagem para todos os projetos do grupo acme, incluindo subgrupos.”
- “Quantos trabalhos estão aguardando um executor em acme/web neste momento?”
- “Dimensionar meu pool ‘build-large’ da Runner Farm para 20 tarefas simultâneas.”
- “Quantos créditos da Runner Farm eu usei este mês, por classe de máquina?”
- “Inicie uma verificação de controle de qualidade (QA) do acme/web e avise-me quando terminar.”
- “Liste as constatações de QA de alta gravidade em aberto em acme/web.”
- “Descartar o QA-0970 como um falso positivo: a chave é um dispositivo de teste.”
- “O acme/web passa no controle de qualidade no main?”
O que requer sua aprovação
Seção intitulada “O que requer sua aprovação”- Leituras (listas, detalhes, logs, uso) não alteram nada. Em catálogos grandes elas são executadas por meio de
champrep_read. - Alterações (executar, repetir ou cancelar pipelines e tarefas, abrir ou mesclar solicitações de fusão, comentar, alterar, pausar, retomar ou atribuir executores, criar ou dimensionar pools, iniciar varreduras, descartar resultados, iniciar visualizações de QA e sessões de IDE) cada uma possui sua própria ferramenta. Seu cliente MCP decide como solicitará que você confirme: verifique suas configurações de aprovação antes de permitir alterações.
- Ações destrutivas (excluir um pipeline, excluir um executor ou desassociá-lo de um projeto, excluir um pool, interromper todas as tarefas em execução na Fazenda de Executores) permanecem ocultas até que a conexão permita ações destrutivas e a URL termine com
?destructive=true. Consulte Servidor MCP. - Cada alteração é verificada novamente pelo serviço com base na sua função e no seu plano.
O que não está disponível e por quê
Seção intitulada “O que não está disponível e por quê”| Indisponível por meio do MCP | Por que | Onde realizar a ação |
|---|---|---|
Execução git (clonar, enviar) em sua máquina | As ferramentas do MCP são executadas no CHAMPREP, e não no seu computador | Execute os comandos a partir de code_clone_group_plan, ou utilize um agente de codificação local |
| Visualizar um token de executador, um token de executador da Runner Farm ou um segredo de conector, ou alterar a data de validade de um token de executador | As credenciais nunca devem ser inseridas em um chat, prompt ou log | As páginas de executores do Code e o aplicativo Runner Farm (o assistente fornece o link) |
| Alterar as configurações de CI/CD de um projeto (por exemplo, ativar executadores de instância ou de grupo) | O Code solicita uma confirmação adicional que somente o(a) senhor(a) pode fornecer | As configurações de CI/CD do projeto no Code |
| Executar comandos ou editar arquivos dentro de uma sessão de IDE na nuvem | A execução de código arbitrário permanece no IDE que o senhor abrir | O IDE em nuvem do QA |
| Criação de tokens de acesso, tokens de implantação ou chaves, leitura de variáveis de CI/CD | As credenciais e os segredos permanecem no Code | Configurações de código |
| Alteração de proteções (ramificações protegidas, regras de aprovação, membros, visibilidade) | O Code solicita uma confirmação adicional | Configurações de código |
| Ignorando uma descoberta de segredo | A confirmação de que um segredo foi revogado é de sua exclusiva responsabilidade | O aplicativo de QA |
| Emparelhamento do Code com o Runner Farm e seu segredo de conexão | O código de emparelhamento e o segredo são credenciais | A área de administração do Code |
As operações exibidas também dependem do seu plano, das políticas da sua organização, das suas permissões de IA por serviço e, no caso de uma API chave, de seus escopos.