Documentación · MCP
Servidor MCP de vetkit
Dale a tu agente de programación un auditor de código. El servidor MCP de vetkit permite que cualquier cliente de Model Context Protocol compatible con stdio conecte repositorios, ejecute auditorías y lea hallazgos e informes.
MCP es un estándar abierto, no una integración exclusiva de Claude. Configura un servidor stdio local llamado vetkit con la definición siguiente y sigue las instrucciones de tu cliente. La estructura de configuración varía. Los clientes que solo aceptan servidores HTTP/SSE remotos no pueden conectarse directamente; vetkit no ofrece un punto de conexión MCP remoto.
{ "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" }}Después, pídele a tu agente algo como “Audita acme/payments-api y dime qué debo corregir primero”. Recarga tu cliente y confirma que vetkit_list_repos aparece en su lista de herramientas.
Requisitos
- Node.js 20.3 o posterior, con
npxen tuPATH. - Una cuenta de vetkit y acceso a los repositorios de GitHub, Bitbucket Cloud o GitLab.com que quieras auditar.
- Una clave de API de vetkit (siguiente paso).
Crea una clave de API
- Abre Ajustes del espacio de trabajo → Claves de API en la app de vetkit. Solo los propietarios y administradores de la organización pueden gestionar claves.
- Ponle a la clave un nombre que indique dónde se va a usar, por ejemplo “MCP — portátil”.
- Para ejecutar auditorías de repositorios, selecciona
repos:read,audits:readyaudits:run(oaudits:write). Añaderepos:writepara conectar repositorios,findings:readpara leer hallazgos yreports:readpara leer informes. Iniciar o cancelar evaluaciones de IA requiereaudits:write. Para un agente de solo lectura, selecciona únicamente ámbitos de lectura. - Opcionalmente, define una fecha de expiración y un límite de solicitudes por minuto (60 de forma predeterminada, hasta 600).
- Copia el secreto. Tiene el formato
vk_live_…y se muestra una sola vez; vetkit solo almacena un hash.
Rotación y revocación
401 API_KEY_REVOKED.Instalación
Cursor
Añade la entrada vetkit siguiente a ~/.cursor/mcp.json (global) o a .cursor/mcp.json en un proyecto. No hagas commit de una configuración de proyecto que contenga tu clave.
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}VS Code / GitHub Copilot
Añade esta entrada a .vscode/mcp.json conservando los servidores existentes. VS Code / GitHub Copilot usa servers, no mcpServers. Inicia y autoriza vetkit desde la lista de servidores MCP. Sustituye el marcador de la clave y nunca hagas commit de una configuración que contenga tu secreto.
{ "servers": { "vetkit": { "type": "stdio", "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Codex
Añade estas secciones TOML a ~/.codex/config.toml sin sustituir los ajustes existentes. Codex CLI y la extensión del IDE comparten esta configuración. Sustituye el marcador de la clave, reinicia el cliente y verifica con codex mcp list. Mantén este archivo privado.
[mcp_servers.vetkit]command = "npx"args = ["-y", "@vetkit/mcp"] [mcp_servers.vetkit.env]VETKIT_API_KEY = "<your-api-key>"Claude Code
claude mcp add --transport stdio vetkit -e 'VETKIT_API_KEY=<your-api-key>' -- npx -y @vetkit/mcpAñade --scope user para que vetkit esté disponible en todos tus proyectos y no solo en el actual.
Claude Desktop
Abre Settings → Developer → Edit Config, añade vetkit a claude_desktop_config.json y reinicia Claude Desktop:
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Otros clientes MCP
Funciona con cualquier cliente que pueda lanzar un servidor stdio: ejecuta npx -y @vetkit/mcp con VETKIT_API_KEY en su entorno. También puedes instalar el paquete de forma global y ejecutar directamente el binario vetkit-mcp.
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcpConfiguración
El servidor se configura por completo mediante variables de entorno.
| Variable | Obligatoria | Descripción |
|---|---|---|
VETKIT_API_KEY | Sí | Tu clave de API, vk_live_… o vk_test_…. |
VETKIT_API_URL | No | URL base de la API. Valor predeterminado: https://api.vetkit.dev. Debe usar HTTPS; HTTP sin cifrar solo se acepta para localhost. |
VETKIT_ORG_ID | No | Id de la organización. Cada clave de API pertenece exactamente a una organización, que se usa de forma predeterminada, así que rara vez lo necesitarás. |
VETKIT_APP_URL | No | URL de la app web que se usa en los enlaces a auditorías. Valor predeterminado: https://app.vetkit.dev. |
Herramientas
Todas las herramientas devuelven texto legible y todas, salvo vetkit_get_report, devuelven además contenido estructurado tipado. Las herramientas incluyen anotaciones MCP, por lo que los clientes pueden aprobar automáticamente las de solo lectura. Ninguna herramienta elimina nada.
vetkit_list_repos
Lista los repositorios conectados a tu organización, con la calificación y la puntuación de la última auditoría.solo lecturaÁmbitos: repos:read
limitnumber- Tamaño de página, 1–100. Valor predeterminado: 25.
cursorstring- El valor de nextCursor de la página anterior.
| Argumento | Tipo | Descripción |
|---|---|---|
limit | number | Tamaño de página, 1–100. Valor predeterminado: 25. |
cursor | string | El valor de nextCursor de la página anterior. |
{ "limit": 10 }vetkit_connect_repo
Conecta un repositorio de GitHub, Bitbucket Cloud o GitLab.com. En GitHub, si el propietario aún no tiene instalada la GitHub App de vetkit, devuelve el resultado "installation_required" con una URL de instalación. Los repositorios privados de Bitbucket y GitLab requieren un token de acceso, que vetkit guarda para futuras auditorías.escrituraÁmbitos: repos:write
urlstringobligatorio- URL de un repositorio de GitHub, Bitbucket Cloud o GitLab.com, o "owner/name" para GitHub.
accessTokenstring- Token de acceso al repositorio opcional; obligatorio para repositorios privados de Bitbucket o GitLab. Se envía a vetkit y se guarda para futuras auditorías.
| Argumento | Tipo | Descripción |
|---|---|---|
urlobligatorio | string | URL de un repositorio de GitHub, Bitbucket Cloud o GitLab.com, o "owner/name" para GitHub. |
accessToken | string | Token de acceso al repositorio opcional; obligatorio para repositorios privados de Bitbucket o GitLab. Se envía a vetkit y se guarda para futuras auditorías. |
{ "url": "https://github.com/acme/payments-api" }vetkit_run_audit
Inicia una auditoría y, de forma predeterminada, espera a que termine mientras envía notificaciones de progreso. Si hace falta, primero conecta el repositorio. Devuelve la calificación global, la calificación de cada suite ejecutada, la puntuación y los recuentos de hallazgos. Esta herramienta no acepta tokens de acceso. Conecta primero los repositorios privados de Bitbucket o GitLab con vetkit_connect_repo y accessToken.escrituraÁmbitos: repos:read, audits:read, audits:run o audits:write (+ repos:write para conectar automáticamente)
repostringobligatorio- Id. del repositorio, "owner/name" para GitHub o una URL de GitHub, Bitbucket Cloud o GitLab.com. Las URL de GitHub pueden incluir /tree/<branch>.
mode"QUICK" | "FULL"- "QUICK" ejecuta un Quick Scan gratuito (10 al mes por propietario del espacio de trabajo: posture, gitleaks y osv sobre el último commit de la rama predeterminada). "FULL" ejecuta un análisis completo por 1 crédito, que se cobra al propietario del espacio de trabajo. Por defecto es "QUICK", o "FULL" si se indican ref, suites o analyzers.
refstring- Rama, etiqueta o SHA de commit. De forma predeterminada, la ref de la URL y, si no hay ninguna, la rama predeterminada.
suitesstring[]- Elige entre "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Ejecuta las comprobaciones disponibles y activadas por defecto de las suites seleccionadas; seleccionar privacy o git-history explícitamente incluye sus comprobaciones opcionales disponibles. Usa analyzers para una selección exacta. Por defecto se usa la configuración del repositorio.
analyzersstring[]- Comprobaciones exactas que se ejecutan, por id (consulta Comprobaciones más abajo); tiene prioridad sobre suites. Al menos una comprobación distinta de ai-signal.
excludeAssetsboolean- No descargar imágenes, vídeo, audio, modelos 3D, fuentes tipográficas, archivos de diseño ni PDF. Valor predeterminado: la configuración del repositorio.
waitboolean- Esperar a un estado final. Valor predeterminado: true.
timeoutSecondsnumber- Tiempo máximo de espera, 10–1800. Valor predeterminado: 600. La auditoría sigue en curso aunque se agote el tiempo.
| Argumento | Tipo | Descripción |
|---|---|---|
repoobligatorio | string | Id. del repositorio, "owner/name" para GitHub o una URL de GitHub, Bitbucket Cloud o GitLab.com. Las URL de GitHub pueden incluir /tree/<branch>. |
mode | "QUICK" | "FULL" | "QUICK" ejecuta un Quick Scan gratuito (10 al mes por propietario del espacio de trabajo: posture, gitleaks y osv sobre el último commit de la rama predeterminada). "FULL" ejecuta un análisis completo por 1 crédito, que se cobra al propietario del espacio de trabajo. Por defecto es "QUICK", o "FULL" si se indican ref, suites o analyzers. |
ref | string | Rama, etiqueta o SHA de commit. De forma predeterminada, la ref de la URL y, si no hay ninguna, la rama predeterminada. |
suites | string[] | Elige entre "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Ejecuta las comprobaciones disponibles y activadas por defecto de las suites seleccionadas; seleccionar privacy o git-history explícitamente incluye sus comprobaciones opcionales disponibles. Usa analyzers para una selección exacta. Por defecto se usa la configuración del repositorio. |
analyzers | string[] | Comprobaciones exactas que se ejecutan, por id (consulta Comprobaciones más abajo); tiene prioridad sobre suites. Al menos una comprobación distinta de ai-signal. |
excludeAssets | boolean | No descargar imágenes, vídeo, audio, modelos 3D, fuentes tipográficas, archivos de diseño ni PDF. Valor predeterminado: la configuración del repositorio. |
wait | boolean | Esperar a un estado final. Valor predeterminado: true. |
timeoutSeconds | number | Tiempo máximo de espera, 10–1800. Valor predeterminado: 600. La auditoría sigue en curso aunque se agote el tiempo. |
{ "repo": "acme/payments-api", "ref": "main", "suites": ["security"] }vetkit_list_checks
Lista todas las comprobaciones agrupadas por suite, con la herramienta y la versión que usan, si están disponibles en el servidor y cuáles se ejecutan de forma predeterminada.solo lecturaÁmbitos: audits:read
Sin argumentos.
| Argumento | Tipo | Descripción |
|---|---|---|
| Sin argumentos. | ||
{}vetkit_get_audit
Devuelve el estado, las calificaciones global y por suite, la puntuación, los recuentos de hallazgos y el progreso de cada comprobación —incluidas métricas como la proporción de código duplicado, la complejidad media, la relación entre pruebas y código y el bus factor— de una auditoría.solo lecturaÁmbitos: audits:read
auditIduuidobligatorio- El id de auditoría que devuelve vetkit_run_audit.
| Argumento | Tipo | Descripción |
|---|---|---|
auditIdobligatorio | uuid | El id de auditoría que devuelve vetkit_run_audit. |
{ "auditId": "0192f3a4-5b6c-7d8e-9f01-23456789abcd" }vetkit_list_findings
Lista los hallazgos de una auditoría, de mayor a menor severidad. Devuelve una tabla compacta como texto y los detalles completos —mensaje, fragmento enmascarado, corrección, referencias— como contenido estructurado.solo lecturaÁmbitos: findings:read
auditIduuidobligatorio- La auditoría que se va a leer.
severitystring[]- CRITICAL, HIGH, MEDIUM, LOW o INFO.
suitestring- SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY o GIT_HISTORY: solo los hallazgos de esa suite.
categorystring[]- SECURITY, SECRETS, DEPENDENCIES, INFRASTRUCTURE, QUALITY, MAINTAINABILITY, DUPLICATION, TESTING, DOCUMENTATION, HYGIENE, LICENSES, DEPENDENCY_HEALTH, ACTIVITY, HALLUCINATION, UNFINISHED_CODE, VIBE_STACK, LLM_SECURITY, RESILIENCE, DATABASE, OPERABILITY, WEB_ASSETS, AI_SIGNAL, PRIVACY_EXPOSURE, PRIVACY_FLOWS o PRIVACY_LIFECYCLE.
statusstring- NEW (aparecido desde la auditoría anterior) o EXISTING.
limitnumber- Tamaño de página, 1–100. Valor predeterminado: 25.
cursorstring- El valor de nextCursor de la página anterior.
| Argumento | Tipo | Descripción |
|---|---|---|
auditIdobligatorio | uuid | La auditoría que se va a leer. |
severity | string[] | CRITICAL, HIGH, MEDIUM, LOW o INFO. |
suite | string | SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY o GIT_HISTORY: solo los hallazgos de esa suite. |
category | string[] | SECURITY, SECRETS, DEPENDENCIES, INFRASTRUCTURE, QUALITY, MAINTAINABILITY, DUPLICATION, TESTING, DOCUMENTATION, HYGIENE, LICENSES, DEPENDENCY_HEALTH, ACTIVITY, HALLUCINATION, UNFINISHED_CODE, VIBE_STACK, LLM_SECURITY, RESILIENCE, DATABASE, OPERABILITY, WEB_ASSETS, AI_SIGNAL, PRIVACY_EXPOSURE, PRIVACY_FLOWS o PRIVACY_LIFECYCLE. |
status | string | NEW (aparecido desde la auditoría anterior) o EXISTING. |
limit | number | Tamaño de página, 1–100. Valor predeterminado: 25. |
cursor | string | El valor de nextCursor de la página anterior. |
{ "auditId": "0192f3a4-…", "severity": ["CRITICAL", "HIGH"] }vetkit_suggest_fix
Propone un parche mínimo para un hallazgo de código (SAST, secretos, app LLM, IaC) con el proveedor de IA que tu organización guardó en vetkit, o con una corrección basada en reglas cuando el analizador la proporciona. Devuelve un diff unificado, una explicación, un nivel de confianza y un estado de verificación. Al proveedor solo se envía una ventana redactada de unas 60 líneas. No se escribe nada: ni rama, ni commit, ni pull request. Requiere una clave creada por un administrador de la organización.solo lecturaÁmbitos: findings:write
findingIduuidobligatorio- Id de un hallazgo de código, de vetkit_list_findings.
providerstring- Proveedor de IA guardado que se usará. Por defecto, la primera conexión verificada.
| Argumento | Tipo | Descripción |
|---|---|---|
findingIdobligatorio | uuid | Id de un hallazgo de código, de vetkit_list_findings. |
provider | string | Proveedor de IA guardado que se usará. Por defecto, la primera conexión verificada. |
{ "findingId": "0193b2c4-…" }vetkit_triage_findings
Pregunta al proveedor de IA guardado de tu organización si hasta 20 hallazgos de una auditoría son probablemente verdaderos o falsos positivos. Cada uno recibe un veredicto, una confianza y una breve justificación que cita una línea del código fuente. Los veredictos son orientativos: ajustan la prioridad, pero nunca suprimen un hallazgo ni cambian la puntuación. Requiere un plan de pago.escrituraÁmbitos: findings:write
auditIduuidobligatorio- La auditoría a la que pertenecen los hallazgos.
findingIdsuuid[]obligatorio- Hasta 20 ids de hallazgos de vetkit_list_findings.
| Argumento | Tipo | Descripción |
|---|---|---|
auditIdobligatorio | uuid | La auditoría a la que pertenecen los hallazgos. |
findingIdsobligatorio | uuid[] | Hasta 20 ids de hallazgos de vetkit_list_findings. |
{ "auditId": "0192f3a4-…", "findingIds": ["0193b2c4-…"] }vetkit_get_report
Devuelve el informe de una auditoría finalizada: Markdown legible, un resumen JSON con las puntuaciones por suite y por categoría y la comparación con la auditoría anterior, o SARIF 2.1.0.solo lecturaÁmbitos: reports:read
auditIduuidobligatorio- La auditoría que se va a leer.
formatstring- markdown (predeterminado), json o sarif.
maxCharsnumber- Trunca la salida a partir de este número de caracteres, 2000–500 000. Valor predeterminado: 40 000.
| Argumento | Tipo | Descripción |
|---|---|---|
auditIdobligatorio | uuid | La auditoría que se va a leer. |
format | string | markdown (predeterminado), json o sarif. |
maxChars | number | Trunca la salida a partir de este número de caracteres, 2000–500 000. Valor predeterminado: 40 000. |
{ "auditId": "0192f3a4-…", "format": "markdown" }vetkit_get_standards_report
Asigna los hallazgos abiertos de una auditoría a OWASP Top 10 (2021 o 2025), CWE Top 25 (2024) u OWASP Top 10 for LLM Applications (2025). Cada categoría queda como fail, pass (sin hallazgos asignados de comprobaciones que puedan detectarla) o not covered. Es una ayuda de correspondencia, no una certificación de cumplimiento.solo lecturaÁmbitos: reports:read, findings:read
auditIduuidobligatorio- La auditoría que se asignará.
standardstringobligatorio- owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 u owasp-llm-top10-2025.
| Argumento | Tipo | Descripción |
|---|---|---|
auditIdobligatorio | uuid | La auditoría que se asignará. |
standardobligatorio | string | owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 u owasp-llm-top10-2025. |
{ "auditId": "0192f3a4-…", "standard": "owasp-top10-2021" }vetkit_check_packages
Llámalo antes de instalar una dependencia. Comprueba hasta 50 paquetes de un ecosistema contra el registro público, los avisos de OSV (incluidos paquetes maliciosos conocidos), CISA KEV y la política de tu organización, y devuelve allow, warn o block con los motivos.solo lecturaÁmbitos: agent:check
ecosystemstringobligatorio- npm, pypi, cargo, go, rubygems, nuget o maven. Usa pypi para pip y uv.
packagesobject[]obligatorio- Hasta 50 paquetes: un nombre (en Maven group:artifact, en Go la ruta del módulo) y, opcionalmente, una versión exacta.
| Argumento | Tipo | Descripción |
|---|---|---|
ecosystemobligatorio | string | npm, pypi, cargo, go, rubygems, nuget o maven. Usa pypi para pip y uv. |
packagesobligatorio | object[] | Hasta 50 paquetes: un nombre (en Maven group:artifact, en Go la ruta del módulo) y, opcionalmente, una versión exacta. |
{ "ecosystem": "npm", "packages": [{ "name": "left-pad", "version": "1.3.0" }] }vetkit_scan_changes
Llámalo antes de hacer commit. Analiza en memoria hasta 30 archivos modificados (512 KB en total) en busca de secretos con formato exacto, configuración de agentes arriesgada e instrucciones ocultas, código sin terminar e importaciones de paquetes que no existen. No se guarda ni se ejecuta nada.solo lecturaÁmbitos: agent:check
filesobject[]obligatorio- Archivos modificados: una ruta relativa al repositorio, como src/app.ts, y el contenido UTF-8 completo.
| Argumento | Tipo | Descripción |
|---|---|---|
filesobligatorio | object[] | Archivos modificados: una ruta relativa al repositorio, como src/app.ts, y el contenido UTF-8 completo. |
{ "files": [{ "path": "src/config.ts", "content": "…" }] }Salvaguardas para agentes
Dos herramientas permiten que un agente de programación revise su trabajo antes de actuar: vetkit_check_packages antes de instalar una dependencia y vetkit_scan_changes antes de hacer commit. Ambas necesitan una clave de API con el scope agent:check.
Ambas devuelven un veredicto allow, warn o block con los motivos. Block: el paquete no existe (un nombre alucinado o de slopsquatting), tiene un registro de paquete malicioso conocido en OSV, tiene un aviso de CISA KEV cuando tu política bloquea vulnerabilidades explotadas conocidas, usa una licencia de la lista de denegación de tu organización, o el cambio contiene un secreto incluido en el código. Warn: una versión no publicada, una versión muy reciente, poca adopción, un aviso igual o superior a la severidad mínima de tu política u otros hallazgos de código. Las fuentes inaccesibles aparecen como advertencias; esas comprobaciones se omiten, nunca se suponen.
Hook de Claude Code
vetkit-mcp hook pre-tool-use lee la entrada PreToolUse de Claude Code, detecta instalaciones de paquetes en comandos Bash y sale con el código 2 cuando vetkit bloquea un paquete, de modo que Claude Code detiene el comando y muestra el motivo. En caso contrario sale con 0 e imprime las advertencias que haya. Ante errores no bloquea: sin VETKIT_API_KEY, o si no se puede acceder a la API, avisa y deja que el comando se ejecute. Añádelo a .claude/settings.json:
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "npx -y @vetkit/mcp hook pre-tool-use", "timeout": 30 } ] } ] }}Define VETKIT_API_KEY en tu shell con una clave que tenga el scope agent:check, no en un archivo que se suba al repositorio.
Cursor y otros clientes
vetkit_check_packages antes de instalar y a vetkit_scan_changes antes de hacer commit. La página MCP de la app de vetkit incluye una regla de Cursor lista para usar.Comprobaciones
Hay cinco suites puntuadas, además de las suites opcionales Privacidad y protección de datos (beta) e Historial de Git, que no afectan a la calificación. Cada suite puntuada tiene su propia calificación, y la puntuación global pondera Seguridad al 43%, Calidad del código al 18%, Sostenibilidad al 11%, Riesgos de IA en el código al 13% y Preparación para producción al 15%. Solo cuentan las suites que se ejecutaron, y sus pesos se reparten entre ellas (Seguridad 50%, Calidad del código 22%, Sostenibilidad 13% y Riesgos de IA en el código 15% sin Preparación para producción; Seguridad 70% y Calidad del código 30% cuando solo se ejecutan esas dos). Pasa ids de comprobaciones en analyzers o una suite en suites.
Seguridad
- Id de comprobación:
postureArchivos .env, claves privadas y almacenes de claves incluidos en el repositorio, manifiestos sin lockfile y ausencia de política de seguridad.Categoría: SECRETS, DEPENDENCIES, SECURITY - Id de comprobación:
gitleaksClaves de API, tokens, contraseñas y claves privadas en el código fuente.Categoría: SECRETS - Id de comprobación:
secrets-historyCredenciales incluidas en un commit y eliminadas después que aún se pueden recuperar del historial de git. Opcional.Categoría: SECRETS - Id de comprobación:
osvCVE conocidos, paquetes maliciosos y avisos de vulnerabilidades explotadas activamente (CISA KEV) en las dependencias fijadas.Categoría: DEPENDENCIES - Id de comprobación:
vendoredBibliotecas de JavaScript con vulnerabilidades conocidas copiadas en el repositorio.Categoría: DEPENDENCIES - Id de comprobación:
eolEntornos de ejecución, frameworks e imágenes base de contenedores sin soporte.Categoría: DEPENDENCIES - Id de comprobación:
supply-chainInyección en lockfiles, registros inseguros, scripts de instalación de riesgo, Trojan Source y ejecutables incluidos en el repositorio.Categoría: DEPENDENCIES, SECURITY - Id de comprobación:
sastReglas de seguridad de código seleccionadas para los lenguajes compatibles, además de configuración insegura de servidor, móvil y shell.Categoría: SECURITY - Id de comprobación:
sast-communityPaquetes de reglas adicionales de la comunidad con licencias permisivas. Opcional, beta.Categoría: SECURITY - Id de comprobación:
iacErrores de configuración en Terraform, CloudFormation, Kubernetes, Helm y Dockerfiles (Trivy).Categoría: INFRASTRUCTURE - Id de comprobación:
workflowsInyección de scripts en GitHub Actions, permisos demasiado amplios, actions sin versión fijada y pwn requests (zizmor).Categoría: INFRASTRUCTURE
Calidad del código
- Id de comprobación:
code-smellsErrores ignorados, instrucciones de depuración olvidadas, comparaciones sospechosas y otro código propenso a errores.Categoría: QUALITY - Id de comprobación:
complexityFunciones con alta complejidad ciclomática, anidamiento profundo, cuerpos largos o listas de parámetros largas.Categoría: MAINTAINABILITY - Id de comprobación:
duplicationBloques de código copiados y pegados entre archivos.Categoría: DUPLICATION - Id de comprobación:
testsConjuntos de pruebas inexistentes o escasos, archivos grandes sin probar, pruebas focalizadas u omitidas, pruebas sin aserciones y CI que nunca ejecuta las pruebas.Categoría: TESTING - Id de comprobación:
docsREADME sin instrucciones de instalación o uso, API públicas sin documentar y paquetes publicados sin registro de cambios.Categoría: DOCUMENTATION - Id de comprobación:
hygieneREADME, LICENSE, CI y .gitignore; resultados de compilación, dependencias copiadas y archivos grandes incluidos en el repositorio.Categoría: HYGIENE
Sostenibilidad
- Id de comprobación:
licensesDependencias con licencias copyleft (GPL, AGPL), de uso restringido o desconocidas que entran en conflicto con la licencia del proyecto.Categoría: LICENSES - Id de comprobación:
dep-healthDependencias directas obsoletas, con dos o más versiones mayores de retraso o que ya no publican versiones.Categoría: DEPENDENCY_HEALTH - Id de comprobación:
activityRepositorios inactivos, riesgo de mantenedor único (bus factor) y archivos grandes que cambian con frecuencia.Categoría: ACTIVITY
Riesgos de IA en el código
- Id de comprobación:
hallucinated-depsDependencias e importaciones que no existen en el registro público (objetivos de slopsquatting), versiones que nunca se publicaron, paquetes publicados por primera vez en los últimos 30 días e importaciones que no figuran en package.json.Categoría: HALLUCINATION - Id de comprobación:
ai-slopStubs, marcadores del tipo “resto del código”, datos ficticios y credenciales de ejemplo en rutas de producción, archivos duplicados con sufijo de copia y desactivaciones generalizadas de la comprobación de tipos o del lint.Categoría: UNFINISHED_CODE - Id de comprobación:
vibe-stackTablas de Supabase sin seguridad a nivel de fila, secretos en variables de entorno públicas, rutas de API sin autenticación y controles de acceso que solo se hacen en el cliente.Categoría: VIBE_STACK - Id de comprobación:
llm-appVías de inyección de prompts, salidas del LLM que llegan a la ejecución de código, SQL o HTML, claves de API de LLM en el código del cliente, llamadas al modelo sin límites y configuración de riesgo de agentes de IA.Categoría: LLM_SECURITY - Id de comprobación:
ai-signalSeñal heurística de autoría por IA. Beta, informativa y nunca puntúa; solo si está habilitada en el servidor.Categoría: AI_SIGNAL
Preparación para producción
- Id de comprobación:
resilienceLlamadas HTTP salientes sin timeout, llamadas bloqueantes en la ruta de la petición y en funciones async, clientes de base de datos creados en cada petición.Categoría: RESILIENCE - Id de comprobación:
data-accessConsultas dentro de bucles (N+1), endpoints de listado sin paginación, claves foráneas sin índice, sincronización del esquema al arrancar que puede borrar datos.Categoría: DATABASE - Id de comprobación:
operabilityServicios desplegados que ejecutan un servidor de desarrollo, verifican contraseñas sin límite de solicitudes en el inicio de sesión o no tienen apagado ordenado, health check ni seguimiento de errores.Categoría: OPERABILITY
Auditorías de larga duración
La mayoría de las auditorías terminan en pocos minutos. vetkit_run_audit consulta el estado cada pocos segundos y envía notificaciones de progreso mientras espera. Algunos clientes cancelan las llamadas a herramientas tras un tiempo fijo; Claude Code, por ejemplo, respeta MCP_TOOL_TIMEOUT. Si el tuyo lo hace, pasa "wait": false y consulta el estado con vetkit_get_audit. Cuando se agota timeoutSeconds, la auditoría sigue en curso y la herramienta devuelve "outcome": "still_running".
Errores
Los errores de la API se devuelven como resultados de herramienta con isError: true e incluyen el estado HTTP, el código de error de vetkit, el mensaje, el id de solicitud y una sugerencia.
401 API_KEY_INVALID,API_KEY_REVOKED,API_KEY_EXPIRED— crea o rota una clave, actualizaVETKIT_API_KEYy reinicia el servidor.403 INSUFFICIENT_SCOPE— a la clave le falta un ámbito que la herramienta necesita.409 AUDIT_CONCURRENCY_LIMITy429 RATE_LIMITED— espera y vuelve a intentarlo; la sugerencia incluye el tiempo de espera cuando la API envíaRetry-After.402 INSUFFICIENT_CREDITS— un análisis completo necesita 1 crédito del propietario del espacio de trabajo. Solicita más créditos en la app de vetkit o ejecuta un Quick Scan gratuito de la rama predeterminada mientras dure la asignación mensual.422 ANALYZER_UNAVAILABLE— una comprobación deanalyzersno se puede ejecutar en este servidor. Llama avetkit_list_checkso pasasuites, que solo elige comprobaciones disponibles.INSTALLATION_REQUIREDse devuelve como un resultado normal con la URL de instalación de la GitHub App, no como un error.
Notas de seguridad
- Trata la clave de API como una contraseña. Da acceso a las auditorías y los hallazgos de tu organización, incluidos los de repositorios privados. Guárdala en la configuración
envde tu cliente MCP, nunca en archivos de los que hagas commit. Concede solo los ámbitos que necesites, define una fecha de expiración y revócala desde la app si se filtra. - La clave solo se envía a
VETKIT_API_URL, como encabezadoAuthorization: Bearerpor HTTPS. El servidor nunca la registra ni la incluye en los mensajes de error. - El servidor solo habla MCP a través de stdio. No abre puertos de red y solo escribe registros en stderr.
- Los fragmentos de los hallazgos se enmascaran antes de que vetkit los almacene; los valores de los secretos nunca se devuelven.
- El texto de los informes y los hallazgos procede del repositorio auditado (rutas de archivo, mensajes). Trátalo como entrada no confiable, igual que cualquier otra salida de una herramienta: un repositorio malicioso podría intentar incrustar instrucciones dirigidas a tu agente.
¿Prefieres HTTP directo? Todo lo que hace el servidor MCP está disponible a través de la API REST.