Docs · MCP
Servidor MCP do vetkit
Dê ao seu agente de programação um auditor de código. O servidor MCP do vetkit permite que qualquer cliente do Model Context Protocol compatível com stdio conecte repositórios, execute auditorias e leia achados e relatórios.
MCP é um padrão aberto, não uma integração exclusiva do Claude. Configure um servidor stdio local chamado vetkit com a definição abaixo e siga as instruções do cliente. A estrutura de configuração varia. Clientes que aceitam apenas servidores HTTP/SSE remotos não podem se conectar diretamente; o vetkit não oferece um endpoint MCP remoto.
{ "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" }}Depois, peça ao seu agente algo como “Audite acme/payments-api e me diga o que corrigir primeiro.” Recarregue seu cliente e confirme que vetkit_list_repos aparece na lista de ferramentas.
Requisitos
- Node.js 20.3 ou mais recente, com
npxno seuPATH. - Uma conta vetkit e acesso aos repositórios do GitHub, Bitbucket Cloud ou GitLab.com que você quer auditar.
- Uma chave de API do vetkit (próximo passo).
Crie uma chave de API
- Abra Configurações do espaço de trabalho → Chaves de API no app vetkit. Apenas proprietários e administradores da organização podem gerenciar chaves.
- Dê à chave um nome que indique onde ela será usada, por exemplo “MCP — notebook”.
- Para executar auditorias de repositórios, selecione
repos:read,audits:readeaudits:run(ouaudits:write). Adicionerepos:writepara conectar repositórios,findings:readpara ler achados ereports:readpara ler relatórios. Iniciar ou cancelar avaliações de IA exigeaudits:write. Para um agente somente leitura, selecione apenas escopos de leitura. - Opcionalmente, defina uma expiração e um limite de taxa por minuto (padrão 60, até 600).
- Copie o segredo. Ele tem o formato
vk_live_…e é exibido uma única vez; o vetkit armazena apenas um hash.
Rotação e revogação
401 API_KEY_REVOKED.Instalação
Cursor
Adicione a entrada vetkit abaixo a ~/.cursor/mcp.json (global) ou a .cursor/mcp.json em um projeto. Não faça commit de uma configuração de projeto que contenha sua chave.
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}VS Code / GitHub Copilot
Adicione esta entrada a .vscode/mcp.json, preservando os servidores existentes. O VS Code / GitHub Copilot usa servers, não mcpServers. Inicie e autorize o vetkit na lista de servidores MCP. Substitua o marcador da chave e nunca faça commit de uma configuração com seu segredo.
{ "servers": { "vetkit": { "type": "stdio", "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Codex
Adicione estas seções TOML a ~/.codex/config.toml sem substituir as configurações existentes. O Codex CLI e a extensão do IDE compartilham esta configuração. Substitua o marcador da chave, reinicie o cliente e verifique com codex mcp list. Mantenha este arquivo privado.
[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/mcpAdicione --scope user para disponibilizar o vetkit em todos os projetos, e não apenas no atual.
Claude Desktop
Abra Settings → Developer → Edit Config, adicione o vetkit ao claude_desktop_config.json e reinicie o Claude Desktop:
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Outros clientes MCP
Qualquer cliente capaz de iniciar um servidor stdio funciona: execute npx -y @vetkit/mcp com VETKIT_API_KEY no ambiente. Você também pode instalar o pacote globalmente e executar o binário vetkit-mcp diretamente.
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcpConfiguração
O servidor é configurado inteiramente por variáveis de ambiente.
| Variável | Obrigatória | Descrição |
|---|---|---|
VETKIT_API_KEY | Sim | Sua chave de API, vk_live_… ou vk_test_…. |
VETKIT_API_URL | Não | URL base da API. Padrão: https://api.vetkit.dev. Deve usar HTTPS; HTTP simples só é aceito para localhost. |
VETKIT_ORG_ID | Não | Id da organização. Cada chave de API pertence a exatamente uma organização, que é usada por padrão; por isso, você raramente vai precisar disto. |
VETKIT_APP_URL | Não | URL do app web usada nos links para auditorias. Padrão: https://app.vetkit.dev. |
Ferramentas
Toda ferramenta retorna texto legível, e todas, exceto vetkit_get_report, também retornam conteúdo estruturado tipado. As ferramentas têm anotações MCP, para que os clientes possam aprovar automaticamente as que são somente leitura. Nenhuma das ferramentas exclui nada.
vetkit_list_repos
Lista os repositórios conectados à sua organização, com a nota e a pontuação da auditoria mais recente.somente leituraEscopos: repos:read
limitnumber- Tamanho da página, 1–100. Padrão 25.
cursorstring- O valor de nextCursor da página anterior.
| Argumento | Tipo | Descrição |
|---|---|---|
limit | number | Tamanho da página, 1–100. Padrão 25. |
cursor | string | O valor de nextCursor da página anterior. |
{ "limit": 10 }vetkit_connect_repo
Conecta um repositório do GitHub, Bitbucket Cloud ou GitLab.com. Para o GitHub, se o proprietário ainda não instalou o GitHub App do vetkit, retorna o resultado "installation_required" com uma URL de instalação. Repositórios privados do Bitbucket e do GitLab exigem um token de acesso, que o vetkit armazena para auditorias futuras.faz alteraçõesEscopos: repos:write
urlstringobrigatório- URL de um repositório do GitHub, Bitbucket Cloud ou GitLab.com, ou "owner/name" para o GitHub.
accessTokenstring- Token de acesso ao repositório opcional; obrigatório para repositórios privados do Bitbucket ou do GitLab. É enviado ao vetkit e armazenado para auditorias futuras.
| Argumento | Tipo | Descrição |
|---|---|---|
urlobrigatório | string | URL de um repositório do GitHub, Bitbucket Cloud ou GitLab.com, ou "owner/name" para o GitHub. |
accessToken | string | Token de acesso ao repositório opcional; obrigatório para repositórios privados do Bitbucket ou do GitLab. É enviado ao vetkit e armazenado para auditorias futuras. |
{ "url": "https://github.com/acme/payments-api" }vetkit_run_audit
Inicia uma auditoria e, por padrão, aguarda até que ela termine, enviando notificações de progresso. Conecta o repositório primeiro, se necessário. Retorna a nota geral, a nota de cada suíte executada, a pontuação e as contagens de achados. Esta ferramenta não aceita tokens de acesso. Conecte primeiro os repositórios privados do Bitbucket ou do GitLab com vetkit_connect_repo e accessToken.faz alteraçõesEscopos: repos:read, audits:read, audits:run ou audits:write (+ repos:write para conectar automaticamente)
repostringobrigatório- ID do repositório, "owner/name" para o GitHub ou uma URL do GitHub, Bitbucket Cloud ou GitLab.com. URLs do GitHub podem incluir /tree/<branch>.
mode"QUICK" | "FULL"- "QUICK" executa um Quick Scan gratuito (10 por mês por proprietário do espaço de trabalho: posture, gitleaks e osv no commit mais recente da branch padrão). "FULL" executa uma análise completa por 1 crédito, cobrado do proprietário do espaço de trabalho. O padrão é "QUICK", ou "FULL" quando ref, suites ou analyzers são informados.
refstring- Branch, tag ou SHA de commit. O padrão é a ref da URL e, depois, a branch padrão.
suitesstring[]- Escolha entre "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Executa as verificações disponíveis e habilitadas por padrão nas suítes selecionadas; selecionar privacy ou git-history explicitamente também inclui suas verificações opcionais disponíveis. Use analyzers para uma seleção exata. O padrão é a configuração do repositório.
analyzersstring[]- Verificações exatas a executar, por id (veja Verificações abaixo); tem precedência sobre suites. Pelo menos uma verificação além de ai-signal.
excludeAssetsboolean- Não baixar imagens, vídeo, áudio, modelos 3D, fontes, arquivos de design e PDFs. O padrão é a configuração do repositório.
waitboolean- Aguardar um status final. Padrão true.
timeoutSecondsnumber- Espera máxima, 10–1800. Padrão 600. A auditoria continua em execução depois que o tempo limite se esgota.
| Argumento | Tipo | Descrição |
|---|---|---|
repoobrigatório | string | ID do repositório, "owner/name" para o GitHub ou uma URL do GitHub, Bitbucket Cloud ou GitLab.com. URLs do GitHub podem incluir /tree/<branch>. |
mode | "QUICK" | "FULL" | "QUICK" executa um Quick Scan gratuito (10 por mês por proprietário do espaço de trabalho: posture, gitleaks e osv no commit mais recente da branch padrão). "FULL" executa uma análise completa por 1 crédito, cobrado do proprietário do espaço de trabalho. O padrão é "QUICK", ou "FULL" quando ref, suites ou analyzers são informados. |
ref | string | Branch, tag ou SHA de commit. O padrão é a ref da URL e, depois, a branch padrão. |
suites | string[] | Escolha entre "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Executa as verificações disponíveis e habilitadas por padrão nas suítes selecionadas; selecionar privacy ou git-history explicitamente também inclui suas verificações opcionais disponíveis. Use analyzers para uma seleção exata. O padrão é a configuração do repositório. |
analyzers | string[] | Verificações exatas a executar, por id (veja Verificações abaixo); tem precedência sobre suites. Pelo menos uma verificação além de ai-signal. |
excludeAssets | boolean | Não baixar imagens, vídeo, áudio, modelos 3D, fontes, arquivos de design e PDFs. O padrão é a configuração do repositório. |
wait | boolean | Aguardar um status final. Padrão true. |
timeoutSeconds | number | Espera máxima, 10–1800. Padrão 600. A auditoria continua em execução depois que o tempo limite se esgota. |
{ "repo": "acme/payments-api", "ref": "main", "suites": ["security"] }vetkit_list_checks
Lista todas as verificações agrupadas por suíte, com a ferramenta e a versão que cada uma usa, se está disponível no servidor e quais são executadas por padrão.somente leituraEscopos: audits:read
Sem argumentos.
| Argumento | Tipo | Descrição |
|---|---|---|
| Sem argumentos. | ||
{}vetkit_get_audit
Retorna o status, as notas geral e por suíte, a pontuação, as contagens de achados e o progresso de cada verificação — incluindo métricas como a proporção de código duplicado, a complexidade média, a proporção teste/código e o bus factor — de uma auditoria.somente leituraEscopos: audits:read
auditIduuidobrigatório- O id da auditoria retornado por vetkit_run_audit.
| Argumento | Tipo | Descrição |
|---|---|---|
auditIdobrigatório | uuid | O id da auditoria retornado por vetkit_run_audit. |
{ "auditId": "0192f3a4-5b6c-7d8e-9f01-23456789abcd" }vetkit_list_findings
Lista os achados de uma auditoria, dos mais graves para os menos graves. Retorna uma tabela compacta como texto e os detalhes completos — mensagem, trecho mascarado, correção, referências — como conteúdo estruturado.somente leituraEscopos: findings:read
auditIduuidobrigatório- A auditoria a ser lida.
severitystring[]- CRITICAL, HIGH, MEDIUM, LOW ou INFO.
suitestring- SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY ou GIT_HISTORY: somente os achados dessa suíte.
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 (introduzido desde a auditoria anterior) ou EXISTING.
limitnumber- Tamanho da página, 1–100. Padrão 25.
cursorstring- O valor de nextCursor da página anterior.
| Argumento | Tipo | Descrição |
|---|---|---|
auditIdobrigatório | uuid | A auditoria a ser lida. |
severity | string[] | CRITICAL, HIGH, MEDIUM, LOW ou INFO. |
suite | string | SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY ou GIT_HISTORY: somente os achados dessa suíte. |
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 ou PRIVACY_LIFECYCLE. |
status | string | NEW (introduzido desde a auditoria anterior) ou EXISTING. |
limit | number | Tamanho da página, 1–100. Padrão 25. |
cursor | string | O valor de nextCursor da página anterior. |
{ "auditId": "0192f3a4-…", "severity": ["CRITICAL", "HIGH"] }vetkit_suggest_fix
Propõe um patch mínimo para um achado de código (SAST, segredos, app LLM, IaC) com o provedor de IA que sua organização salvou no vetkit, ou uma correção baseada em regra quando o analisador fornece uma. Retorna um diff unificado, uma explicação, um nível de confiança e um status de verificação. Apenas uma janela mascarada de cerca de 60 linhas é enviada ao provedor. Nada é gravado: nenhum branch, commit ou pull request. Exige uma chave criada por um administrador da organização.somente leituraEscopos: findings:write
findingIduuidobrigatório- Id de um achado de código, de vetkit_list_findings.
providerstring- Provedor de IA salvo a usar. O padrão é a primeira conexão verificada.
| Argumento | Tipo | Descrição |
|---|---|---|
findingIdobrigatório | uuid | Id de um achado de código, de vetkit_list_findings. |
provider | string | Provedor de IA salvo a usar. O padrão é a primeira conexão verificada. |
{ "findingId": "0193b2c4-…" }vetkit_triage_findings
Pergunta ao provedor de IA salvo da sua organização se até 20 achados de uma auditoria são provavelmente verdadeiros ou falsos positivos. Cada um recebe um veredito, uma confiança e uma justificativa curta que cita uma linha do código-fonte. Os veredictos são consultivos: ajustam a prioridade, mas nunca suprimem um achado nem alteram a pontuação. Exige um plano pago.faz alteraçõesEscopos: findings:write
auditIduuidobrigatório- A auditoria à qual os achados pertencem.
findingIdsuuid[]obrigatório- Até 20 ids de achados de vetkit_list_findings.
| Argumento | Tipo | Descrição |
|---|---|---|
auditIdobrigatório | uuid | A auditoria à qual os achados pertencem. |
findingIdsobrigatório | uuid[] | Até 20 ids de achados de vetkit_list_findings. |
{ "auditId": "0192f3a4-…", "findingIds": ["0193b2c4-…"] }vetkit_get_report
Retorna o relatório de uma auditoria concluída: Markdown legível, um resumo em JSON com as pontuações por suíte e por categoria e o diff em relação à auditoria anterior, ou SARIF 2.1.0.somente leituraEscopos: reports:read
auditIduuidobrigatório- A auditoria a ser lida.
formatstring- markdown (padrão), json ou sarif.
maxCharsnumber- Trunca a saída acima deste número de caracteres, 2.000–500.000. Padrão 40.000.
| Argumento | Tipo | Descrição |
|---|---|---|
auditIdobrigatório | uuid | A auditoria a ser lida. |
format | string | markdown (padrão), json ou sarif. |
maxChars | number | Trunca a saída acima deste número de caracteres, 2.000–500.000. Padrão 40.000. |
{ "auditId": "0192f3a4-…", "format": "markdown" }vetkit_get_standards_report
Mapeia os achados abertos de uma auditoria para OWASP Top 10 (2021 ou 2025), CWE Top 25 (2024) ou OWASP Top 10 for LLM Applications (2025). Cada categoria fica como fail, pass (nenhum achado mapeado de verificações capazes de detectá-la) ou not covered. Um apoio de mapeamento, não uma certificação de conformidade.somente leituraEscopos: reports:read, findings:read
auditIduuidobrigatório- A auditoria a mapear.
standardstringobrigatório- owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 ou owasp-llm-top10-2025.
| Argumento | Tipo | Descrição |
|---|---|---|
auditIdobrigatório | uuid | A auditoria a mapear. |
standardobrigatório | string | owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 ou owasp-llm-top10-2025. |
{ "auditId": "0192f3a4-…", "standard": "owasp-top10-2021" }vetkit_check_packages
Chame antes de instalar uma dependência. Verifica até 50 pacotes de um ecossistema no registro público, nos avisos do OSV (incluindo pacotes maliciosos conhecidos), no CISA KEV e na política da sua organização, e retorna allow, warn ou block com os motivos.somente leituraEscopos: agent:check
ecosystemstringobrigatório- npm, pypi, cargo, go, rubygems, nuget ou maven. Use pypi para pip e uv.
packagesobject[]obrigatório- Até 50 pacotes: um nome (Maven group:artifact, caminho do módulo Go) e uma versão exata opcional.
| Argumento | Tipo | Descrição |
|---|---|---|
ecosystemobrigatório | string | npm, pypi, cargo, go, rubygems, nuget ou maven. Use pypi para pip e uv. |
packagesobrigatório | object[] | Até 50 pacotes: um nome (Maven group:artifact, caminho do módulo Go) e uma versão exata opcional. |
{ "ecosystem": "npm", "packages": [{ "name": "left-pad", "version": "1.3.0" }] }vetkit_scan_changes
Chame antes de fazer commit. Analisa em memória até 30 arquivos alterados (512 KB no total) em busca de segredos com formato exato, configuração de agente arriscada e instruções ocultas, código inacabado e imports de pacotes que não existem. Nada é armazenado ou executado.somente leituraEscopos: agent:check
filesobject[]obrigatório- Arquivos alterados: um caminho relativo ao repositório, como src/app.ts, e o conteúdo UTF-8 completo.
| Argumento | Tipo | Descrição |
|---|---|---|
filesobrigatório | object[] | Arquivos alterados: um caminho relativo ao repositório, como src/app.ts, e o conteúdo UTF-8 completo. |
{ "files": [{ "path": "src/config.ts", "content": "…" }] }Proteções para agentes
Duas ferramentas permitem que um agente de programação verifique o próprio trabalho antes de agir: vetkit_check_packages antes de instalar uma dependência e vetkit_scan_changes antes de fazer commit. Ambas exigem uma chave de API com o escopo agent:check.
Ambas retornam um veredito allow, warn ou block com os motivos. Block: o pacote não existe (um nome alucinado ou de slopsquatting), tem um registro de pacote malicioso conhecido no OSV, tem um aviso do CISA KEV quando sua política bloqueia vulnerabilidades sabidamente exploradas, usa uma licença da lista de bloqueio da sua organização, ou a alteração contém um segredo commitado. Warn: uma versão não publicada, um lançamento muito recente, baixa adoção, um aviso igual ou acima da severidade mínima da sua política ou outros achados de código. Fontes inacessíveis aparecem como avisos; essas verificações são ignoradas, nunca presumidas.
Hook do Claude Code
vetkit-mcp hook pre-tool-use lê a entrada PreToolUse do Claude Code, encontra instalações de pacotes em comandos Bash e sai com o código 2 quando o vetkit bloqueia um pacote, para que o Claude Code interrompa o comando e mostre o motivo. Caso contrário, sai com 0 e exibe eventuais avisos. Em caso de erro, não bloqueia: sem VETKIT_API_KEY, ou quando a API não pode ser acessada, ele avisa e deixa o comando rodar. Adicione-o a .claude/settings.json:
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "npx -y @vetkit/mcp hook pre-tool-use", "timeout": 30 } ] } ] }}Defina VETKIT_API_KEY no seu shell com uma chave que tenha o escopo agent:check, não em um arquivo commitado.
Cursor e outros clientes
vetkit_check_packages antes de instalar e vetkit_scan_changes antes de fazer commit. A página MCP do app vetkit tem uma regra pronta para o Cursor.Verificações
Há cinco suítes com pontuação, além das suítes opcionais Privacidade e proteção de dados (beta) e Histórico do Git, que não afetam a nota. Cada suíte pontuada recebe a própria nota, e a pontuação geral atribui 43% a Segurança, 18% a Qualidade do código, 11% a Sustentabilidade, 13% a Riscos de código de IA e 15% a Prontidão para produção — só as suítes executadas contam, e os pesos são redistribuídos entre elas (Segurança 50%, Qualidade do código 22%, Sustentabilidade 13% e Riscos de código de IA 15% sem Prontidão para produção; Segurança 70% e Qualidade do código 30% quando só essas duas são executadas). Passe ids de verificações em analyzers ou uma suíte em suites.
Segurança
- Id da verificação:
postureArquivos .env commitados, chaves privadas e keystores, manifestos sem lockfile, ausência de política de segurança.Categoria: SECRETS, DEPENDENCIES, SECURITY - Id da verificação:
gitleaksChaves de API, tokens, senhas e chaves privadas no código-fonte.Categoria: SECRETS - Id da verificação:
secrets-historyCredenciais commitadas e removidas depois que ainda podem ser recuperadas do histórico do git. Desativada por padrão.Categoria: SECRETS - Id da verificação:
osvCVEs conhecidas, pacotes maliciosos e alertas de vulnerabilidades exploradas ativamente (CISA KEV) nas dependências fixadas por lockfiles.Categoria: DEPENDENCIES - Id da verificação:
vendoredBibliotecas JavaScript com vulnerabilidades conhecidas copiadas para o repositório.Categoria: DEPENDENCIES - Id da verificação:
eolRuntimes, frameworks e imagens base de contêiner em fim de vida.Categoria: DEPENDENCIES - Id da verificação:
supply-chainInjeção em lockfiles, registros inseguros, scripts de instalação arriscados, Trojan Source e executáveis commitados.Categoria: DEPENDENCIES, SECURITY - Id da verificação:
sastRegras de segurança de código selecionadas para as linguagens compatíveis e configurações inseguras de servidor, dispositivos móveis e shell.Categoria: SECURITY - Id da verificação:
sast-communityPacotes adicionais de regras da comunidade com licenças permissivas. Desativada por padrão; beta.Categoria: SECURITY - Id da verificação:
iacConfigurações incorretas em Terraform, CloudFormation, Kubernetes, Helm e Dockerfiles (Trivy).Categoria: INFRASTRUCTURE - Id da verificação:
workflowsInjeção de scripts no GitHub Actions, permissões amplas demais, actions sem versão fixada e pwn requests (zizmor).Categoria: INFRASTRUCTURE
Qualidade do código
- Id da verificação:
code-smellsErros silenciados, instruções de depuração esquecidas, comparações suspeitas e outros trechos propensos a erros.Categoria: QUALITY - Id da verificação:
complexityFunções com alta complexidade ciclomática, aninhamento profundo, corpo longo ou listas de parâmetros longas.Categoria: MAINTAINABILITY - Id da verificação:
duplicationBlocos de código copiados e colados entre arquivos.Categoria: DUPLICATION - Id da verificação:
testsSuítes de testes ausentes ou escassas, arquivos grandes sem testes, testes focados ou ignorados, testes sem asserções, CI que nunca executa os testes.Categoria: TESTING - Id da verificação:
docsREADMEs sem instruções de instalação ou uso, APIs públicas não documentadas, pacotes publicados sem changelog.Categoria: DOCUMENTATION - Id da verificação:
hygieneREADME, LICENSE, CI e .gitignore; saída de build commitada, dependências embutidas no repositório e arquivos grandes.Categoria: HYGIENE
Sustentabilidade
- Id da verificação:
licensesDependências com licenças copyleft (GPL, AGPL), de uso restrito ou desconhecidas que entram em conflito com a licença do projeto.Categoria: LICENSES - Id da verificação:
dep-healthDependências diretas descontinuadas, defasadas em duas ou mais versões major ou que não recebem mais novas versões.Categoria: DEPENDENCY_HEALTH - Id da verificação:
activityRepositórios parados, risco de mantenedor único (bus factor) e arquivos grandes alterados com frequência.Categoria: ACTIVITY
Riscos de código de IA
- Id da verificação:
hallucinated-depsDependências e imports que não existem no registro público (alvos de slopsquatting), versões que nunca foram publicadas, pacotes publicados pela primeira vez nos últimos 30 dias e imports ausentes do package.json.Categoria: HALLUCINATION - Id da verificação:
ai-slopStubs, placeholders do tipo “resto do código”, dados mock e credenciais de placeholder em caminhos de produção, arquivos duplicados com sufixo de cópia e supressões genéricas de tipos ou de lint.Categoria: UNFINISHED_CODE - Id da verificação:
vibe-stackTabelas do Supabase sem segurança em nível de linha (RLS), segredos em variáveis de ambiente públicas, rotas de API sem autenticação e controles de acesso feitos apenas no cliente.Categoria: VIBE_STACK - Id da verificação:
llm-appCaminhos de injeção de prompt, saída de LLM chegando a execução de código, SQL ou HTML, chaves de API de LLM no código do cliente, chamadas ao modelo sem limite e configuração arriscada de agentes de IA.Categoria: LLM_SECURITY - Id da verificação:
ai-signalSinal heurístico de autoria por IA. Beta, informativo, nunca pontuado; somente quando habilitado no servidor.Categoria: AI_SIGNAL
Prontidão para produção
- Id da verificação:
resilienceChamadas HTTP de saída sem tempo limite, chamadas bloqueantes no caminho da requisição e em funções async, clientes de banco de dados criados a cada requisição.Categoria: RESILIENCE - Id da verificação:
data-accessConsultas dentro de loops (N+1), endpoints de listagem sem paginação, chaves estrangeiras sem índice, sincronização do schema na inicialização que pode apagar dados.Categoria: DATABASE - Id da verificação:
operabilityServiços implantados que rodam um servidor de desenvolvimento, verificam senhas sem limite de taxa no login ou não têm desligamento gracioso, health check nem rastreamento de erros.Categoria: OPERABILITY
Auditorias demoradas
A maioria das auditorias termina em poucos minutos. vetkit_run_audit consulta o status a cada poucos segundos e envia notificações de progresso enquanto aguarda. Alguns clientes cancelam chamadas de ferramenta após um tempo fixo — o Claude Code, por exemplo, respeita MCP_TOOL_TIMEOUT. Se for o caso do seu, passe "wait": false e consulte com vetkit_get_audit. Quando timeoutSeconds se esgota, a auditoria continua em execução e a ferramenta retorna "outcome": "still_running".
Erros
Os erros da API voltam como resultados de ferramenta com isError: true e incluem o status HTTP, o código de erro do vetkit, a mensagem, o id da requisição e uma dica.
401 API_KEY_INVALID,API_KEY_REVOKED,API_KEY_EXPIRED— crie ou rotacione uma chave, atualizeVETKIT_API_KEYe reinicie o servidor.403 INSUFFICIENT_SCOPE— falta à chave um escopo de que a ferramenta precisa.409 AUDIT_CONCURRENCY_LIMITe429 RATE_LIMITED— aguarde e tente novamente; a dica inclui o tempo de espera quando a API enviaRetry-After.402 INSUFFICIENT_CREDITS— uma análise completa precisa de 1 crédito do proprietário do espaço de trabalho. Solicite mais créditos no app vetkit ou execute um Quick Scan gratuito da branch padrão enquanto durar a cota mensal.422 ANALYZER_UNAVAILABLE— uma verificação emanalyzersnão pode ser executada neste servidor. Chamevetkit_list_checksou passesuites, que seleciona apenas verificações disponíveis.INSTALLATION_REQUIREDé retornado como um resultado normal com a URL de instalação do GitHub App, e não como erro.
Notas de segurança
- Trate a chave de API como uma senha. Ela dá acesso às auditorias e aos achados da sua organização, incluindo repositórios privados. Mantenha-a na configuração
envdo seu cliente MCP, nunca em arquivos que você commita. Conceda apenas os escopos de que você precisa, defina uma expiração e revogue-a no app se ela vazar. - A chave é enviada apenas para
VETKIT_API_URL, como um cabeçalhoAuthorization: Bearervia HTTPS. O servidor nunca a registra em log nem a inclui em mensagens de erro. - O servidor fala MCP apenas via stdio. Ele não abre portas de rede e grava logs apenas em stderr.
- Os trechos dos achados são mascarados antes de o vetkit armazená-los; valores de segredos nunca são retornados.
- O texto de relatórios e achados vem do repositório auditado (caminhos de arquivo, mensagens). Trate-o como entrada não confiável, como qualquer outra saída de ferramenta — um repositório malicioso pode tentar embutir instruções direcionadas ao seu agente.
Prefere HTTP puro? Tudo o que o servidor MCP faz está disponível pela API REST.