Zum Inhalt springen

Doku · MCP

vetkit-MCP-Server

Geben Sie Ihrem Coding-Agenten einen Code-Auditor. Mit dem vetkit-MCP-Server können alle Clients für das Model Context Protocol mit stdio-Unterstützung Repositorys verbinden, Audits ausführen sowie Befunde und Berichte lesen.

MCP ist ein offener Standard, keine reine Claude-Integration. Konfigurieren Sie mit der Definition unten einen lokalen stdio-Server namens vetkit und folgen Sie der Anleitung Ihres Clients. Das äußere Konfigurationsformat variiert. Clients, die nur entfernte HTTP/SSE-Server akzeptieren, können sich nicht direkt verbinden; vetkit bietet keinen entfernten MCP-Endpunkt.

Lokale stdio-Serverdefinition
{  "command": "npx",  "args": [    "-y",    "@vetkit/mcp"  ],  "env": {    "VETKIT_API_KEY": "<your-api-key>"  }}

Bitten Sie Ihren Agenten dann zum Beispiel: „Prüfe acme/payments-api und sag mir, was ich zuerst beheben sollte.“ Laden Sie Ihren Client neu und prüfen Sie, ob vetkit_list_repos in der Werkzeugliste erscheint.

Voraussetzungen

  • Node.js 20.3 oder neuer, mit npx in Ihrem PATH.
  • Ein vetkit-Konto und Zugriff auf die GitHub-, Bitbucket-Cloud- oder GitLab.com-Repositorys, die Sie prüfen möchten.
  • Ein vetkit-API-Schlüssel (nächster Schritt).

API-Schlüssel erstellen

  1. Öffnen Sie in der vetkit-App Arbeitsbereich-Einstellungen → API-Schlüssel. Nur Inhaber und Admins einer Organisation können Schlüssel verwalten.
  2. Benennen Sie den Schlüssel nach dem Ort, an dem er eingesetzt wird, zum Beispiel „MCP — Laptop“.
  3. Um Repository-Audits auszuführen, wählen Sie repos:read, audits:read und audits:run (oder audits:write). Ergänzen Sie repos:write zum Verbinden von Repositories, findings:read zum Lesen von Befunden und reports:read zum Lesen von Berichten. Zum Starten oder Abbrechen von KI-Evaluierungen ist audits:write erforderlich. Für einen Agenten mit reinem Lesezugriff wählen Sie nur Lese-Scopes.
  4. Legen Sie optional ein Ablaufdatum und ein Rate-Limit pro Minute fest (Standard 60, bis zu 600).
  5. Kopieren Sie das Secret. Es hat die Form vk_live_… und wird nur einmal angezeigt; vetkit speichert ausschließlich einen Hash.

Rotation und Widerruf

Beim Rotieren eines Schlüssels wird ein neues Secret ausgestellt, und das alte bleibt 24 Stunden lang gültig, damit Sie das neue ausrollen können. Ein Widerruf wirkt sofort — die nächste Anfrage liefert 401 API_KEY_REVOKED.

Installation

Cursor

Fügen Sie den folgenden vetkit-Eintrag in ~/.cursor/mcp.json (global) oder in .cursor/mcp.json in einem Projekt ein. Committen Sie keine Projektkonfiguration, die Ihren Schlüssel enthält.

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

VS Code / GitHub Copilot

Ergänzen Sie diesen Eintrag in .vscode/mcp.json und behalten Sie vorhandene Server bei. VS Code / GitHub Copilot verwendet servers statt mcpServers. Starten und genehmigen Sie vetkit in der MCP-Serverliste. Ersetzen Sie den Schlüssel-Platzhalter und committen Sie niemals eine Konfiguration mit Ihrem Secret.

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

Codex

Ergänzen Sie diese TOML-Abschnitte in ~/.codex/config.toml, ohne vorhandene Einstellungen zu ersetzen. Codex CLI und die IDE-Erweiterung teilen diese Konfiguration. Ersetzen Sie den Schlüssel-Platzhalter, starten Sie den Client neu und prüfen Sie mit codex mcp list. Halten Sie die Datei geheim.

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

Fügen Sie --scope user hinzu, damit vetkit in jedem Projekt verfügbar ist statt nur im aktuellen.

Claude Desktop

Öffnen Sie Settings → Developer → Edit Config, fügen Sie vetkit zu claude_desktop_config.json hinzu und starten Sie Claude Desktop anschließend neu:

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

Andere MCP-Clients

Jeder Client, der einen stdio-Server starten kann, funktioniert: Führen Sie npx -y @vetkit/mcp mit VETKIT_API_KEY in der Umgebung aus. Sie können das Paket auch global installieren und das Binary vetkit-mcp direkt ausführen.

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

Konfiguration

Der Server wird vollständig über Umgebungsvariablen konfiguriert.

VariableErforderlichBeschreibung
VETKIT_API_KEYJaIhr API-Schlüssel, vk_live_… oder vk_test_….
VETKIT_API_URLNeinBasis-URL der API. Standard: https://api.vetkit.dev. Muss HTTPS verwenden; unverschlüsseltes HTTP wird nur für localhost akzeptiert.
VETKIT_ORG_IDNeinOrganisations-ID. Jeder API-Schlüssel gehört zu genau einer Organisation, die standardmäßig verwendet wird; Sie benötigen diese Variable daher selten.
VETKIT_APP_URLNeinURL der Web-App, die für Links zu Audits verwendet wird. Standard: https://app.vetkit.dev.

Tools

Jedes Tool liefert lesbaren Text, und alle Tools außer vetkit_get_report liefern zusätzlich typisierten strukturierten Inhalt. Die Tools tragen MCP-Annotationen, sodass Clients die nur lesenden automatisch freigeben können. Keines der Tools löscht etwas.

vetkit_list_repos

Listet die mit Ihrer Organisation verbundenen Repositorys auf, mit Note und Score des letzten Audits.nur lesendScopes: repos:read
limitnumber
Seitengröße, 1–100. Standard: 25.
cursorstring
Der nextCursor-Wert der vorherigen Seite.
Beispielargumente
{ "limit": 10 }

vetkit_connect_repo

Verbindet ein Repository auf GitHub, Bitbucket Cloud oder GitLab.com. Ist die vetkit GitHub App beim Eigentümer noch nicht installiert, wird für GitHub das Ergebnis "installation_required" mit einer Installations-URL zurückgegeben. Private Bitbucket- und GitLab-Repositorys benötigen ein Zugriffstoken, das vetkit für spätere Audits speichert.schreibendScopes: repos:write
urlstringerforderlich
Repository-URL von GitHub, Bitbucket Cloud oder GitLab.com oder "owner/name" für GitHub.
accessTokenstring
Optionales Repository-Zugriffstoken; für private Bitbucket- oder GitLab-Repositorys erforderlich. Wird an vetkit gesendet und für spätere Audits gespeichert.
Beispielargumente
{ "url": "https://github.com/acme/payments-api" }

vetkit_run_audit

Startet ein Audit und wartet standardmäßig auf dessen Abschluss, während Fortschrittsbenachrichtigungen gesendet werden. Verbindet das Repository bei Bedarf zuerst. Liefert die Gesamtnote, die Note jeder ausgeführten Suite, den Score und die Anzahl der Befunde. Dieses Tool akzeptiert keine Zugriffstoken. Verbinden Sie private Bitbucket- oder GitLab-Repositorys zuerst mit vetkit_connect_repo und accessToken.schreibendScopes: repos:read, audits:read, audits:run oder audits:write (+ repos:write für automatisches Verbinden)
repostringerforderlich
Repository-ID, "owner/name" für GitHub oder eine URL von GitHub, Bitbucket Cloud oder GitLab.com. GitHub-URLs können /tree/<branch> enthalten.
mode"QUICK" | "FULL"
„QUICK“ startet einen kostenlosen Quick Scan (10 pro Monat je Workspace-Inhaber: posture, gitleaks und osv auf dem neuesten Commit des Standard-Branches). „FULL“ startet einen vollständigen Scan für 1 Credit, der dem Workspace-Inhaber berechnet wird. Standard ist „QUICK“, oder „FULL“, wenn ref, suites oder analyzers angegeben sind.
refstring
Branch, Tag oder Commit-SHA. Standardmäßig die Ref aus der URL, sonst der Standard-Branch.
suitesstring[]
Wählen Sie aus "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Führt die verfügbaren, standardmäßig aktivierten Prüfungen der gewählten Suites aus; bei expliziter Auswahl von privacy oder git-history auch deren verfügbare optionale Prüfungen. Für eine genaue Auswahl verwenden Sie analyzers. Standard ist die Repository-Einstellung.
analyzersstring[]
Genau diese Prüfungen ausführen, per ID (siehe Prüfungen unten); hat Vorrang vor suites. Mindestens eine Prüfung außer ai-signal.
excludeAssetsboolean
Bilder, Videos, Audiodateien, 3D-Modelle, Schriftarten, Designdateien und PDFs nicht herunterladen. Standard: die Einstellung des Repositorys.
waitboolean
Auf einen Endstatus warten. Standard: true.
timeoutSecondsnumber
Maximale Wartezeit, 10–1800. Standard: 600. Das Audit läuft nach einem Timeout weiter.
Beispielargumente
{ "repo": "acme/payments-api", "ref": "main", "suites": ["security"] }

vetkit_list_checks

Listet alle Prüfungen nach Suite gruppiert auf, mit dem verwendeten Tool und dessen Version, der Verfügbarkeit auf dem Server und den standardmäßig ausgeführten Prüfungen.nur lesendScopes: audits:read

Keine Argumente.

Beispielargumente
{}

vetkit_get_audit

Liefert für ein Audit Status, Gesamtnote und Noten je Suite, Score, Anzahl der Befunde und den Fortschritt je Prüfung — einschließlich Metriken wie Anteil duplizierten Codes, durchschnittliche Komplexität, Verhältnis von Testcode zu Quellcode und Bus-Faktor.nur lesendScopes: audits:read
auditIduuiderforderlich
Die von vetkit_run_audit zurückgegebene Audit-ID.
Beispielargumente
{ "auditId": "0192f3a4-5b6c-7d8e-9f01-23456789abcd" }

vetkit_list_findings

Listet die Befunde eines Audits auf, die schwerwiegendsten zuerst. Liefert eine kompakte Tabelle als Text und alle Details — Meldung, maskiertes Snippet, Behebung, Referenzen — als strukturierten Inhalt.nur lesendScopes: findings:read
auditIduuiderforderlich
Das zu lesende Audit.
severitystring[]
CRITICAL, HIGH, MEDIUM, LOW oder INFO.
suitestring
SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY oder GIT_HISTORY: nur Befunde dieser 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 oder PRIVACY_LIFECYCLE.
statusstring
NEW (seit dem vorherigen Audit hinzugekommen) oder EXISTING.
limitnumber
Seitengröße, 1–100. Standard: 25.
cursorstring
Der nextCursor-Wert der vorherigen Seite.
Beispielargumente
{ "auditId": "0192f3a4-…", "severity": ["CRITICAL", "HIGH"] }

vetkit_suggest_fix

Schlägt einen minimalen Patch für einen Code-Befund (SAST, Secrets, LLM-App, IaC) vor – mit dem KI-Anbieter, den Ihre Organisation in vetkit gespeichert hat, oder mit einem regelbasierten Fix, wenn der Analyzer einen liefert. Liefert einen Unified Diff, eine Erklärung, eine Konfidenzstufe und einen Prüfstatus. An den Anbieter geht nur ein geschwärzter Ausschnitt von etwa 60 Zeilen. Es wird nichts geschrieben: kein Branch, kein Commit, kein Pull Request. Erfordert einen Schlüssel, den ein Organisationsadministrator erstellt hat.nur lesendScopes: findings:write
findingIduuiderforderlich
ID eines Code-Befunds aus vetkit_list_findings.
providerstring
Zu verwendender gespeicherter KI-Anbieter. Standard ist die erste verifizierte Verbindung.
Beispielargumente
{ "findingId": "0193b2c4-…" }

vetkit_triage_findings

Fragt den gespeicherten KI-Anbieter Ihrer Organisation, ob bis zu 20 Befunde eines Audits wahrscheinlich echte oder falsch positive Treffer sind. Jeder Befund erhält ein Urteil, eine Konfidenz und eine kurze Begründung, die eine Quellzeile zitiert. Die Urteile sind Empfehlungen: Sie passen die Priorität an, unterdrücken aber nie einen Befund und ändern nicht die Bewertung. Erfordert einen kostenpflichtigen Plan.schreibendScopes: findings:write
auditIduuiderforderlich
Das Audit, zu dem die Befunde gehören.
findingIdsuuid[]erforderlich
Bis zu 20 Befund-IDs aus vetkit_list_findings.
Beispielargumente
{ "auditId": "0192f3a4-…", "findingIds": ["0193b2c4-…"] }

vetkit_get_report

Liefert den Bericht eines abgeschlossenen Audits: lesbares Markdown, eine JSON-Zusammenfassung mit Scores je Suite und Kategorie sowie dem Vergleich mit dem vorherigen Audit oder SARIF 2.1.0.nur lesendScopes: reports:read
auditIduuiderforderlich
Das zu lesende Audit.
formatstring
markdown (Standard), json oder sarif.
maxCharsnumber
Ausgabe ab dieser Zeichenzahl kürzen, 2.000–500.000. Standard: 40.000.
Beispielargumente
{ "auditId": "0192f3a4-…", "format": "markdown" }

vetkit_get_standards_report

Ordnet die offenen Befunde eines Audits OWASP Top 10 (2021 oder 2025), CWE Top 25 (2024) oder OWASP Top 10 for LLM Applications (2025) zu. Jede Kategorie ist fail, pass (keine zugeordneten Befunde von Checks, die sie erkennen können) oder not covered. Eine Zuordnungshilfe, keine Compliance-Zertifizierung.nur lesendScopes: reports:read, findings:read
auditIduuiderforderlich
Das zuzuordnende Audit.
standardstringerforderlich
owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 oder owasp-llm-top10-2025.
Beispielargumente
{ "auditId": "0192f3a4-…", "standard": "owasp-top10-2021" }

vetkit_check_packages

Vor dem Installieren einer Abhängigkeit aufrufen. Prüft bis zu 50 Pakete eines Ökosystems gegen die öffentliche Registry, OSV-Advisories (einschließlich bekannter Schadpakete), CISA KEV und die Richtlinie Ihrer Organisation und liefert allow, warn oder block mit Gründen.nur lesendScopes: agent:check
ecosystemstringerforderlich
npm, pypi, cargo, go, rubygems, nuget oder maven. Für pip und uv pypi verwenden.
packagesobject[]erforderlich
Bis zu 50 Pakete: ein Name (Maven group:artifact, Go-Modulpfad) und optional eine exakte Version.
Beispielargumente
{ "ecosystem": "npm", "packages": [{ "name": "left-pad", "version": "1.3.0" }] }

vetkit_scan_changes

Vor dem Committen aufrufen. Durchsucht bis zu 30 geänderte Dateien (insgesamt 512 KB) im Speicher nach exakt geformten Secrets, riskanter Agent-Konfiguration und versteckten Anweisungen, unfertigem Code und Importen nicht existierender Pakete. Nichts wird gespeichert oder ausgeführt.nur lesendScopes: agent:check
filesobject[]erforderlich
Geänderte Dateien: ein repository-relativer Pfad wie src/app.ts und der vollständige UTF-8-Inhalt.
Beispielargumente
{ "files": [{ "path": "src/config.ts", "content": "…" }] }

Agent-Guardrails

Mit zwei Tools prüft ein Coding-Agent seine Arbeit, bevor er handelt: vetkit_check_packages vor dem Installieren einer Abhängigkeit und vetkit_scan_changes vor dem Committen. Beide benötigen einen API-Schlüssel mit dem Scope agent:check.

Beide liefern ein Urteil allow, warn oder block mit Gründen. Block: Das Paket existiert nicht (ein halluzinierter oder per Slopsquatting registrierter Name), hat in OSV einen Eintrag als bekanntes Schadpaket, hat ein CISA-KEV-Advisory, wenn Ihre Richtlinie bekannt ausgenutzte Schwachstellen blockiert, nutzt eine Lizenz von der Sperrliste Ihrer Organisation, oder die Änderung enthält ein committetes Secret. Warn: eine unveröffentlichte Version, ein sehr neues Release, geringe Verbreitung, ein Advisory ab der Mindestschwere Ihrer Richtlinie oder andere Code-Befunde. Nicht erreichbare Quellen werden als Warnungen aufgeführt; diese Prüfungen werden übersprungen, nie geraten.

Claude Code-Hook

vetkit-mcp hook pre-tool-use liest die PreToolUse-Eingabe von Claude Code, findet Paketinstallationen in Bash-Befehlen und beendet sich mit Code 2, wenn vetkit ein Paket blockiert – Claude Code stoppt dann den Befehl und zeigt den Grund. Andernfalls endet er mit 0 und gibt eventuelle Warnungen aus. Bei Fehlern blockiert er nicht: Ohne VETKIT_API_KEY oder wenn die API nicht erreichbar ist, warnt er und lässt den Befehl laufen. Fügen Sie ihn in .claude/settings.json ein:

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

Setzen Sie VETKIT_API_KEY in Ihrer Shell auf einen Schlüssel mit dem Scope agent:check, nicht in einer committeten Datei.

Cursor und andere Clients

Der Hook prüft nur Paketinstallationen. Um Änderungen zu scannen, und in Cursor oder anderen Clients ohne Hooks, fügen Sie eine Regel hinzu, die den Agenten anweist, vor dem Installieren vetkit_check_packages und vor dem Committen vetkit_scan_changes aufzurufen. Die MCP-Seite in der vetkit-App enthält eine fertige Cursor-Regel.

Prüfungen

Es gibt fünf bewertete Suites sowie die optionalen Suites Datenschutz (Beta) und Git-Verlauf, die die Note nicht beeinflussen. Jede bewertete Suite erhält eine eigene Note, und der Gesamtscore gewichtet Sicherheit mit 43 %, Codequalität mit 18 %, Nachhaltigkeit mit 11 %, KI-Code-Risiken mit 13 % und Produktionsreife mit 15 %. Es zählen nur ausgeführte Suites, auf die sich die Gewichte verteilen (ohne Produktionsreife: Sicherheit 50 %, Codequalität 22 %, Nachhaltigkeit 13 % und KI-Code-Risiken 15 %; wenn nur Sicherheit und Codequalität ausgeführt wurden: 70 % und 30 %). Übergeben Sie Prüfungs-IDs in analyzers oder eine Suite in suites.

Sicherheit

  • Prüfungs-ID: postureCommittete .env-Dateien, private Schlüssel und Keystores, Manifeste ohne Lockfile, fehlende Sicherheitsrichtlinie.Kategorie: SECRETS, DEPENDENCIES, SECURITY
  • Prüfungs-ID: gitleaksAPI-Schlüssel, Tokens, Passwörter und private Schlüssel im Quellcode.Kategorie: SECRETS
  • Prüfungs-ID: secrets-historyCommittete und später entfernte Zugangsdaten, die sich noch aus der Git-Historie wiederherstellen lassen. Nur bei expliziter Auswahl.Kategorie: SECRETS
  • Prüfungs-ID: osvBekannte CVEs, schädliche Pakete und aktiv ausgenutzte Schwachstellen (CISA KEV) in festgeschriebenen Abhängigkeiten.Kategorie: DEPENDENCIES
  • Prüfungs-ID: vendoredBekannt verwundbare JavaScript-Bibliotheken, die ins Repository kopiert wurden.Kategorie: DEPENDENCIES
  • Prüfungs-ID: eolNicht mehr unterstützte Laufzeitumgebungen, Frameworks und Container-Basis-Images.Kategorie: DEPENDENCIES
  • Prüfungs-ID: supply-chainLockfile-Injection, unsichere Registrys, riskante Installationsskripte, Trojan Source und committete ausführbare Dateien.Kategorie: DEPENDENCIES, SECURITY
  • Prüfungs-ID: sastAusgewählte Codesicherheitsregeln für unterstützte Sprachen sowie unsichere Server-, Mobil- und Shell-Konfigurationen.Kategorie: SECURITY
  • Prüfungs-ID: sast-communityZusätzliche, permissiv lizenzierte Community-Regelpakete. Nur bei expliziter Auswahl, Beta.Kategorie: SECURITY
  • Prüfungs-ID: iacFehlkonfigurationen in Terraform, CloudFormation, Kubernetes, Helm und Dockerfiles (Trivy).Kategorie: INFRASTRUCTURE
  • Prüfungs-ID: workflowsScript Injection in GitHub Actions, zu weit gefasste Berechtigungen, nicht gepinnte Actions und Pwn Requests (zizmor).Kategorie: INFRASTRUCTURE

Codequalität

  • Prüfungs-ID: code-smellsVerschluckte Fehler, vergessene Debug-Anweisungen, verdächtige Vergleiche und anderer fehleranfälliger Code.Kategorie: QUALITY
  • Prüfungs-ID: complexityFunktionen mit hoher zyklomatischer Komplexität, tiefer Verschachtelung, langem Funktionsrumpf oder langen Parameterlisten.Kategorie: MAINTAINABILITY
  • Prüfungs-ID: duplicationPer Copy-and-paste über Dateien hinweg duplizierte Codeblöcke.Kategorie: DUPLICATION
  • Prüfungs-ID: testsFehlende oder dürftige Testsuites, große ungetestete Dateien, fokussierte oder übersprungene Tests, Tests ohne Assertions, eine CI, die nie Tests ausführt.Kategorie: TESTING
  • Prüfungs-ID: docsREADMEs ohne Einrichtungs- oder Nutzungshinweise, undokumentierte öffentliche APIs, veröffentlichte Pakete ohne Changelog.Kategorie: DOCUMENTATION
  • Prüfungs-ID: hygieneREADME, LICENSE, CI und .gitignore; committete Build-Ausgaben, eingebettete Abhängigkeiten und große Dateien.Kategorie: HYGIENE

Nachhaltigkeit

  • Prüfungs-ID: licensesAbhängigkeiten unter Copyleft-Lizenzen (GPL, AGPL), nutzungsbeschränkten oder unbekannten Lizenzen, die mit der Projektlizenz kollidieren.Kategorie: LICENSES
  • Prüfungs-ID: dep-healthDirekte Abhängigkeiten, die abgekündigt sind, zwei oder mehr Major-Versionen zurückliegen oder nicht mehr veröffentlicht werden.Kategorie: DEPENDENCY_HEALTH
  • Prüfungs-ID: activityInaktive Repositorys, Abhängigkeit von einer einzelnen Person (Bus-Faktor) und große Dateien, die sich häufig ändern.Kategorie: ACTIVITY

KI-Code-Risiken

  • Prüfungs-ID: hallucinated-depsAbhängigkeiten und Importe, die in der öffentlichen Registry nicht existieren (Ziele für Slopsquatting), nie veröffentlichte Versionen, Pakete, die erstmals in den letzten 30 Tagen veröffentlicht wurden, sowie Importe, die in package.json fehlen.Kategorie: HALLUCINATION
  • Prüfungs-ID: ai-slopStubs, Platzhalter wie „Rest des Codes“, Mock-Daten und Platzhalter-Zugangsdaten in Produktionspfaden, Dateiduplikate mit Kopie-Suffix sowie pauschale Typ- oder Lint-Unterdrückungen.Kategorie: UNFINISHED_CODE
  • Prüfungs-ID: vibe-stackSupabase-Tabellen ohne Row Level Security, Secrets in öffentlichen Umgebungsvariablen, API-Routen ohne Authentifizierung und Zugriffsprüfungen, die nur clientseitig erfolgen.Kategorie: VIBE_STACK
  • Prüfungs-ID: llm-appPfade für Prompt Injection, LLM-Ausgaben, die in Codeausführung, SQL oder HTML gelangen, LLM-API-Schlüssel im Client-Code, unbegrenzte Modellaufrufe und riskante Konfiguration von KI-Agenten.Kategorie: LLM_SECURITY
  • Prüfungs-ID: ai-signalHeuristisches KI-Autorschaftssignal. Beta, rein informativ, fließt nie in den Score ein; nur verfügbar, wenn auf dem Server aktiviert.Kategorie: AI_SIGNAL

Produktionsreife

  • Prüfungs-ID: resilienceAusgehende HTTP-Aufrufe ohne Timeout, blockierende Aufrufe im Request-Pfad und in async-Funktionen, Datenbank-Clients, die pro Request erzeugt werden.Kategorie: RESILIENCE
  • Prüfungs-ID: data-accessAbfragen in Schleifen (N+1), Listen-Endpunkte ohne Paginierung, Fremdschlüssel ohne Index, Schema-Synchronisierung beim Start, die Daten löschen kann.Kategorie: DATABASE
  • Prüfungs-ID: operabilityBereitgestellte Dienste, die einen Entwicklungsserver ausführen, Passwörter ohne Rate-Limit für Logins prüfen oder kein Graceful Shutdown, keinen Health Check oder kein Fehler-Tracking haben.Kategorie: OPERABILITY

Lang laufende Audits

Die meisten Audits sind in wenigen Minuten abgeschlossen. vetkit_run_audit fragt alle paar Sekunden den Status ab und sendet während des Wartens Fortschrittsbenachrichtigungen. Manche Clients brechen Tool-Aufrufe nach einer festen Zeit ab — Claude Code beachtet zum Beispiel MCP_TOOL_TIMEOUT. Falls Ihr Client das tut, übergeben Sie "wait": false und fragen Sie mit vetkit_get_audit ab. Wenn timeoutSeconds abgelaufen ist, läuft das Audit weiter und das Tool liefert "outcome": "still_running".

Fehler

API-Fehler kommen als Tool-Ergebnisse mit isError: true zurück und enthalten HTTP-Status, vetkit-Fehlercode, Meldung, Anfrage-ID und einen Hinweis.

  • 401 API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED — erstellen oder rotieren Sie einen Schlüssel, aktualisieren Sie VETKIT_API_KEY und starten Sie den Server neu.
  • 403 INSUFFICIENT_SCOPE — dem Schlüssel fehlt ein Scope, den das Tool benötigt.
  • 409 AUDIT_CONCURRENCY_LIMIT und 429 RATE_LIMITED — warten und erneut versuchen; der Hinweis enthält die Wartezeit, wenn die API Retry-After sendet.
  • 402 INSUFFICIENT_CREDITS — ein vollständiger Scan benötigt 1 Credit des Workspace-Inhabers. Fordern Sie in der vetkit-App weitere Credits an oder führen Sie einen kostenlosen Quick Scan des Standard-Branches aus, solange das monatliche Kontingent reicht.
  • 422 ANALYZER_UNAVAILABLE — eine Prüfung in analyzers kann auf diesem Server nicht ausgeführt werden. Rufen Sie vetkit_list_checks auf oder übergeben Sie suites; dabei werden nur verfügbare Prüfungen ausgewählt.
  • INSTALLATION_REQUIRED wird als normales Ergebnis mit der Installations-URL der GitHub App zurückgegeben, nicht als Fehler.

Sicherheitshinweise

  • Behandeln Sie den API-Schlüssel wie ein Passwort. Er gewährt Zugriff auf die Audits und Befunde Ihrer Organisation, einschließlich privater Repositorys. Bewahren Sie ihn in der env-Konfiguration Ihres MCP-Clients auf, niemals in Dateien, die Sie committen. Vergeben Sie nur die Scopes, die Sie benötigen, legen Sie ein Ablaufdatum fest und widerrufen Sie ihn in der App, falls er offengelegt wird.
  • Der Schlüssel wird ausschließlich an VETKIT_API_URL gesendet, als Authorization: Bearer-Header über HTTPS. Der Server protokolliert ihn nie und nimmt ihn nie in Fehlermeldungen auf.
  • Der Server kommuniziert per MCP ausschließlich über stdio. Er öffnet keine Netzwerkports und protokolliert nur nach stderr.
  • Snippets von Befunden werden maskiert, bevor vetkit sie speichert; Secret-Werte werden nie zurückgegeben.
  • Bericht- und Befundtexte stammen aus dem geprüften Repository (Dateipfade, Meldungen). Behandeln Sie sie wie jede andere Tool-Ausgabe als nicht vertrauenswürdige Eingabe — ein bösartiges Repository könnte versuchen, Anweisungen an Ihren Agenten einzuschleusen.

Lieber direkt per HTTP? Alles, was der MCP-Server kann, ist auch über die REST-API verfügbar.

Early Access anfordern

Erzählen Sie uns kurz von Ihrem Team und den Repositorys, die Sie prüfen möchten. Wir nehmen Teams in kleinen Gruppen auf und antworten per E-Mail.

Wir verwenden diese Angaben nur, um auf Ihre Anfrage zu antworten. Datenschutzerklärung