Documentação

Segurança por meio de MCP e Chat

Leia os achados e aja com base neles no Chat ou no seu próprio assistente, seguindo as regras do portal, e entenda por que algumas ações sempre dependem de uma pessoa.

Você pode ler os achados de Segurança e agir com base neles no assistente de Chat ou no seu próprio assistente por meio de CoRoid como servidor MCP: Claude Code, Codex, Cursor ou outro cliente MCP. As ferramentas seguem as mesmas regras do portal, portanto fornecem as mesmas respostas e recusam as mesmas solicitações.

Leitura

Segurança possui seus próprios escopos; assim, uma conexão criada para outras tarefas não visualiza os achados. Essas ferramentas precisam da função de Revisor e mcp.security.read. Nenhuma delas requer aprovação. Elas seguem as regras próprias de Segurança do CoRoid: você vê os projetos que pode visualizar no portal. Uma conexão limitada a alguns projetos deve especificar um deles ou um achado relacionado.

FerramentaO que ela responde
get_security_overviewPor projeto: achados abertos por gravidade, além da data de correção, itens que ninguém confirmou, código de teste e quantos aguardam sua atenção
list_security_findingsAchados por projeto, tipo, gravidade e estado, listados primeiro pelos explorados e depois pela gravidade; needsYou retém apenas aqueles que aguardam uma pessoa
list_security_needsAs decisões que aguardam a intervenção de uma pessoa, priorizando as urgentes, cada uma com a resposta do CoRoid e um link para acessá-la: a mesma lista disponível em Segurança → Decisões.
get_security_findingUm achado: onde ele está, se foi confirmado, quando deve ser corrigido e o trabalho de correção necessário. Nunca o valor de um segredo
get_security_settingsCada proteção de um projeto é aplicada conforme as verificações: desativada, observando, impondo ou indisponível, e o motivo, de acordo com a configuração do projeto
list_security_runsExecuções de Segurança, mais recentes primeiro, conforme listadas no registro de execução: em andamento, aguardando, concluídas, falhas ou substituídas, e o motivo de uma falha
get_attack_surfaceOs pontos de entrada de cada projeto e quantos aguardam exposição; para um projeto específico, todos os pontos de entrada com o que o código exibe e o que as pessoas decidiram, sugestões de implantação e o que o guarda do pull request encontrou
get_threat_modelA versão do modelo de ameaças de cada projeto e o que aguarda revisão; para um projeto específico, o modelo, a proposta pendente e as versões mais recentes
list_security_packagesOs inventários de dependências mais recentes de cada projeto com a quantidade de pacotes instalados e os vulneráveis; para um projeto específico, seus pacotes, página por página, começando pelos vulneráveis

Todo achado vincula-se à sua página no CoRoid.

Agindo sobre os achados

Essas ferramentas agem sobre os achados. Elas precisam de mcp.security.write e de um proprietário ou administrador, assim como no portal.

FerramentaO que ela fazAprovação
start_security_fixCorreção, como no portal: trabalho de correção para uma dependência vulnerável, uma tarefa com teste de regressão para um achado de código, a lista de verificação de rotação para uma credencial vazada. Uma segunda Correção responde à tarefa já abertaNão
run_security_scanAnalisar um projeto agora: tudo o que está ativo, dependências, histórico de segredos, superfície de ataque, auditoria (onde está ativa) ou provas armazenadasNão
confirm_real_secretConfirmar que uma credencial vazada é real. Ela permanece aberta até que alguém ateste que foi rotacionadaNão
revoke_security_exceptionEncerrar uma exceção: o achado reabreNão
dismiss_security_findingMarcar um achado como Não é problema, com um motivoSempre
add_security_exceptionAceitar o risco de um achado até uma data determinada, com um motivoSempre
attest_secret_rotatedAtestar que uma credencial vazada foi rotacionada ou revogada, o que a fecha. O CoRoid nunca testa uma credencial que encontraSempre

Agindo sobre a superfície de ataque e o modelo de ameaças

Isso também requer mcp.security.write e um proprietário ou administrador. Quando um controle no portal tanto reforça quanto enfraquece, existem duas ferramentas: a que reforça recusa uma alteração que enfraqueceria, de modo que essa alteração sempre dependa de uma pessoa.

FerramentaO que ela fazAprovação
raise_entry_point_exposureTornar os pontos de entrada mais expostos, fixá-los para a auditoria ou trazê-los de volta ao escopoNão
lower_entry_point_exposureTornar os pontos de entrada menos expostos, remover uma fixação ou colocá-los fora do escopo com um motivoSempre
refresh_threat_modelLer novamente o código do projeto; o que encontrar será apresentado como propostaNão
add_threat_model_entriesAdicionar entradas ao modelo de ameaçasNão
accept_threat_model_proposalAceitar o que uma nova leitura do código propôsNão
update_threat_model_entriesAlterar o título ou detalhe de uma entradaSempre
remove_threat_model_entriesRemover entradas do modelo de ameaçasSempre
dismiss_threat_model_proposalRejeitar o que uma nova leitura do código propôsSempre
keep_security_proofManter uma prova que reproduziu um achado como seu teste de regressãoNão

Alterando proteções

As configurações de uma proteção, para um projeto específico ou para o padrão da organização, estão nas mesmas duas ferramentas: tighten_security_protection torna uma proteção mais robusta e rejeita qualquer alteração que a enfraqueça, e relax_security_protection a torna mais fraca, ou faz com que o projeto volte a seguir o padrão da organização, e sempre aguarda a intervenção de uma pessoa. Uma alteração enfraquece quando a detecção ou a aplicação das regras é reduzida, o limite de severidade aumenta, menos solicitações de correção são abertas, a auditoria é desativada ou executada com menor frequência, a varredura de segredos analisa menos dados, a rede do ambiente isolado é ampliada ou permite mais hosts, ou um ponto de entrada marcado como "não definido" deixa de ser considerado acessível pela internet. A opção "Seu próprio comando de varredura" é configurada em Controle de Qualidade.

Contatos e divulgação

Os contatos de segurança de um projeto possuem autoridade para divulgar informações, além dos proprietários e administradores: eles visualizam as correções privadas que o CoRoid armazena para vulnerabilidades ainda não divulgadas, podem publicá-las ou descartá-las, elaborar avisos de segurança do tipo GitHub e registrar relatórios para os mantenedores de dependências. Por meio do MCP e do Chat, essas ações são destinadas aos proprietários e administradores, e todas aguardam a intervenção de uma pessoa: um contato pode divulgar uma vulnerabilidade, e uma vez divulgada, essa informação não pode ser retirada.

FerramentaO que ela fazAprovação
list_security_contactsOs contatos de segurança de um projeto e quem pode ocupar esse cargoNão
get_security_disclosureAs correções privadas de uma vulnerabilidade (tamanho e estado, nunca seu conteúdo), o aviso do tipo GitHub e os relatórios enviados aos mantenedores, para a autoridade de divulgaçãoNão
add_security_contactDesignar um membro do projeto como contato de segurançaSempre
remove_security_contactRemover um contato de segurançaSempre
publish_private_fixPublicar uma correção retida: a vulnerabilidade é divulgada e uma tarefa abre seu registro no pull requestSempre
discard_private_fixDescartar uma correção retidaSempre
draft_github_security_advisoryElaborar um aviso de segurança do tipo GitHub no repositório, visível para seus mantenedoresSempre
record_maintainer_reportRegistrar onde você reportou a vulnerabilidade aos mantenedores de dependências. O CoRoid não envia nada.Sempre

Por que algumas ações aguardam a intervenção de uma pessoa

Um problema identificado, um risco aceito e uma credencial rotacionada retiram uma vulnerabilidade da lista aberta sem exigir correção; um ponto de entrada menos exposto e um modelo de ameaça menor também são excluídos do escopo da auditoria. Um assistente não deve poder realizar essas ações sozinho, portanto essas ferramentas sempre aguardam a intervenção de uma pessoa, independentemente das configurações da conexão:

  • A partir de um cliente MCP, a chamada aguarda a confirmação de um proprietário ou administrador Configurações → Conexões → Servidor MCP do CoRoid → Aprovações, e eles recebem uma notificação. A solicitação expira após 10 minutos.
  • No Chat, o assistente pede sua confirmação no chat antes de agir.

A aprovação descreve em linguagem simples o que acontecerá, com base no registro próprio do CoRoid sobre a vulnerabilidade: "Marcar Controle de acesso quebrado em src/routes/admin.ts:76 (Loja) Não é um problema", seguido pelo motivo entre aspas. As palavras ao redor do motivo provêm do CoRoid, nunca do assistente, e o valor de uma credencial nunca é exibido: o CoRoid não o armazena.