Pular para o conteúdo

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.

Definição de servidor stdio local
{  "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 npx no seu PATH.
  • 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

  1. 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.
  2. Dê à chave um nome que indique onde ela será usada, por exemplo “MCP — notebook”.
  3. Para executar auditorias de repositórios, selecione repos:read, audits:read e audits:run (ou audits:write). Adicione repos:write para conectar repositórios, findings:read para ler achados e reports:read para ler relatórios. Iniciar ou cancelar avaliações de IA exige audits:write. Para um agente somente leitura, selecione apenas escopos de leitura.
  4. Opcionalmente, defina uma expiração e um limite de taxa por minuto (padrão 60, até 600).
  5. 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

Rotacionar uma chave emite um novo segredo e mantém o antigo válido por 24 horas para que você possa fazer a transição. A revogação tem efeito imediato — a próxima requisição retorna 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.

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

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

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

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

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

Instalação global
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcp

Configuração

O servidor é configurado inteiramente por variáveis de ambiente.

VariávelObrigatóriaDescrição
VETKIT_API_KEYSimSua chave de API, vk_live_… ou vk_test_….
VETKIT_API_URLNãoURL base da API. Padrão: https://api.vetkit.dev. Deve usar HTTPS; HTTP simples só é aceito para localhost.
VETKIT_ORG_IDNãoId 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_URLNãoURL 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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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.

Argumentos de exemplo
{}

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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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.
Argumentos de exemplo
{ "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:

.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

O hook só verifica instalações de pacotes. Para analisar alterações, e no Cursor ou em outros clientes sem hooks, adicione uma regra que instrua o agente a chamar 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, atualize VETKIT_API_KEY e reinicie o servidor.
  • 403 INSUFFICIENT_SCOPE — falta à chave um escopo de que a ferramenta precisa.
  • 409 AUDIT_CONCURRENCY_LIMIT e 429 RATE_LIMITED — aguarde e tente novamente; a dica inclui o tempo de espera quando a API envia Retry-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 em analyzers não pode ser executada neste servidor. Chame vetkit_list_checks ou passe suites, 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 env do 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çalho Authorization: Bearer via 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.

Solicite acesso antecipado

Conte um pouco sobre sua equipe e os repositórios que você quer auditar. Recebemos equipes em pequenos grupos e responderemos por e-mail.

Usamos esses dados apenas para responder à sua solicitação. Política de privacidade