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.
| Herramienta | Qué responde |
|---|---|
get_security_overview | Por 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_findings | Hallazgos 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_needs | Las 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_finding | Un 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_settings | Cada 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_runs | Las 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_surface | Los 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_model | La 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_packages | Los 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.
| Herramienta | Qué hace | Aprobación |
|---|---|---|
start_security_fix | Corregir, 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 creada | No |
run_security_scan | Analizar un proyecto ahora: todo lo activo, dependencias, historial de secretos, superficie de ataque, auditoría (dónde está activa) o pruebas conservadas | No |
confirm_real_secret | Confirmar que una credencial filtrada es real. Permanecerá abierta hasta que alguien certifique que se ha rotado | No |
revoke_security_exception | Finalizar una excepción: el hallazgo volverá a estar abierto | No |
dismiss_security_finding | Marcar un hallazgo como No es un problema, con un motivo | Siempre |
add_security_exception | Aceptar el riesgo de un hallazgo hasta una fecha determinada, con un motivo | Siempre |
attest_secret_rotated | Certificar que una credencial filtrada se ha rotado o revocado, lo que la cierra. CoRoid nunca prueba una credencial que detecta | Siempre |
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.
| Herramienta | Qué hace | Aprobación |
|---|---|---|
raise_entry_point_exposure | Hacer que los puntos de entrada sean más expuestos, fijarlos para la auditoría o incluirlos nuevamente en el alcance | No |
lower_entry_point_exposure | Hacer que los puntos de entrada sean menos expuestos, eliminar una fijación o sacarlos del alcance con un motivo | Siempre |
refresh_threat_model | Leer nuevamente el código del proyecto; lo que encuentre esperará como propuesta | No |
add_threat_model_entries | Añadir entradas al modelo de amenazas | No |
accept_threat_model_proposal | Aceptar lo que propuso una nueva lectura del código | No |
update_threat_model_entries | Cambiar el título o detalle de una entrada | Siempre |
remove_threat_model_entries | Eliminar entradas del modelo de amenazas | Siempre |
dismiss_threat_model_proposal | Rechazar lo que propuso una nueva lectura del código | Siempre |
keep_security_proof | Conservar una prueba que reprodujo un hallazgo como su prueba de regresión | No |
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.
| Herramienta | Qué hace | Aprobación |
|---|---|---|
list_security_contacts | Los contactos de seguridad de un proyecto y quién puede serlo | No |
get_security_disclosure | Las 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ón | No |
add_security_contact | Convertir a un miembro del proyecto en contacto de seguridad | Siempre |
remove_security_contact | Eliminar un contacto de seguridad | Siempre |
publish_private_fix | Publicar una corrección pendiente: el hallazgo queda divulgado y se abre una tarea de tipo pull request | Siempre |
discard_private_fix | Descartar una corrección pendiente | Siempre |
draft_github_security_advisory | Redactar un aviso de seguridad de tipo GitHub en el repositorio, visible para sus mantenedores | Siempre |
record_maintainer_report | Registrar 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.