Saltar al contenido

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.

Definición de servidor stdio local
{  "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 npx en tu PATH.
  • 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

  1. 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.
  2. Ponle a la clave un nombre que indique dónde se va a usar, por ejemplo “MCP — portátil”.
  3. Para ejecutar auditorías de repositorios, selecciona repos:read, audits:read y audits:run (o audits:write). Añade repos:write para conectar repositorios, findings:read para leer hallazgos y reports:read para leer informes. Iniciar o cancelar evaluaciones de IA requiere audits:write. Para un agente de solo lectura, selecciona únicamente ámbitos de lectura.
  4. Opcionalmente, define una fecha de expiración y un límite de solicitudes por minuto (60 de forma predeterminada, hasta 600).
  5. Copia el secreto. Tiene el formato vk_live_… y se muestra una sola vez; vetkit solo almacena un hash.

Rotación y revocación

Al rotar una clave se emite un secreto nuevo y el anterior sigue siendo válido durante 24 horas para que puedas desplegar el nuevo. La revocación tiene efecto inmediato: la siguiente solicitud devuelve 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.

~/.cursor/mcp.json
{  "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.

.vscode/mcp.json
{  "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.

~/.codex/config.toml
[mcp_servers.vetkit]command = "npx"args = ["-y", "@vetkit/mcp"] [mcp_servers.vetkit.env]VETKIT_API_KEY = "<your-api-key>"

Claude Code

Terminal
claude mcp add --transport stdio vetkit -e 'VETKIT_API_KEY=<your-api-key>' -- npx -y @vetkit/mcp

Añ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:

claude_desktop_config.json
{  "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.

Instalación global
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcp

Configuración

El servidor se configura por completo mediante variables de entorno.

VariableObligatoriaDescripción
VETKIT_API_KEYSíTu clave de API, vk_live_… o vk_test_….
VETKIT_API_URLNoURL base de la API. Valor predeterminado: https://api.vetkit.dev. Debe usar HTTPS; HTTP sin cifrar solo se acepta para localhost.
VETKIT_ORG_IDNoId 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_URLNoURL 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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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.

Argumentos de ejemplo
{}

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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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.
Argumentos de ejemplo
{ "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:

.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

El hook solo comprueba instalaciones de paquetes. Para analizar cambios, y en Cursor u otros clientes sin hooks, añade una regla que indique al agente llamar a 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, actualiza VETKIT_API_KEY y reinicia el servidor.
  • 403 INSUFFICIENT_SCOPE — a la clave le falta un ámbito que la herramienta necesita.
  • 409 AUDIT_CONCURRENCY_LIMIT y 429 RATE_LIMITED — espera y vuelve a intentarlo; la sugerencia incluye el tiempo de espera cuando la API envía Retry-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 de analyzers no se puede ejecutar en este servidor. Llama a vetkit_list_checks o pasa suites, que solo elige comprobaciones disponibles.
  • INSTALLATION_REQUIRED se 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 env de 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 encabezado Authorization: Bearer por 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.

Solicita acceso anticipado

Cuéntanos un poco sobre tu equipo y los repositorios que quieres auditar. Incorporamos equipos en pequeños grupos y te responderemos por correo electrónico.

Solo usamos estos datos para responder a tu solicitud. Política de privacidad