Aller au contenu

Doc · MCP

Serveur MCP vetkit

Dotez votre agent de code d’un auditeur de code. Le serveur MCP vetkit permet à tout client Model Context Protocol compatible avec stdio de connecter des dépôts, de lancer des audits et de consulter constats et rapports.

MCP est un standard ouvert, pas une intégration réservée à Claude. Configurez un serveur stdio local nommé vetkit avec la définition ci-dessous, puis suivez les instructions de votre client. La structure de configuration varie. Les clients qui n’acceptent que des serveurs HTTP/SSE distants ne peuvent pas se connecter directement ; vetkit ne fournit pas de point de connexion MCP distant.

Définition de serveur stdio local
{  "command": "npx",  "args": [    "-y",    "@vetkit/mcp"  ],  "env": {    "VETKIT_API_KEY": "<your-api-key>"  }}

Demandez ensuite à votre agent quelque chose comme « Auditez acme/payments-api et dites-moi ce qu’il faut corriger en priorité. » Rechargez votre client et vérifiez que vetkit_list_repos apparaît dans sa liste d’outils.

Prérequis

  • Node.js 20.3 ou version ultérieure, avec npx dans votre PATH.
  • Un compte vetkit et un accès aux dépôts GitHub, Bitbucket Cloud ou GitLab.com que vous souhaitez auditer.
  • Une clé d’API vetkit (étape suivante).

Créer une clé d’API

  1. Ouvrez Paramètres de l’espace de travail → Clés d’API dans l’application vetkit. Seuls les propriétaires et les administrateurs de l’organisation peuvent gérer les clés.
  2. Nommez la clé d’après l’endroit où elle sera utilisée, par exemple « MCP — portable ».
  3. Pour lancer des audits de dépôts, sélectionnez repos:read, audits:read et audits:run (ou audits:write). Ajoutez repos:write pour connecter des dépôts, findings:read pour lire les résultats et reports:read pour lire les rapports. Le lancement ou l’annulation d’évaluations IA nécessite audits:write. Pour un agent en lecture seule, sélectionnez uniquement des portées de lecture.
  4. Définissez éventuellement une date d’expiration et une limite de débit par minute (60 par défaut, jusqu’à 600).
  5. Copiez le secret. Il ressemble à vk_live_… et n’est affiché qu’une seule fois ; vetkit n’en stocke qu’un hachage.

Rotation et révocation

Renouveler une clé émet un nouveau secret et maintient l’ancien valide pendant 24 heures, le temps de déployer le nouveau. La révocation prend effet immédiatement — la requête suivante renvoie 401 API_KEY_REVOKED.

Installation

Cursor

Ajoutez l’entrée vetkit ci-dessous à ~/.cursor/mcp.json (global) ou à .cursor/mcp.json dans un projet. Ne commitez pas une configuration de projet qui contient votre clé.

~/.cursor/mcp.json
{  "mcpServers": {    "vetkit": {      "command": "npx",      "args": [        "-y",        "@vetkit/mcp"      ],      "env": {        "VETKIT_API_KEY": "<your-api-key>"      }    }  }}

VS Code / GitHub Copilot

Ajoutez cette entrée à .vscode/mcp.json en conservant les serveurs existants. VS Code / GitHub Copilot utilise servers, pas mcpServers. Démarrez et autorisez vetkit dans la liste des serveurs MCP. Remplacez le paramètre fictif de la clé et ne commitez jamais une configuration contenant votre secret.

.vscode/mcp.json
{  "servers": {    "vetkit": {      "type": "stdio",      "command": "npx",      "args": [        "-y",        "@vetkit/mcp"      ],      "env": {        "VETKIT_API_KEY": "<your-api-key>"      }    }  }}

Codex

Ajoutez ces sections TOML à ~/.codex/config.toml sans remplacer les réglages existants. Codex CLI et l’extension IDE partagent cette configuration. Remplacez le paramètre fictif de la clé, redémarrez le client et vérifiez avec codex mcp list. Gardez ce fichier privé.

~/.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

Ajoutez --scope user pour rendre vetkit disponible dans tous vos projets, et pas seulement dans le projet courant.

Claude Desktop

Ouvrez Settings → Developer → Edit Config et ajoutez vetkit à claude_desktop_config.json, puis redémarrez Claude Desktop :

claude_desktop_config.json
{  "mcpServers": {    "vetkit": {      "command": "npx",      "args": [        "-y",        "@vetkit/mcp"      ],      "env": {        "VETKIT_API_KEY": "<your-api-key>"      }    }  }}

Autres clients MCP

Tout client capable de lancer un serveur stdio convient : exécutez npx -y @vetkit/mcp avec VETKIT_API_KEY dans son environnement. Vous pouvez aussi installer le paquet globalement et exécuter directement le binaire vetkit-mcp.

Installation globale
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcp

Configuration

Le serveur se configure entièrement par des variables d’environnement.

VariableObligatoireDescription
VETKIT_API_KEYOuiVotre clé d’API, vk_live_… ou vk_test_….
VETKIT_API_URLNonURL de base de l’API. Par défaut https://api.vetkit.dev. HTTPS obligatoire ; le HTTP simple n’est accepté que pour localhost.
VETKIT_ORG_IDNonIdentifiant de l’organisation. Chaque clé d’API appartient à exactement une organisation, utilisée par défaut : vous en aurez donc rarement besoin.
VETKIT_APP_URLNonURL de l’application web utilisée pour les liens vers les audits. Par défaut https://app.vetkit.dev.

Outils

Chaque outil renvoie du texte lisible, et tous les outils sauf vetkit_get_report renvoient aussi un contenu structuré typé. Les outils portent des annotations MCP, ce qui permet aux clients d’approuver automatiquement ceux en lecture seule. Aucun outil ne supprime quoi que ce soit.

vetkit_list_repos

Liste les dépôts connectés à votre organisation, avec la note et le score du dernier audit.lecture seulePortées : repos:read
limitnumber
Taille de page, 1–100. 25 par défaut.
cursorstring
La valeur nextCursor de la page précédente.
Exemple d’arguments
{ "limit": 10 }

vetkit_connect_repo

Connecte un dépôt GitHub, Bitbucket Cloud ou GitLab.com. Pour GitHub, si le propriétaire n’a pas encore installé la GitHub App de vetkit, renvoie le résultat "installation_required" avec une URL d’installation. Les dépôts privés Bitbucket et GitLab nécessitent un jeton d’accès, que vetkit conserve pour les audits suivants.écriturePortées : repos:write
urlstringobligatoire
URL d’un dépôt GitHub, Bitbucket Cloud ou GitLab.com, ou "owner/name" pour GitHub.
accessTokenstring
Jeton d’accès au dépôt facultatif ; obligatoire pour les dépôts privés Bitbucket ou GitLab. Il est envoyé à vetkit et conservé pour les audits suivants.
Exemple d’arguments
{ "url": "https://github.com/acme/payments-api" }

vetkit_run_audit

Lance un audit et, par défaut, attend qu’il se termine en envoyant des notifications de progression. Connecte d’abord le dépôt si nécessaire. Renvoie la note globale, la note de chaque suite exécutée, le score et le nombre de constats. Cet outil n’accepte pas de jeton d’accès. Connectez d’abord les dépôts privés Bitbucket ou GitLab avec vetkit_connect_repo et accessToken.écriturePortées : repos:read, audits:read, audits:run ou audits:write (+ repos:write pour la connexion automatique)
repostringobligatoire
Identifiant du dépôt, "owner/name" pour GitHub ou URL GitHub, Bitbucket Cloud ou GitLab.com. Les URL GitHub peuvent inclure /tree/<branch>.
mode"QUICK" | "FULL"
« QUICK » lance un Quick Scan gratuit (10 par mois par propriétaire d’espace de travail : posture, gitleaks et osv sur le dernier commit de la branche par défaut). « FULL » lance une analyse complète pour 1 crédit, facturé au propriétaire de l’espace de travail. Par défaut « QUICK », ou « FULL » si ref, suites ou analyzers sont fournis.
refstring
Branche, tag ou SHA de commit. Par défaut, la référence indiquée dans l’URL, sinon la branche par défaut.
suitesstring[]
Choisissez parmi "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Exécute les contrôles disponibles et activés par défaut des suites sélectionnées ; choisir explicitement privacy ou git-history inclut aussi leurs contrôles optionnels disponibles. Utilisez analyzers pour une sélection précise. Par défaut, le réglage du dépôt est utilisé.
analyzersstring[]
Contrôles précis à exécuter, par identifiant (voir Contrôles ci-dessous) ; prévaut sur suites. Au moins un contrôle autre que ai-signal.
excludeAssetsboolean
Ne pas télécharger les images, vidéos, fichiers audio, modèles 3D, polices, fichiers de design et PDF. Par défaut, le réglage du dépôt.
waitboolean
Attendre un statut final. true par défaut.
timeoutSecondsnumber
Attente maximale, 10–1800. 600 par défaut. L’audit continue après l’expiration du délai.
Exemple d’arguments
{ "repo": "acme/payments-api", "ref": "main", "suites": ["security"] }

vetkit_list_checks

Liste tous les contrôles regroupés par suite, avec l’outil et la version utilisés, leur disponibilité sur le serveur et les contrôles exécutés par défaut.lecture seulePortées : audits:read

Aucun argument.

Exemple d’arguments
{}

vetkit_get_audit

Renvoie, pour un audit, le statut, la note globale et par suite, le score, le nombre de constats et la progression de chaque contrôle — y compris des métriques comme la part de code dupliqué, la complexité moyenne, le ratio tests/code et le bus factor.lecture seulePortées : audits:read
auditIduuidobligatoire
L’identifiant d’audit renvoyé par vetkit_run_audit.
Exemple d’arguments
{ "auditId": "0192f3a4-5b6c-7d8e-9f01-23456789abcd" }

vetkit_list_findings

Liste les constats d’un audit, du plus grave au moins grave. Renvoie un tableau compact sous forme de texte et tous les détails — message, extrait masqué, correction, références — sous forme de contenu structuré.lecture seulePortées : findings:read
auditIduuidobligatoire
L’audit à consulter.
severitystring[]
CRITICAL, HIGH, MEDIUM, LOW ou INFO.
suitestring
SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY ou GIT_HISTORY : uniquement les constats de cette 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 ou PRIVACY_LIFECYCLE.
statusstring
NEW (apparu depuis l’audit précédent) ou EXISTING.
limitnumber
Taille de page, 1–100. 25 par défaut.
cursorstring
La valeur nextCursor de la page précédente.
Exemple d’arguments
{ "auditId": "0192f3a4-…", "severity": ["CRITICAL", "HIGH"] }

vetkit_suggest_fix

Propose un correctif minimal pour un résultat de code (SAST, secrets, application LLM, IaC) avec le fournisseur d’IA enregistré par votre organisation dans vetkit, ou un correctif fourni par une règle lorsque l’analyseur en propose un. Renvoie un diff unifié, une explication, un niveau de confiance et un statut de vérification. Seule une fenêtre masquée d’environ 60 lignes est envoyée au fournisseur. Rien n’est écrit : ni branche, ni commit, ni pull request. Nécessite une clé créée par un administrateur de l’organisation.lecture seulePortées : findings:write
findingIduuidobligatoire
Id d’un résultat de code, issu de vetkit_list_findings.
providerstring
Fournisseur d’IA enregistré à utiliser. Par défaut, la première connexion vérifiée.
Exemple d’arguments
{ "findingId": "0193b2c4-…" }

vetkit_triage_findings

Demande au fournisseur d’IA enregistré de votre organisation si jusqu’à 20 résultats d’un audit sont probablement de vrais ou de faux positifs. Chacun reçoit un verdict, une confiance et une courte justification qui cite une ligne du code source. Les verdicts sont indicatifs : ils ajustent la priorité mais ne masquent jamais un résultat et ne modifient pas le score. Nécessite un forfait payant.écriturePortées : findings:write
auditIduuidobligatoire
L’audit auquel appartiennent les résultats.
findingIdsuuid[]obligatoire
Jusqu’à 20 ids de résultats issus de vetkit_list_findings.
Exemple d’arguments
{ "auditId": "0192f3a4-…", "findingIds": ["0193b2c4-…"] }

vetkit_get_report

Renvoie le rapport d’un audit terminé : Markdown lisible, synthèse JSON avec les scores par suite et par catégorie et la comparaison avec l’audit précédent, ou SARIF 2.1.0.lecture seulePortées : reports:read
auditIduuidobligatoire
L’audit à consulter.
formatstring
markdown (par défaut), json ou sarif.
maxCharsnumber
Tronquer la sortie au-delà de ce nombre de caractères, 2 000–500 000. 40 000 par défaut.
Exemple d’arguments
{ "auditId": "0192f3a4-…", "format": "markdown" }

vetkit_get_standards_report

Rapproche les résultats ouverts d’un audit de l’OWASP Top 10 (2021 ou 2025), du CWE Top 25 (2024) ou de l’OWASP Top 10 for LLM Applications (2025). Chaque catégorie est fail, pass (aucun résultat rapproché issu de contrôles capables de la détecter) ou not covered. Une aide à la correspondance, pas une certification de conformité.lecture seulePortées : reports:read, findings:read
auditIduuidobligatoire
L’audit à rapprocher.
standardstringobligatoire
owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 ou owasp-llm-top10-2025.
Exemple d’arguments
{ "auditId": "0192f3a4-…", "standard": "owasp-top10-2021" }

vetkit_check_packages

À appeler avant d’installer une dépendance. Vérifie jusqu’à 50 paquets d’un écosystème auprès du registre public, des avis OSV (y compris les paquets malveillants connus), de CISA KEV et de la politique de votre organisation, et renvoie allow, warn ou block avec les raisons.lecture seulePortées : agent:check
ecosystemstringobligatoire
npm, pypi, cargo, go, rubygems, nuget ou maven. Utilisez pypi pour pip et uv.
packagesobject[]obligatoire
Jusqu’à 50 paquets : un nom (Maven group:artifact, chemin de module Go) et une version exacte facultative.
Exemple d’arguments
{ "ecosystem": "npm", "packages": [{ "name": "left-pad", "version": "1.3.0" }] }

vetkit_scan_changes

À appeler avant de committer. Analyse en mémoire jusqu’à 30 fichiers modifiés (512 Ko au total) à la recherche de secrets au format exact, de configurations d’agent risquées et d’instructions cachées, de code inachevé et d’imports de paquets inexistants. Rien n’est stocké ni exécuté.lecture seulePortées : agent:check
filesobject[]obligatoire
Fichiers modifiés : un chemin relatif au dépôt comme src/app.ts et le contenu UTF-8 complet.
Exemple d’arguments
{ "files": [{ "path": "src/config.ts", "content": "…" }] }

Garde-fous pour agents

Deux outils permettent à un agent de code de vérifier son travail avant d’agir : vetkit_check_packages avant d’installer une dépendance et vetkit_scan_changes avant de committer. Les deux nécessitent une clé d’API avec le scope agent:check.

Les deux renvoient un verdict allow, warn ou block avec les raisons. Block : le paquet n’existe pas (un nom halluciné ou de slopsquatting), possède une fiche OSV de paquet malveillant connu, fait l’objet d’un avis CISA KEV lorsque votre politique bloque les vulnérabilités exploitées connues, utilise une licence de la liste d’exclusion de votre organisation, ou la modification contient un secret committé. Warn : une version non publiée, une publication très récente, une faible adoption, un avis d’une sévérité égale ou supérieure au minimum de votre politique, ou d’autres résultats de code. Les sources injoignables sont signalées comme avertissements ; ces contrôles sont ignorés, jamais devinés.

Hook Claude Code

vetkit-mcp hook pre-tool-use lit l’entrée PreToolUse de Claude Code, repère les installations de paquets dans les commandes Bash et se termine avec le code 2 lorsque vetkit bloque un paquet : Claude Code arrête alors la commande et affiche la raison. Sinon, il se termine avec 0 et affiche les éventuels avertissements. En cas d’erreur, il ne bloque pas : sans VETKIT_API_KEY, ou si l’API est injoignable, il avertit et laisse la commande s’exécuter. Ajoutez-le à .claude/settings.json :

.claude/settings.json
{  "hooks": {    "PreToolUse": [      {        "matcher": "Bash",        "hooks": [          {            "type": "command",            "command": "npx -y @vetkit/mcp hook pre-tool-use",            "timeout": 30          }        ]      }    ]  }}

Définissez VETKIT_API_KEY dans votre shell avec une clé ayant le scope agent:check, pas dans un fichier committé.

Cursor et autres clients

Le hook ne vérifie que les installations de paquets. Pour analyser les modifications, et dans Cursor ou d’autres clients sans hooks, ajoutez une règle demandant à l’agent d’appeler vetkit_check_packages avant d’installer et vetkit_scan_changes avant de committer. La page MCP de l’application vetkit propose une règle Cursor prête à l’emploi.

Contrôles

Cinq suites sont notées, auxquelles s’ajoutent les suites optionnelles Confidentialité et protection des données (bêta) et Historique Git, sans effet sur la note. Chaque suite notée reçoit sa propre note, et le score global pondère Sécurité à 43 %, Qualité du code à 18 %, Pérennité à 11 %, Risques du code IA à 13 % et Prêt pour la production à 15 % — seules les suites exécutées comptent, et leurs poids sont répartis entre elles (Sécurité 50 %, Qualité du code 22 %, Pérennité 13 % et Risques du code IA 15 % sans la suite Prêt pour la production ; Sécurité 70 % et Qualité du code 30 % lorsque seules ces deux suites ont été exécutées). Passez des identifiants de contrôles dans analyzers, ou une suite dans suites.

Sécurité

  • Identifiant: postureFichiers .env, clés privées et magasins de clés commités, manifestes sans fichier de verrouillage, absence de politique de sécurité.Catégorie: SECRETS, DEPENDENCIES, SECURITY
  • Identifiant: gitleaksClés d’API, jetons, mots de passe et clés privées dans l’arborescence source.Catégorie: SECRETS
  • Identifiant: secrets-historyIdentifiants commités puis supprimés, mais encore récupérables dans l’historique git. À activer explicitement.Catégorie: SECRETS
  • Identifiant: osvCVE connues, paquets malveillants et avis de vulnérabilités activement exploitées (CISA KEV) dans les dépendances verrouillées.Catégorie: DEPENDENCIES
  • Identifiant: vendoredBibliothèques JavaScript aux vulnérabilités connues, copiées dans le dépôt.Catégorie: DEPENDENCIES
  • Identifiant: eolEnvironnements d’exécution, frameworks et images de base de conteneurs en fin de vie.Catégorie: DEPENDENCIES
  • Identifiant: supply-chainInjection dans les fichiers de verrouillage, registres non sécurisés, scripts d’installation à risque, Trojan Source et exécutables commités.Catégorie: DEPENDENCIES, SECURITY
  • Identifiant: sastRègles de sécurité du code sélectionnées pour les langages pris en charge, ainsi que les configurations serveur, mobile et shell non sûres.Catégorie: SECURITY
  • Identifiant: sast-communityPacks de règles communautaires supplémentaires, sous licence permissive. À activer explicitement, bêta.Catégorie: SECURITY
  • Identifiant: iacErreurs de configuration Terraform, CloudFormation, Kubernetes, Helm et Dockerfile (Trivy).Catégorie: INFRASTRUCTURE
  • Identifiant: workflowsInjection de scripts dans GitHub Actions, autorisations trop larges, actions non épinglées et pwn requests (zizmor).Catégorie: INFRASTRUCTURE

Qualité du code

  • Identifiant: code-smellsErreurs étouffées, instructions de débogage oubliées, comparaisons suspectes et autre code sujet aux erreurs.Catégorie: QUALITY
  • Identifiant: complexityFonctions à forte complexité cyclomatique, à imbrication profonde, au corps trop long ou aux listes de paramètres trop longues.Catégorie: MAINTAINABILITY
  • Identifiant: duplicationBlocs de code copiés-collés d’un fichier à l’autre.Catégorie: DUPLICATION
  • Identifiant: testsSuites de tests absentes ou insuffisantes, gros fichiers non testés, tests focalisés ou désactivés, tests sans assertions, CI qui n’exécute jamais les tests.Catégorie: TESTING
  • Identifiant: docsREADME sans instructions d’installation ni d’utilisation, API publiques non documentées, paquets publiés sans journal des modifications.Catégorie: DOCUMENTATION
  • Identifiant: hygieneREADME, LICENSE, CI et .gitignore ; artefacts de build commités, dépendances embarquées et fichiers volumineux.Catégorie: HYGIENE

Pérennité

  • Identifiant: licensesDépendances sous licence copyleft (GPL, AGPL), à usage restreint ou inconnue, incompatibles avec la licence du projet.Catégorie: LICENSES
  • Identifiant: dep-healthDépendances directes dépréciées, en retard d’au moins deux versions majeures ou qui ne sont plus publiées.Catégorie: DEPENDENCY_HEALTH
  • Identifiant: activityDépôts à l’abandon, risque lié à un mainteneur unique (bus factor) et gros fichiers fréquemment modifiés.Catégorie: ACTIVITY

Risques du code IA

  • Identifiant: hallucinated-depsDépendances et imports absents du registre public (cibles de slopsquatting), versions jamais publiées, paquets publiés pour la première fois au cours des 30 derniers jours et imports non déclarés dans package.json.Catégorie: HALLUCINATION
  • Identifiant: ai-slopStubs, espaces réservés du type « reste du code », données factices et identifiants fictifs dans les chemins de production, fichiers dupliqués suffixés « copie » et désactivations globales des vérifications de types ou du linter.Catégorie: UNFINISHED_CODE
  • Identifiant: vibe-stackTables Supabase sans sécurité au niveau des lignes (RLS), secrets dans des variables d’environnement publiques, routes d’API non authentifiées et contrôles d’accès effectués uniquement côté client.Catégorie: VIBE_STACK
  • Identifiant: llm-appChemins d’injection de prompt, sortie de LLM atteignant l’exécution de code, le SQL ou le HTML, clés d’API de LLM dans le code client, appels de modèle sans limite et configuration d’agents IA à risque.Catégorie: LLM_SECURITY
  • Identifiant: ai-signalSignal heuristique de paternité IA. Bêta, informatif, jamais pris en compte dans le score ; uniquement s’il est activé sur le serveur.Catégorie: AI_SIGNAL

Prêt pour la production

  • Identifiant: resilienceAppels HTTP sortants sans timeout, appels bloquants sur le chemin des requêtes et dans les fonctions async, clients de base de données créés à chaque requête.Catégorie: RESILIENCE
  • Identifiant: data-accessRequêtes dans des boucles (N+1), endpoints de liste sans pagination, clés étrangères sans index, synchronisation du schéma au démarrage qui peut supprimer des données.Catégorie: DATABASE
  • Identifiant: operabilityServices déployés qui exécutent un serveur de développement, vérifient les mots de passe sans limite de débit à la connexion, ou n’ont ni arrêt propre, ni health check, ni suivi des erreurs.Catégorie: OPERABILITY

Audits de longue durée

La plupart des audits se terminent en quelques minutes. vetkit_run_audit interroge l’API toutes les quelques secondes et envoie des notifications de progression pendant l’attente. Certains clients annulent les appels d’outils au bout d’un délai fixe — Claude Code, par exemple, respecte MCP_TOOL_TIMEOUT. Si c’est le cas du vôtre, passez "wait": false et interrogez l’API avec vetkit_get_audit. Lorsque timeoutSeconds est écoulé, l’audit continue et l’outil renvoie "outcome": "still_running".

Erreurs

Les erreurs de l’API sont renvoyées sous forme de résultats d’outil avec isError: true et incluent le statut HTTP, le code d’erreur vetkit, le message, l’identifiant de requête et une indication.

  • 401 API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED — créez ou renouvelez une clé, mettez à jour VETKIT_API_KEY et redémarrez le serveur.
  • 403 INSUFFICIENT_SCOPE — il manque à la clé une portée requise par l’outil.
  • 409 AUDIT_CONCURRENCY_LIMIT et 429 RATE_LIMITED — patientez puis réessayez ; l’indication précise le délai lorsque l’API envoie Retry-After.
  • 402 INSUFFICIENT_CREDITS — une analyse complète nécessite 1 crédit du propriétaire de l’espace de travail. Demandez d’autres crédits dans l’application vetkit, ou lancez un Quick Scan gratuit de la branche par défaut tant que le quota mensuel le permet.
  • 422 ANALYZER_UNAVAILABLE — un contrôle de analyzers ne peut pas s’exécuter sur ce serveur. Appelez vetkit_list_checks, ou passez suites, qui ne sélectionne que les contrôles disponibles.
  • INSTALLATION_REQUIRED est renvoyé comme un résultat normal contenant l’URL d’installation de la GitHub App, et non comme une erreur.

Remarques de sécurité

  • Traitez la clé d’API comme un mot de passe. Elle donne accès aux audits et aux constats de votre organisation, y compris pour les dépôts privés. Conservez-la dans la configuration env de votre client MCP, jamais dans des fichiers que vous commitez. N’accordez que les portées nécessaires, définissez une date d’expiration et révoquez-la depuis l’application en cas de fuite.
  • La clé n’est envoyée qu’à VETKIT_API_URL, dans un en-tête Authorization: Bearer via HTTPS. Le serveur ne la journalise jamais et ne l’inclut jamais dans les messages d’erreur.
  • Le serveur communique en MCP uniquement via stdio. Il n’ouvre aucun port réseau et ne journalise que sur stderr.
  • Les extraits des constats sont masqués avant que vetkit ne les stocke ; les valeurs des secrets ne sont jamais renvoyées.
  • Le texte des rapports et des constats provient du dépôt audité (chemins de fichiers, messages). Traitez-le comme une entrée non fiable, comme toute autre sortie d’outil — un dépôt malveillant pourrait tenter d’y glisser des instructions destinées à votre agent.

Vous préférez le HTTP brut ? Tout ce que fait le serveur MCP est disponible via l’API REST.

Demander un accès anticipé

Parlez-nous de votre équipe et des dépôts que vous souhaitez auditer. Nous ouvrons l’accès par petits groupes et vous répondrons par e-mail.

Nous utilisons ces informations uniquement pour répondre à votre demande. Politique de confidentialité