Vai al contenuto

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.

Definizione di server stdio locale
{  "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 npx nel tuo PATH.
  • 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

  1. Apri Impostazioni dello spazio di lavoro → Chiavi API nell’app vetkit. Solo i proprietari e gli amministratori dell’organizzazione possono gestire le chiavi.
  2. Dai alla chiave un nome che indichi dove verrà usata, ad esempio “MCP — laptop”.
  3. Per eseguire audit dei repository, seleziona repos:read, audits:read e audits:run (o audits:write). Aggiungi repos:write per collegare repository, findings:read per leggere i risultati e reports:read per leggere i report. Avviare o annullare valutazioni IA richiede audits:write. Per un agente in sola lettura, seleziona solo ambiti di lettura.
  4. Facoltativamente, imposta una scadenza e un limite di frequenza al minuto (predefinito 60, fino a 600).
  5. Copia il segreto. Ha la forma vk_live_… e viene mostrato una sola volta; vetkit ne memorizza solo un hash.

Rotazione e revoca

La rotazione di una chiave genera un nuovo segreto e mantiene valido quello vecchio per 24 ore, così hai il tempo di distribuire quello nuovo. La revoca ha effetto immediato — la richiesta successiva restituisce 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.

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

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

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

Claude Code

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

Aggiungi --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:

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

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

Configurazione

Il server si configura interamente tramite variabili d’ambiente.

VariabileObbligatoriaDescrizione
VETKIT_API_KEYSìLa tua chiave API, vk_live_… o vk_test_….
VETKIT_API_URLNoURL di base dell’API. Predefinito https://api.vetkit.dev. Deve essere HTTPS; HTTP semplice è accettato solo per localhost.
VETKIT_ORG_IDNoID dell’organizzazione. Ogni chiave API appartiene esattamente a un’organizzazione, che viene usata per impostazione predefinita, quindi raramente ti servirà.
VETKIT_APP_URLNoURL 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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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.

Argomenti di esempio
{}

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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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.
Argomenti di esempio
{ "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:

.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

L’hook controlla solo le installazioni di pacchetti. Per analizzare le modifiche, e in Cursor o in altri client senza hook, aggiungi una regola che chieda all’agente di chiamare 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, aggiorna VETKIT_API_KEY e riavvia il server.
  • 403 INSUFFICIENT_SCOPE — alla chiave manca un ambito richiesto dallo strumento.
  • 409 AUDIT_CONCURRENCY_LIMIT e 429 RATE_LIMITED — attendi e riprova; il suggerimento include il tempo di attesa quando l’API invia Retry-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 in analyzers non può essere eseguito su questo server. Chiama vetkit_list_checks oppure passa suites, che seleziona solo i controlli disponibili.
  • INSTALLATION_REQUIRED viene 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 env del 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 header Authorization: Bearer su 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.

Richiedi l’accesso anticipato

Raccontaci qualcosa del tuo team e dei repository che vuoi sottoporre ad audit. Accogliamo i team a piccoli gruppi e ti risponderemo via email.

Usiamo questi dati solo per rispondere alla tua richiesta. Informativa sulla privacy