Documentación

Seguridad mediante MCP y Chat

Lea los Hallazgos y actúe sobre ellos desde el Chat o su propio asistente, siguiendo las reglas del portal, y descubra por qué algunas acciones siempre requieren su intervención.

Puede leer los Hallazgos de Seguridad y actuar sobre ellos desde el asistente de Chat, o desde su propio asistente a través de CoRoid como servidor MCP: Claude Code, Codex, Cursor u otro cliente MCP. Las herramientas siguen las mismas reglas que el portal, por lo que dan las mismas respuestas y rechazan las mismas cosas.

Lectura

Seguridad tiene ámbitos propios, por lo que una conexión establecida para otra tarea no verá los Hallazgos. Estas herramientas necesitan el rol de Revisor y mcp.security.read. Ninguna de ellas necesita aprobación. Siguen las reglas propias de Seguridad de CoRoid: verá los proyectos que puede ver en el portal. Una conexión limitada a algunos proyectos debe especificar uno de ellos, o un hallazgo de uno.

HerramientaQué responde
get_security_overviewPor proyecto: Hallazgos abiertos según gravedad, pasados su fecha de corrección, incidencias sin confirmar, código de prueba y cuántos esperan su atención
list_security_findingsHallazgos por proyecto, tipo, gravedad y estado, ordenados primero por explotación y luego por gravedad; needsYou muestra solo aquellos que requieren la atención de una persona
list_security_needsLas decisiones que requieren intervención humana, priorizando las urgentes, cada una con la respuesta de CoRoid y un enlace para acceder a ella: la misma lista que aparece en Seguridad → Decisiones.
get_security_findingUn hallazgo: dónde se encuentra, si fue confirmado, cuándo vence y el trabajo de corrección. Nunca el valor de un secreto
get_security_settingsCada protección de un proyecto se aplica según sus comprobaciones: desactivada, en observación, aplicando políticas o incapaz de ejecutarse, y el motivo, según la configuración del proyecto
list_security_runsLas ejecuciones de Seguridad, las más recientes primero, tal como las lista el registro de ejecución: en curso, en espera, completadas, fallidas o reemplazadas, y el motivo del fallo
get_attack_surfaceLos puntos de entrada de cada proyecto y cuántos esperan exposición; para un proyecto, cada punto de entrada con lo que muestra el código y lo que decidieron las personas, sugerencias de despliegue y lo que detectó el guardián de pull request
get_threat_modelLa versión del modelo de amenazas de cada proyecto y qué espera revisión; para un proyecto, el modelo, la propuesta pendiente y las versiones más recientes
list_security_packagesLos inventarios de dependencias más recientes de cada proyecto con cuántos paquetes instalan y cuántos son vulnerables; para un proyecto, sus paquetes página por página, empezando por los vulnerables

Cada hallazgo enlaza a su página en CoRoid.

Acción sobre los Hallazgos

Estas herramientas actúan sobre los Hallazgos. Necesitan mcp.security.write y un propietario o administrador, al igual que en el portal.

HerramientaQué haceAprobación
start_security_fixCorregir, como en el portal: trabajo de corrección para una dependencia vulnerable, una tarea con prueba de regresión para un hallazgo de código, la lista de verificación de rotación para una credencial filtrada. Una segunda acción de Corregir responde a la tarea ya creadaNo
run_security_scanAnalizar un proyecto ahora: todo lo activo, dependencias, historial de secretos, superficie de ataque, auditoría (dónde está activa) o pruebas conservadasNo
confirm_real_secretConfirmar que una credencial filtrada es real. Permanecerá abierta hasta que alguien certifique que se ha rotadoNo
revoke_security_exceptionFinalizar una excepción: el hallazgo volverá a estar abiertoNo
dismiss_security_findingMarcar un hallazgo como No es un problema, con un motivoSiempre
add_security_exceptionAceptar el riesgo de un hallazgo hasta una fecha determinada, con un motivoSiempre
attest_secret_rotatedCertificar que una credencial filtrada se ha rotado o revocado, lo que la cierra. CoRoid nunca prueba una credencial que detectaSiempre

Acción sobre la superficie de ataque y el modelo de amenazas

Estas también necesitan mcp.security.write y un propietario o administrador. Cuando un control en el portal tanto refuerza como debilita, existen dos herramientas: la que refuerza rechaza un cambio que debilite, de modo que ese cambio siempre pase por la que requiere la intervención de una persona.

HerramientaQué haceAprobación
raise_entry_point_exposureHacer que los puntos de entrada sean más expuestos, fijarlos para la auditoría o incluirlos nuevamente en el alcanceNo
lower_entry_point_exposureHacer que los puntos de entrada sean menos expuestos, eliminar una fijación o sacarlos del alcance con un motivoSiempre
refresh_threat_modelLeer nuevamente el código del proyecto; lo que encuentre esperará como propuestaNo
add_threat_model_entriesAñadir entradas al modelo de amenazasNo
accept_threat_model_proposalAceptar lo que propuso una nueva lectura del códigoNo
update_threat_model_entriesCambiar el título o detalle de una entradaSiempre
remove_threat_model_entriesEliminar entradas del modelo de amenazasSiempre
dismiss_threat_model_proposalRechazar lo que propuso una nueva lectura del códigoSiempre
keep_security_proofConservar una prueba que reprodujo un hallazgo como su prueba de regresiónNo

Cambiar las protecciones

La configuración de una protección, ya sea para un proyecto concreto o según los valores por defecto de la organización, se gestiona en las mismas dos herramientas: tighten_security_protection refuerza una protección y rechaza cualquier cambio que la debilite, y relax_security_protection la debilita, o hace que el proyecto vuelva a seguir los valores por defecto de la organización, y siempre espera la intervención de una persona. Un cambio debilita la protección cuando se reduce la detección o la aplicación de las reglas, cuando aumenta el umbral de gravedad, cuando se abren menos solicitudes de extracción para corregir errores, cuando se desactiva la auditoría o esta se ejecuta con menor frecuencia, cuando el escaneo de secretos cubre menos datos, cuando la red del entorno aislado se amplía o permite más hosts, o cuando un punto de entrada marcado como "no definido" deja de considerarse accesible desde Internet. El parámetro "Tu propio comando de escaneo" se configura en Control de Calidad.

Contactos y divulgación

Los contactos de seguridad de un proyecto tienen la autoridad para divulgar información, junto con los propietarios y administradores: pueden ver las correcciones privadas que CoRoid guarda para hallazgos aún no divulgados, publicarlas o descartarlas, redactar avisos de seguridad de tipo GitHub y registrar los informes para los mantenedores de las dependencias. A través de MCP y Chat, estas acciones están reservadas a propietarios y administradores, y todas requieren la intervención de una persona: un contacto puede divulgar hallazgos, y una vez divulgado un hallazgo, esta acción no se puede revertir.

HerramientaQué haceAprobación
list_security_contactsLos contactos de seguridad de un proyecto y quién puede serloNo
get_security_disclosureLas correcciones privadas de un hallazgo (tamaño y estado, nunca su contenido), su aviso de tipo GitHub y los informes enviados a los mantenedores, para la autoridad de divulgaciónNo
add_security_contactConvertir a un miembro del proyecto en contacto de seguridadSiempre
remove_security_contactEliminar un contacto de seguridadSiempre
publish_private_fixPublicar una corrección pendiente: el hallazgo queda divulgado y se abre una tarea de tipo pull requestSiempre
discard_private_fixDescartar una corrección pendienteSiempre
draft_github_security_advisoryRedactar un aviso de seguridad de tipo GitHub en el repositorio, visible para sus mantenedoresSiempre
record_maintainer_reportRegistrar dónde se informó del hallazgo a los mantenedores de las dependencias. CoRoid no envía nada.Siempre

Por qué algunas acciones esperan la intervención de una persona

Un problema, un riesgo aceptado y una credencial rotada sacan un hallazgo de la lista de pendientes sin necesidad de corrección; un punto de entrada menos expuesto y un modelo de amenaza más reducido también eliminan elementos de lo que analiza la auditoría. Un asistente no debe poder hacer esto por sí solo, por lo que estas herramientas siempre esperan la intervención de una persona, independientemente de la configuración de la conexión:

  • Desde un cliente MCP, la llamada espera la intervención de un propietario o administrador en Configuración → Conexiones → Servidor MCP de CoRoid → Aprobaciones, y estos reciben una notificación. La solicitud caduca tras 10 minutos.
  • En Chat, el asistente te pedirá confirmación en el chat antes de actuar.

La aprobación describe en lenguaje sencillo lo que sucederá, basándose en el registro propio de CoRoid sobre el hallazgo: "Marcar Control de acceso roto en src/routes/admin.ts:76 (Tienda) No es un problema", seguido del motivo entre comillas. Las palabras que rodean al motivo provienen de CoRoid, nunca del asistente, y el valor de una credencial nunca aparece: CoRoid no lo conserva.