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.
| Ferramenta | O que ela responde |
|---|---|
get_security_overview | Por 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_findings | Achados 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_needs | As 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_finding | Um 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_settings | Cada 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_runs | Execuçõ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_surface | Os 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_model | A 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_packages | Os 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.
| Ferramenta | O que ela faz | Aprovação |
|---|---|---|
start_security_fix | Correçã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á aberta | Não |
run_security_scan | Analisar um projeto agora: tudo o que está ativo, dependências, histórico de segredos, superfície de ataque, auditoria (onde está ativa) ou provas armazenadas | Não |
confirm_real_secret | Confirmar que uma credencial vazada é real. Ela permanece aberta até que alguém ateste que foi rotacionada | Não |
revoke_security_exception | Encerrar uma exceção: o achado reabre | Não |
dismiss_security_finding | Marcar um achado como Não é problema, com um motivo | Sempre |
add_security_exception | Aceitar o risco de um achado até uma data determinada, com um motivo | Sempre |
attest_secret_rotated | Atestar que uma credencial vazada foi rotacionada ou revogada, o que a fecha. O CoRoid nunca testa uma credencial que encontra | Sempre |
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.
| Ferramenta | O que ela faz | Aprovação |
|---|---|---|
raise_entry_point_exposure | Tornar os pontos de entrada mais expostos, fixá-los para a auditoria ou trazê-los de volta ao escopo | Não |
lower_entry_point_exposure | Tornar os pontos de entrada menos expostos, remover uma fixação ou colocá-los fora do escopo com um motivo | Sempre |
refresh_threat_model | Ler novamente o código do projeto; o que encontrar será apresentado como proposta | Não |
add_threat_model_entries | Adicionar entradas ao modelo de ameaças | Não |
accept_threat_model_proposal | Aceitar o que uma nova leitura do código propôs | Não |
update_threat_model_entries | Alterar o título ou detalhe de uma entrada | Sempre |
remove_threat_model_entries | Remover entradas do modelo de ameaças | Sempre |
dismiss_threat_model_proposal | Rejeitar o que uma nova leitura do código propôs | Sempre |
keep_security_proof | Manter uma prova que reproduziu um achado como seu teste de regressão | Nã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.
| Ferramenta | O que ela faz | Aprovação |
|---|---|---|
list_security_contacts | Os contatos de segurança de um projeto e quem pode ocupar esse cargo | Não |
get_security_disclosure | As 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ção | Não |
add_security_contact | Designar um membro do projeto como contato de segurança | Sempre |
remove_security_contact | Remover um contato de segurança | Sempre |
publish_private_fix | Publicar uma correção retida: a vulnerabilidade é divulgada e uma tarefa abre seu registro no pull request | Sempre |
discard_private_fix | Descartar uma correção retida | Sempre |
draft_github_security_advisory | Elaborar um aviso de segurança do tipo GitHub no repositório, visível para seus mantenedores | Sempre |
record_maintainer_report | Registrar 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.