Documentazione · MCP
Server MCP di vetkit
Dai al tuo agente di coding un auditor del codice. Il server MCP di vetkit permette a qualsiasi client Model Context Protocol compatibile con stdio di collegare repository, eseguire audit e leggere rilevamenti e report.
MCP è uno standard aperto, non un’integrazione esclusiva di Claude. Configura un server stdio locale chiamato vetkit con la definizione qui sotto, poi segui le istruzioni del client. La struttura di configurazione varia. I client che accettano solo server HTTP/SSE remoti non possono collegarsi direttamente; vetkit non offre un endpoint MCP remoto.
{ "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" }}Poi chiedi al tuo agente qualcosa come “Esegui l’audit di acme/payments-api e dimmi cosa correggere per primo.” Ricarica il client e verifica che vetkit_list_repos compaia nell’elenco degli strumenti.
Requisiti
- Node.js 20.3 o successivo, con
npxnel tuoPATH. - Un account vetkit e l’accesso ai repository GitHub, Bitbucket Cloud o GitLab.com che vuoi sottoporre ad audit.
- Una chiave API di vetkit (passaggio successivo).
Crea una chiave API
- Apri Impostazioni dello spazio di lavoro → Chiavi API nell’app vetkit. Solo i proprietari e gli amministratori dell’organizzazione possono gestire le chiavi.
- Dai alla chiave un nome che indichi dove verrà usata, ad esempio “MCP — laptop”.
- Per eseguire audit dei repository, seleziona
repos:read,audits:readeaudits:run(oaudits:write). Aggiungirepos:writeper collegare repository,findings:readper leggere i risultati ereports:readper leggere i report. Avviare o annullare valutazioni IA richiedeaudits:write. Per un agente in sola lettura, seleziona solo ambiti di lettura. - Facoltativamente, imposta una scadenza e un limite di frequenza al minuto (predefinito 60, fino a 600).
- Copia il segreto. Ha la forma
vk_live_…e viene mostrato una sola volta; vetkit ne memorizza solo un hash.
Rotazione e revoca
401 API_KEY_REVOKED.Installazione
Cursor
Aggiungi la voce vetkit qui sotto a ~/.cursor/mcp.json (globale) o a .cursor/mcp.json in un progetto. Non fare il commit di una configurazione di progetto che contiene la tua chiave.
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}VS Code / GitHub Copilot
Aggiungi questa voce a .vscode/mcp.json mantenendo i server esistenti. VS Code / GitHub Copilot usa servers, non mcpServers. Avvia e autorizza vetkit dall’elenco dei server MCP. Sostituisci il segnaposto della chiave e non includere mai in un commit una configurazione con il tuo segreto.
{ "servers": { "vetkit": { "type": "stdio", "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Codex
Aggiungi queste sezioni TOML a ~/.codex/config.toml senza sostituire le impostazioni esistenti. Codex CLI e l’estensione IDE condividono questa configurazione. Sostituisci il segnaposto della chiave, riavvia il client e verifica con codex mcp list. Mantieni questo file privato.
[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/mcpAggiungi --scope user per rendere vetkit disponibile in tutti i progetti anziché solo in quello corrente.
Claude Desktop
Apri Settings → Developer → Edit Config e aggiungi vetkit a claude_desktop_config.json, poi riavvia Claude Desktop:
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Altri client MCP
Funziona con qualsiasi client in grado di avviare un server stdio: esegui npx -y @vetkit/mcp con VETKIT_API_KEY nel suo ambiente. Puoi anche installare il pacchetto globalmente ed eseguire direttamente il binario vetkit-mcp.
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcpConfigurazione
Il server si configura interamente tramite variabili d’ambiente.
| Variabile | Obbligatoria | Descrizione |
|---|---|---|
VETKIT_API_KEY | Sì | La tua chiave API, vk_live_… o vk_test_…. |
VETKIT_API_URL | No | URL di base dell’API. Predefinito https://api.vetkit.dev. Deve essere HTTPS; HTTP semplice è accettato solo per localhost. |
VETKIT_ORG_ID | No | ID dell’organizzazione. Ogni chiave API appartiene esattamente a un’organizzazione, che viene usata per impostazione predefinita, quindi raramente ti servirà. |
VETKIT_APP_URL | No | URL della web app usato per i link agli audit. Predefinito https://app.vetkit.dev. |
Strumenti
Ogni strumento restituisce testo leggibile e tutti gli strumenti tranne vetkit_get_report restituiscono anche contenuto strutturato tipizzato. Gli strumenti includono le annotazioni MCP, così i client possono approvare automaticamente quelli in sola lettura. Nessuno strumento elimina alcunché.
vetkit_list_repos
Elenca i repository collegati alla tua organizzazione, con il voto e il punteggio dell’ultimo audit.sola letturaAmbiti: repos:read
limitnumber- Dimensione della pagina, 1–100. Predefinito 25.
cursorstring- Il valore nextCursor della pagina precedente.
| Argomento | Tipo | Descrizione |
|---|---|---|
limit | number | Dimensione della pagina, 1–100. Predefinito 25. |
cursor | string | Il valore nextCursor della pagina precedente. |
{ "limit": 10 }vetkit_connect_repo
Collega un repository GitHub, Bitbucket Cloud o GitLab.com. Per GitHub, se il proprietario non ha ancora installato la GitHub App di vetkit, restituisce l’esito "installation_required" con un URL di installazione. I repository privati Bitbucket e GitLab richiedono un token di accesso, che vetkit conserva per gli audit successivi.scritturaAmbiti: repos:write
urlstringobbligatorio- URL di un repository GitHub, Bitbucket Cloud o GitLab.com, oppure "owner/name" per GitHub.
accessTokenstring- Token di accesso al repository facoltativo; obbligatorio per i repository privati Bitbucket o GitLab. Viene inviato a vetkit e conservato per gli audit successivi.
| Argomento | Tipo | Descrizione |
|---|---|---|
urlobbligatorio | string | URL di un repository GitHub, Bitbucket Cloud o GitLab.com, oppure "owner/name" per GitHub. |
accessToken | string | Token di accesso al repository facoltativo; obbligatorio per i repository privati Bitbucket o GitLab. Viene inviato a vetkit e conservato per gli audit successivi. |
{ "url": "https://github.com/acme/payments-api" }vetkit_run_audit
Avvia un audit e, per impostazione predefinita, ne attende il termine inviando notifiche di avanzamento. Se necessario, collega prima il repository. Restituisce il voto complessivo, il voto di ogni suite eseguita, il punteggio e il numero di rilevamenti. Questo strumento non accetta token di accesso. Collega prima i repository privati Bitbucket o GitLab con vetkit_connect_repo e accessToken.scritturaAmbiti: repos:read, audits:read, audits:run o audits:write (+ repos:write per il collegamento automatico)
repostringobbligatorio- ID del repository, "owner/name" per GitHub oppure un URL GitHub, Bitbucket Cloud o GitLab.com. Gli URL GitHub possono includere /tree/<branch>.
mode"QUICK" | "FULL"- "QUICK" avvia un Quick Scan gratuito (10 al mese per proprietario del workspace: posture, gitleaks e osv sull’ultimo commit del branch predefinito). "FULL" avvia una scansione completa per 1 credito, addebitato al proprietario del workspace. Il valore predefinito è "QUICK", oppure "FULL" se si indicano ref, suites o analyzers.
refstring- Branch, tag o SHA del commit. Per impostazione predefinita usa il ref nell’URL, altrimenti il branch predefinito.
suitesstring[]- Scegli tra "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Esegue i controlli disponibili e attivati per impostazione predefinita delle suite selezionate; selezionare esplicitamente privacy o git-history include anche i relativi controlli opzionali disponibili. Usa analyzers per una selezione precisa. Se omesso, usa l’impostazione del repository.
analyzersstring[]- Controlli esatti da eseguire, per id (vedi Controlli più sotto); ha la precedenza su suites. Almeno un controllo diverso da ai-signal.
excludeAssetsboolean- Non scarica immagini, video, audio, modelli 3D, font, file di design e PDF. Se omesso, usa l’impostazione del repository.
waitboolean- Attende uno stato finale. Predefinito true.
timeoutSecondsnumber- Attesa massima, 10–1800. Predefinito 600. Dopo un timeout l’audit continua a essere eseguito.
| Argomento | Tipo | Descrizione |
|---|---|---|
repoobbligatorio | string | ID del repository, "owner/name" per GitHub oppure un URL GitHub, Bitbucket Cloud o GitLab.com. Gli URL GitHub possono includere /tree/<branch>. |
mode | "QUICK" | "FULL" | "QUICK" avvia un Quick Scan gratuito (10 al mese per proprietario del workspace: posture, gitleaks e osv sull’ultimo commit del branch predefinito). "FULL" avvia una scansione completa per 1 credito, addebitato al proprietario del workspace. Il valore predefinito è "QUICK", oppure "FULL" se si indicano ref, suites o analyzers. |
ref | string | Branch, tag o SHA del commit. Per impostazione predefinita usa il ref nell’URL, altrimenti il branch predefinito. |
suites | string[] | Scegli tra "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Esegue i controlli disponibili e attivati per impostazione predefinita delle suite selezionate; selezionare esplicitamente privacy o git-history include anche i relativi controlli opzionali disponibili. Usa analyzers per una selezione precisa. Se omesso, usa l’impostazione del repository. |
analyzers | string[] | Controlli esatti da eseguire, per id (vedi Controlli più sotto); ha la precedenza su suites. Almeno un controllo diverso da ai-signal. |
excludeAssets | boolean | Non scarica immagini, video, audio, modelli 3D, font, file di design e PDF. Se omesso, usa l’impostazione del repository. |
wait | boolean | Attende uno stato finale. Predefinito true. |
timeoutSeconds | number | Attesa massima, 10–1800. Predefinito 600. Dopo un timeout l’audit continua a essere eseguito. |
{ "repo": "acme/payments-api", "ref": "main", "suites": ["security"] }vetkit_list_checks
Elenca tutti i controlli raggruppati per suite, con lo strumento e la versione usati, la disponibilità sul server e quali controlli vengono eseguiti per impostazione predefinita.sola letturaAmbiti: audits:read
Nessun argomento.
| Argomento | Tipo | Descrizione |
|---|---|---|
| Nessun argomento. | ||
{}vetkit_get_audit
Restituisce per un audit lo stato, il voto complessivo e quello di ogni suite, il punteggio, il numero di rilevamenti e l’avanzamento di ogni controllo — incluse metriche come la quota di codice duplicato, la complessità media, il rapporto test/codice e il bus factor.sola letturaAmbiti: audits:read
auditIduuidobbligatorio- L’ID dell’audit restituito da vetkit_run_audit.
| Argomento | Tipo | Descrizione |
|---|---|---|
auditIdobbligatorio | uuid | L’ID dell’audit restituito da vetkit_run_audit. |
{ "auditId": "0192f3a4-5b6c-7d8e-9f01-23456789abcd" }vetkit_list_findings
Elenca i rilevamenti di un audit, dal più grave. Restituisce una tabella compatta come testo e tutti i dettagli — messaggio, snippet oscurato, correzione, riferimenti — come contenuto strutturato.sola letturaAmbiti: findings:read
auditIduuidobbligatorio- L’audit da leggere.
severitystring[]- CRITICAL, HIGH, MEDIUM, LOW o INFO.
suitestring- SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY o GIT_HISTORY: solo i rilevamenti di quella 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 (introdotto dopo l’audit precedente) o EXISTING.
limitnumber- Dimensione della pagina, 1–100. Predefinito 25.
cursorstring- Il valore nextCursor della pagina precedente.
| Argomento | Tipo | Descrizione |
|---|---|---|
auditIdobbligatorio | uuid | L’audit da leggere. |
severity | string[] | CRITICAL, HIGH, MEDIUM, LOW o INFO. |
suite | string | SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY o GIT_HISTORY: solo i rilevamenti di quella 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 (introdotto dopo l’audit precedente) o EXISTING. |
limit | number | Dimensione della pagina, 1–100. Predefinito 25. |
cursor | string | Il valore nextCursor della pagina precedente. |
{ "auditId": "0192f3a4-…", "severity": ["CRITICAL", "HIGH"] }vetkit_suggest_fix
Propone una patch minima per un risultato nel codice (SAST, segreti, app LLM, IaC) con il provider di IA che la tua organizzazione ha salvato in vetkit, oppure una correzione basata su regole quando l’analizzatore ne fornisce una. Restituisce un diff unificato, una spiegazione, un livello di confidenza e uno stato di verifica. Al provider viene inviata solo una finestra oscurata di circa 60 righe. Non viene scritto nulla: nessun branch, commit o pull request. Richiede una chiave creata da un amministratore dell’organizzazione.sola letturaAmbiti: findings:write
findingIduuidobbligatorio- Id di un risultato nel codice, da vetkit_list_findings.
providerstring- Provider di IA salvato da usare. Predefinito: la prima connessione verificata.
| Argomento | Tipo | Descrizione |
|---|---|---|
findingIdobbligatorio | uuid | Id di un risultato nel codice, da vetkit_list_findings. |
provider | string | Provider di IA salvato da usare. Predefinito: la prima connessione verificata. |
{ "findingId": "0193b2c4-…" }vetkit_triage_findings
Chiede al provider di IA salvato della tua organizzazione se fino a 20 risultati di un audit sono probabilmente veri o falsi positivi. Ognuno riceve un verdetto, una confidenza e una breve motivazione che cita una riga del sorgente. I verdetti sono indicativi: regolano la priorità ma non sopprimono mai un risultato né cambiano il punteggio. Richiede un piano a pagamento.scritturaAmbiti: findings:write
auditIduuidobbligatorio- L’audit a cui appartengono i risultati.
findingIdsuuid[]obbligatorio- Fino a 20 id di risultati da vetkit_list_findings.
| Argomento | Tipo | Descrizione |
|---|---|---|
auditIdobbligatorio | uuid | L’audit a cui appartengono i risultati. |
findingIdsobbligatorio | uuid[] | Fino a 20 id di risultati da vetkit_list_findings. |
{ "auditId": "0192f3a4-…", "findingIds": ["0193b2c4-…"] }vetkit_get_report
Restituisce il report di un audit concluso: Markdown leggibile, un riepilogo JSON con i punteggi per suite e per categoria e il confronto con l’audit precedente, oppure SARIF 2.1.0.sola letturaAmbiti: reports:read
auditIduuidobbligatorio- L’audit da leggere.
formatstring- markdown (predefinito), json o sarif.
maxCharsnumber- Tronca l’output oltre questo numero di caratteri, 2.000–500.000. Predefinito 40.000.
| Argomento | Tipo | Descrizione |
|---|---|---|
auditIdobbligatorio | uuid | L’audit da leggere. |
format | string | markdown (predefinito), json o sarif. |
maxChars | number | Tronca l’output oltre questo numero di caratteri, 2.000–500.000. Predefinito 40.000. |
{ "auditId": "0192f3a4-…", "format": "markdown" }vetkit_get_standards_report
Mappa i risultati aperti di un audit su OWASP Top 10 (2021 o 2025), CWE Top 25 (2024) o OWASP Top 10 for LLM Applications (2025). Ogni categoria risulta fail, pass (nessun risultato mappato da controlli in grado di rilevarla) o not covered. Un aiuto alla mappatura, non una certificazione di conformità.sola letturaAmbiti: reports:read, findings:read
auditIduuidobbligatorio- L’audit da mappare.
standardstringobbligatorio- owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 o owasp-llm-top10-2025.
| Argomento | Tipo | Descrizione |
|---|---|---|
auditIdobbligatorio | uuid | L’audit da mappare. |
standardobbligatorio | string | owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 o owasp-llm-top10-2025. |
{ "auditId": "0192f3a4-…", "standard": "owasp-top10-2021" }vetkit_check_packages
Da chiamare prima di installare una dipendenza. Verifica fino a 50 pacchetti di un ecosistema rispetto al registro pubblico, agli avvisi OSV (inclusi i pacchetti malevoli noti), a CISA KEV e alla policy della tua organizzazione, e restituisce allow, warn o block con le motivazioni.sola letturaAmbiti: agent:check
ecosystemstringobbligatorio- npm, pypi, cargo, go, rubygems, nuget o maven. Usa pypi per pip e uv.
packagesobject[]obbligatorio- Fino a 50 pacchetti: un nome (Maven group:artifact, percorso del modulo Go) e una versione esatta facoltativa.
| Argomento | Tipo | Descrizione |
|---|---|---|
ecosystemobbligatorio | string | npm, pypi, cargo, go, rubygems, nuget o maven. Usa pypi per pip e uv. |
packagesobbligatorio | object[] | Fino a 50 pacchetti: un nome (Maven group:artifact, percorso del modulo Go) e una versione esatta facoltativa. |
{ "ecosystem": "npm", "packages": [{ "name": "left-pad", "version": "1.3.0" }] }vetkit_scan_changes
Da chiamare prima del commit. Analizza in memoria fino a 30 file modificati (512 KB in totale) alla ricerca di segreti con formato esatto, configurazioni rischiose degli agenti e istruzioni nascoste, codice incompiuto e import di pacchetti inesistenti. Nulla viene salvato o eseguito.sola letturaAmbiti: agent:check
filesobject[]obbligatorio- File modificati: un percorso relativo al repository come src/app.ts e il contenuto UTF-8 completo.
| Argomento | Tipo | Descrizione |
|---|---|---|
filesobbligatorio | object[] | File modificati: un percorso relativo al repository come src/app.ts e il contenuto UTF-8 completo. |
{ "files": [{ "path": "src/config.ts", "content": "…" }] }Protezioni per agenti
Due strumenti permettono a un agente di programmazione di controllare il proprio lavoro prima di agire: vetkit_check_packages prima di installare una dipendenza e vetkit_scan_changes prima del commit. Entrambi richiedono una chiave API con lo scope agent:check.
Entrambi restituiscono un verdetto allow, warn o block con le motivazioni. Block: il pacchetto non esiste (un nome allucinato o di slopsquatting), ha un record OSV di pacchetto malevolo noto, ha un avviso CISA KEV quando la tua policy blocca le vulnerabilità sfruttate note, usa una licenza nella lista di esclusione della tua organizzazione, oppure la modifica contiene un segreto committato. Warn: una versione non pubblicata, una release molto recente, scarsa adozione, un avviso pari o superiore alla gravità minima della tua policy o altri risultati nel codice. Le fonti non raggiungibili sono elencate come avvisi; quei controlli vengono saltati, mai indovinati.
Hook di Claude Code
vetkit-mcp hook pre-tool-use legge l’input PreToolUse di Claude Code, individua le installazioni di pacchetti nei comandi Bash ed esce con codice 2 quando vetkit blocca un pacchetto, così Claude Code interrompe il comando e mostra il motivo. Altrimenti esce con 0 e stampa eventuali avvisi. In caso di errore non blocca: senza VETKIT_API_KEY, o se l’API non è raggiungibile, avvisa e lascia eseguire il comando. Aggiungilo a .claude/settings.json:
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "npx -y @vetkit/mcp hook pre-tool-use", "timeout": 30 } ] } ] }}Imposta VETKIT_API_KEY nella tua shell con una chiave che abbia lo scope agent:check, non in un file committato.
Cursor e altri client
vetkit_check_packages prima di installare e vetkit_scan_changes prima del commit. La pagina MCP dell’app vetkit include una regola Cursor pronta all’uso.Controlli
Sono disponibili cinque suite con punteggio, oltre alle suite opzionali Privacy e protezione dei dati (beta) e Cronologia Git, che non influiscono sul voto. Ogni suite con punteggio riceve un proprio voto e il punteggio complessivo è ponderato così: Sicurezza 43%, Qualità del codice 18%, Sostenibilità 11%, Rischi del codice IA 13% e Pronto per la produzione 15%. Contano solo le suite eseguite, tra le quali vengono ripartiti i pesi (Sicurezza 50%, Qualità del codice 22%, Sostenibilità 13% e Rischi del codice IA 15% senza la suite Pronto per la produzione; Sicurezza 70% e Qualità del codice 30% quando vengono eseguite solo queste due). Passa gli id dei controlli in analyzers oppure una suite in suites.
Sicurezza
- Id del controllo:
postureFile .env, chiavi private e keystore committati, manifest senza lockfile, policy di sicurezza assente.Categoria: SECRETS, DEPENDENCIES, SECURITY - Id del controllo:
gitleaksChiavi API, token, password e chiavi private nel codice sorgente.Categoria: SECRETS - Id del controllo:
secrets-historyCredenziali committate e poi rimosse che possono ancora essere recuperate dalla cronologia git. Da attivare esplicitamente.Categoria: SECRETS - Id del controllo:
osvCVE note, pacchetti malevoli e avvisi su vulnerabilità sfruttate attivamente (CISA KEV) nelle dipendenze fissate nei lockfile.Categoria: DEPENDENCIES - Id del controllo:
vendoredLibrerie JavaScript con vulnerabilità note copiate nel repository.Categoria: DEPENDENCIES - Id del controllo:
eolRuntime, framework e immagini base dei container a fine vita.Categoria: DEPENDENCIES - Id del controllo:
supply-chainIniezioni nei lockfile, registry non sicuri, script di installazione rischiosi, Trojan Source ed eseguibili committati.Categoria: DEPENDENCIES, SECURITY - Id del controllo:
sastRegole di sicurezza del codice selezionate per i linguaggi supportati e configurazioni non sicure di server, dispositivi mobili e shell.Categoria: SECURITY - Id del controllo:
sast-communityPacchetti aggiuntivi di regole della community con licenza permissiva. Da attivare esplicitamente, beta.Categoria: SECURITY - Id del controllo:
iacErrori di configurazione in Terraform, CloudFormation, Kubernetes, Helm e Dockerfile (Trivy).Categoria: INFRASTRUCTURE - Id del controllo:
workflowsIniezione di script in GitHub Actions, permessi troppo ampi, action non fissate a una versione e pwn request (zizmor).Categoria: INFRASTRUCTURE
Qualità del codice
- Id del controllo:
code-smellsErrori ignorati silenziosamente, istruzioni di debug dimenticate, confronti sospetti e altro codice soggetto a errori.Categoria: QUALITY - Id del controllo:
complexityFunzioni con complessità ciclomatica elevata, annidamento profondo, corpo lungo o lunghi elenchi di parametri.Categoria: MAINTAINABILITY - Id del controllo:
duplicationBlocchi di codice copiati e incollati tra file diversi.Categoria: DUPLICATION - Id del controllo:
testsSuite di test assenti o scarne, file di grandi dimensioni non testati, test focalizzati o saltati, test senza asserzioni, CI che non esegue mai i test.Categoria: TESTING - Id del controllo:
docsREADME senza istruzioni di installazione o d’uso, API pubbliche non documentate, pacchetti pubblicati senza changelog.Categoria: DOCUMENTATION - Id del controllo:
hygieneREADME, LICENSE, CI e .gitignore; output di build committato, dipendenze incorporate nel repository e file di grandi dimensioni.Categoria: HYGIENE
Sostenibilità
- Id del controllo:
licensesDipendenze con licenze copyleft (GPL, AGPL), a uso limitato o sconosciute, in conflitto con la licenza del progetto.Categoria: LICENSES - Id del controllo:
dep-healthDipendenze dirette deprecate, indietro di due o più versioni major o non più rilasciate.Categoria: DEPENDENCY_HEALTH - Id del controllo:
activityRepository inattivi, rischio legato a un unico maintainer (bus factor) e file di grandi dimensioni modificati di frequente.Categoria: ACTIVITY
Rischi del codice IA
- Id del controllo:
hallucinated-depsDipendenze e import che non esistono nel registry pubblico (bersagli di slopsquatting), versioni mai pubblicate, pacchetti pubblicati per la prima volta negli ultimi 30 giorni e import non dichiarati in package.json.Categoria: HALLUCINATION - Id del controllo:
ai-slopStub, segnaposto del tipo “resto del codice”, dati fittizi e credenziali segnaposto nei percorsi di produzione, file duplicati con suffisso di copia e soppressioni generalizzate di tipi o lint.Categoria: UNFINISHED_CODE - Id del controllo:
vibe-stackTabelle Supabase senza row level security, segreti in variabili d’ambiente pubbliche, route API senza autenticazione e controlli di accesso eseguiti solo lato client.Categoria: VIBE_STACK - Id del controllo:
llm-appPercorsi di prompt injection, output degli LLM che arriva a esecuzione di codice, SQL o HTML, chiavi API di LLM nel codice client, chiamate al modello senza limiti e configurazioni rischiose degli agenti IA.Categoria: LLM_SECURITY - Id del controllo:
ai-signalSegnale euristico di autorialità IA. Beta, informativo, mai incluso nel punteggio; solo se abilitato sul server.Categoria: AI_SIGNAL
Pronto per la produzione
- Id del controllo:
resilienceChiamate HTTP in uscita senza timeout, chiamate bloccanti nel percorso delle richieste e nelle funzioni async, client del database creati a ogni richiesta.Categoria: RESILIENCE - Id del controllo:
data-accessQuery dentro i cicli (N+1), endpoint di elenco senza paginazione, chiavi esterne senza indice, sincronizzazione dello schema all’avvio che può cancellare dati.Categoria: DATABASE - Id del controllo:
operabilityServizi distribuiti che eseguono un server di sviluppo, verificano le password senza limite di frequenza sul login o non hanno spegnimento controllato, health check o tracciamento degli errori.Categoria: OPERABILITY
Audit di lunga durata
La maggior parte degli audit termina in pochi minuti. vetkit_run_audit controlla lo stato a intervalli di pochi secondi e invia notifiche di avanzamento durante l’attesa. Alcuni client annullano le chiamate agli strumenti dopo un tempo fisso — Claude Code, ad esempio, rispetta MCP_TOOL_TIMEOUT. Se il tuo lo fa, passa "wait": false e controlla lo stato con vetkit_get_audit. Quando timeoutSeconds scade, l’audit continua a essere eseguito e lo strumento restituisce "outcome": "still_running".
Errori
Gli errori dell’API vengono restituiti come risultati dello strumento con isError: true e includono lo stato HTTP, il codice di errore vetkit, il messaggio, l’ID della richiesta e un suggerimento.
401 API_KEY_INVALID,API_KEY_REVOKED,API_KEY_EXPIRED— crea o ruota una chiave, aggiornaVETKIT_API_KEYe riavvia il server.403 INSUFFICIENT_SCOPE— alla chiave manca un ambito richiesto dallo strumento.409 AUDIT_CONCURRENCY_LIMITe429 RATE_LIMITED— attendi e riprova; il suggerimento include il tempo di attesa quando l’API inviaRetry-After.402 INSUFFICIENT_CREDITS— una scansione completa richiede 1 credito del proprietario dello spazio di lavoro. Richiedi altri crediti nell’app vetkit oppure esegui un Quick Scan gratuito del branch predefinito finché dura la quota mensile.422 ANALYZER_UNAVAILABLE— un controllo inanalyzersnon può essere eseguito su questo server. Chiamavetkit_list_checksoppure passasuites, che seleziona solo i controlli disponibili.INSTALLATION_REQUIREDviene restituito come risultato normale con l’URL di installazione della GitHub App, non come errore.
Note di sicurezza
- Tratta la chiave API come una password. Dà accesso agli audit e ai rilevamenti della tua organizzazione, inclusi i repository privati. Conservala nella configurazione
envdel tuo client MCP, mai in file di cui fai il commit. Concedi solo gli ambiti necessari, imposta una scadenza e revocala dall’app se viene esposta. - La chiave viene inviata solo a
VETKIT_API_URL, come headerAuthorization: Bearersu HTTPS. Il server non la scrive mai nei log né la include nei messaggi di errore. - Il server comunica tramite MCP solo su stdio. Non apre porte di rete e scrive log solo su stderr.
- Gli snippet dei rilevamenti vengono oscurati prima che vetkit li memorizzi; i valori dei segreti non vengono mai restituiti.
- I testi di report e rilevamenti provengono dal repository sottoposto ad audit (percorsi dei file, messaggi). Trattali come input non attendibile, come qualsiasi altro output di uno strumento — un repository malevolo potrebbe tentare di inserire istruzioni rivolte al tuo agente.
Preferisci HTTP diretto? Tutto ciò che fa il server MCP è disponibile tramite l’API REST.