Pular para o conteúdo
Documentation

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 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çoSomente leituraLeia e altere
CHAMPREP Codecode:read_apicode:api
Fazenda de Executoresrunner_farm:readrunner_farm:write
QAqa:readqa:write

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.

  • 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 git em sua máquina. Solicite, em vez disso, um plano de clonagem: code_clone_group_plan lista todos os projetos do grupo (incluindo subgrupos) e retorna comandos prontos para execução git clone comandos 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.

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

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

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.

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

  • “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?”

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

Indisponível por meio do MCPPor queOnde realizar a ação
Execução git (clonar, enviar) em sua máquinaAs ferramentas do MCP são executadas no CHAMPREP, e não no seu computadorExecute 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 executadorAs credenciais nunca devem ser inseridas em um chat, prompt ou logAs 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 fornecerAs configurações de CI/CD do projeto no Code
Executar comandos ou editar arquivos dentro de uma sessão de IDE na nuvemA execução de código arbitrário permanece no IDE que o senhor abrirO IDE em nuvem do QA
Criação de tokens de acesso, tokens de implantação ou chaves, leitura de variáveis de CI/CDAs credenciais e os segredos permanecem no CodeConfigurações de código
Alteração de proteções (ramificações protegidas, regras de aprovação, membros, visibilidade)O Code solicita uma confirmação adicionalConfigurações de código
Ignorando uma descoberta de segredoA confirmação de que um segredo foi revogado é de sua exclusiva responsabilidadeO aplicativo de QA
Emparelhamento do Code com o Runner Farm e seu segredo de conexãoO código de emparelhamento e o segredo são credenciaisA á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.