İçeriğe atla

Dokümantasyon · MCP

vetkit MCP sunucusu

Kodlama ajanınıza bir kod denetçisi kazandırın. vetkit MCP sunucusu, stdio destekleyen tüm Model Context Protocol istemcilerinin depo bağlamasını, denetim çalıştırmasını, bulguları ve raporları okumasını sağlar.

MCP açık bir standarttır; Claude’a özel değildir. Aşağıdaki tanımla vetkit adlı yerel bir stdio sunucusu yapılandırın ve istemcinizin kurulum adımlarını izleyin. Kapsayıcı yapılandırma biçimi istemciye göre değişir. Yalnızca uzak HTTP/SSE sunucularını kabul eden istemciler doğrudan bağlanamaz; vetkit uzak bir MCP uç noktası sunmaz.

Yerel stdio sunucu tanımı
{  "command": "npx",  "args": [    "-y",    "@vetkit/mcp"  ],  "env": {    "VETKIT_API_KEY": "<your-api-key>"  }}

Ardından ajanınıza “acme/payments-api deposunu denetle ve önce neyi düzeltmem gerektiğini söyle.” gibi bir şey sorun. İstemcinizi yeniden yükleyip araç listesinde vetkit_list_repos göründüğünü doğrulayın.

Gereksinimler

  • Node.js 20.3 veya daha yeni bir sürüm; npx komutu PATH üzerinde erişilebilir olmalıdır.
  • Bir vetkit hesabı ve denetlemek istediğiniz GitHub, Bitbucket Cloud veya GitLab.com depolarına erişim.
  • Bir vetkit API anahtarı (sonraki adım).

API anahtarı oluşturun

  1. vetkit uygulamasında Çalışma alanı ayarları → API anahtarları sayfasını açın. Anahtarları yalnızca kuruluş sahipleri ve yöneticileri yönetebilir.
  2. Anahtara, kullanılacağı yeri belirten bir ad verin; örneğin “MCP — dizüstü”.
  3. Depo denetimleri çalıştırmak için repos:read, audits:read ve audits:run (veya audits:write) seçin. Depo bağlamak için repos:write, bulguları okumak için findings:read, raporları okumak için reports:read ekleyin. AI Evaluation başlatmak veya iptal etmek audits:write gerektirir. Salt okunur bir ajan için yalnızca okuma kapsamlarını seçin.
  4. İsteğe bağlı olarak bir son kullanma tarihi ve dakika başına hız sınırı belirleyin (varsayılan 60, en fazla 600).
  5. Gizli değeri kopyalayın. vk_live_… biçimindedir ve bir kez gösterilir; vetkit yalnızca hash’ini saklar.

Yenileme ve iptal

Bir anahtarı yenilemek yeni bir gizli değer oluşturur ve geçişi yapabilmeniz için eski değeri 24 saat boyunca geçerli tutar. İptal hemen geçerli olur — sonraki istek 401 API_KEY_REVOKED döndürür.

Kurulum

Cursor

Aşağıdaki vetkit kaydını ~/.cursor/mcp.json (genel) dosyasına veya bir projedeki .cursor/mcp.json dosyasına ekleyin. Anahtarınızı içeren bir proje yapılandırmasını commit etmeyin.

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

VS Code / GitHub Copilot

Mevcut sunucularınızı koruyarak bu kaydı .vscode/mcp.json dosyasına ekleyin. VS Code / GitHub Copilot, mcpServers yerine servers kullanır. MCP sunucu listesinden vetkit’i başlatıp onaylayın. Anahtar yer tutucusunu değiştirin ve gizli anahtar içeren dosyayı asla commit etmeyin.

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

Codex

Mevcut ayarları silmeden bu TOML bölümlerini ~/.codex/config.toml dosyasına ekleyin. Codex CLI ve IDE eklentisi aynı yapılandırmayı kullanır. Anahtar yer tutucusunu değiştirin, istemciyi yeniden başlatın ve codex mcp list ile doğrulayın. Bu dosyayı gizli tutun.

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

vetkit’i yalnızca geçerli projede değil, tüm projelerde kullanılabilir hale getirmek için --scope user ekleyin.

Claude Desktop

Settings → Developer → Edit Config menüsünü açın, vetkit’i claude_desktop_config.json dosyasına ekleyin ve ardından Claude Desktop’ı yeniden başlatın:

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

Diğer MCP istemcileri

stdio sunucusu başlatabilen her istemci çalışır: ortam değişkenlerinde VETKIT_API_KEY tanımlıyken npx -y @vetkit/mcp komutunu çalıştırın. Paketi global olarak kurup vetkit-mcp çalıştırılabilir dosyasını doğrudan da çalıştırabilirsiniz.

Global kurulum
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcp

Yapılandırma

Sunucu tamamen ortam değişkenleriyle yapılandırılır.

DeğişkenZorunluAçıklama
VETKIT_API_KEYEvetAPI anahtarınız: vk_live_… veya vk_test_….
VETKIT_API_URLHayırAPI temel URL’si. Varsayılan: https://api.vetkit.dev. HTTPS olmalıdır; düz HTTP yalnızca localhost için kabul edilir.
VETKIT_ORG_IDHayırKuruluş kimliği. Her API anahtarı tam olarak bir kuruluşa aittir ve varsayılan olarak o kuruluş kullanılır; bu nedenle buna nadiren ihtiyaç duyarsınız.
VETKIT_APP_URLHayırDenetim bağlantıları için kullanılan web uygulaması URL’si. Varsayılan: https://app.vetkit.dev.

Araçlar

Her araç okunabilir metin döndürür; vetkit_get_report dışındaki tüm araçlar ayrıca tipli, yapılandırılmış içerik de döndürür. Araçlar MCP ek açıklamaları taşır, böylece istemciler salt okunur olanları otomatik olarak onaylayabilir. Araçların hiçbiri bir şey silmez.

vetkit_list_repos

Kuruluşunuza bağlı depoları, en son denetimin notu ve puanıyla birlikte listeler.salt okunurKapsamlar: repos:read
limitnumber
Sayfa boyutu, 1–100. Varsayılan 25.
cursorstring
Önceki sayfadaki nextCursor değeri.
Örnek argümanlar
{ "limit": 10 }

vetkit_connect_repo

Bir GitHub, Bitbucket Cloud veya GitLab.com deposunu bağlar. GitHub için vetkit GitHub App depo sahibinde henüz kurulu değilse, kurulum URL’siyle birlikte "installation_required" sonucunu döndürür. Özel Bitbucket ve GitLab depoları erişim token’ı gerektirir; vetkit bu token’ı sonraki denetimler için saklar.yazmaKapsamlar: repos:write
urlstringzorunlu
GitHub, Bitbucket Cloud veya GitLab.com depo URL’si; GitHub için "owner/name" da kullanılabilir.
accessTokenstring
İsteğe bağlı depo erişim token’ı; özel Bitbucket veya GitLab depoları için zorunludur. vetkit’e gönderilir ve sonraki denetimler için saklanır.
Örnek argümanlar
{ "url": "https://github.com/acme/payments-api" }

vetkit_run_audit

Bir denetim başlatır ve varsayılan olarak ilerleme bildirimleri göndererek tamamlanmasını bekler. Gerekirse önce depoyu bağlar. Genel notu, çalışan her grubun notunu, puanı ve bulgu sayılarını döndürür. Bu araç erişim token’ı kabul etmez. Özel Bitbucket veya GitLab depolarını önce vetkit_connect_repo aracında accessToken kullanarak bağlayın.yazmaKapsamlar: repos:read, audits:read, audits:run veya audits:write (otomatik bağlama için + repos:write)
repostringzorunlu
Depo kimliği, GitHub için "owner/name" veya bir GitHub, Bitbucket Cloud ya da GitLab.com URL’si. GitHub URL’leri /tree/<branch> içerebilir.
mode"QUICK" | "FULL"
"QUICK" ücretsiz bir Quick Scan çalıştırır (çalışma alanı sahibi başına ayda 10: varsayılan dalın son commit'inde posture, gitleaks ve osv). "FULL" çalışma alanı sahibinden düşülen 1 kredi karşılığında tam tarama çalıştırır. Varsayılan "QUICK"tır; ref, suites veya analyzers verilirse "FULL" olur.
refstring
Dal, etiket veya commit SHA’sı. Varsayılan olarak URL’deki ref, o da yoksa varsayılan dal kullanılır.
suitesstring[]
"security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history" değerlerinden seçin. Seçilen gruplarda kullanılabilir ve varsayılan olarak açık kontroller çalışır; privacy veya git-history açıkça seçilirse bu grupların isteğe bağlı kullanılabilir kontrolleri de çalışır. Kesin kontrol seçimi için analyzers kullanın. Varsayılan olarak depo ayarı kullanılır.
analyzersstring[]
Çalıştırılacak kontrollerin kimlikleriyle tam listesi (aşağıdaki Kontroller bölümüne bakın); suites değerini geçersiz kılar. ai-signal dışında en az bir kontrol içermelidir.
excludeAssetsboolean
Görseller, video, ses, 3D modeller, fontlar, tasarım dosyaları ve PDF’ler indirilmez. Varsayılan olarak depo ayarı kullanılır.
waitboolean
Nihai bir durumu bekler. Varsayılan true.
timeoutSecondsnumber
En uzun bekleme süresi, 10–1800. Varsayılan 600. Zaman aşımından sonra denetim çalışmaya devam eder.
Örnek argümanlar
{ "repo": "acme/payments-api", "ref": "main", "suites": ["security"] }

vetkit_list_checks

Tüm kontrolleri ait oldukları gruba göre listeler; her kontrolün kullandığı aracı ve sürümünü, sunucuda kullanılabilir olup olmadığını ve hangi kontrollerin varsayılan olarak çalıştığını gösterir.salt okunurKapsamlar: audits:read

Argüman yok.

Örnek argümanlar
{}

vetkit_get_audit

Bir denetimin durumunu, genel ve grup bazında notlarını, puanını, bulgu sayılarını ve kontrol bazında ilerlemesini döndürür — tekrarlanan kod oranı, ortalama karmaşıklık, test/kod oranı ve bus factor gibi metrikler dahil.salt okunurKapsamlar: audits:read
auditIduuidzorunlu
vetkit_run_audit tarafından döndürülen denetim kimliği.
Örnek argümanlar
{ "auditId": "0192f3a4-5b6c-7d8e-9f01-23456789abcd" }

vetkit_list_findings

Bir denetimin bulgularını en ciddi olandan başlayarak listeler. Metin olarak kompakt bir tablo, yapılandırılmış içerik olarak da tüm ayrıntıları — mesaj, maskelenmiş kod parçası, düzeltme önerisi, referanslar — döndürür.salt okunurKapsamlar: findings:read
auditIduuidzorunlu
Okunacak denetim.
severitystring[]
CRITICAL, HIGH, MEDIUM, LOW veya INFO.
suitestring
SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY veya GIT_HISTORY: yalnızca o grubun bulguları.
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 veya PRIVACY_LIFECYCLE.
statusstring
NEW (önceki denetimden bu yana ortaya çıkan) veya EXISTING.
limitnumber
Sayfa boyutu, 1–100. Varsayılan 25.
cursorstring
Önceki sayfadaki nextCursor değeri.
Örnek argümanlar
{ "auditId": "0192f3a4-…", "severity": ["CRITICAL", "HIGH"] }

vetkit_suggest_fix

Bir kod bulgusu (SAST, gizli bilgiler, LLM uygulaması, IaC) için kuruluşunuzun vetkit’e kaydettiği yapay zekâ sağlayıcısıyla ya da analiz aracı bir düzeltme sunuyorsa kural tabanlı düzeltmeyle en küçük yamayı önerir. Unified diff, açıklama, güven düzeyi ve doğrulama durumu döndürür. Sağlayıcıya yalnızca yaklaşık 60 satırlık maskelenmiş bir pencere gönderilir. Hiçbir şey yazılmaz: dal, commit veya pull request oluşturulmaz. Bir kuruluş yöneticisinin oluşturduğu anahtar gerekir.salt okunurKapsamlar: findings:write
findingIduuidzorunlu
vetkit_list_findings ile alınan kod bulgusunun kimliği.
providerstring
Kullanılacak kayıtlı yapay zekâ sağlayıcısı. Varsayılan, doğrulanmış ilk bağlantıdır.
Örnek argümanlar
{ "findingId": "0193b2c4-…" }

vetkit_triage_findings

Kuruluşunuzun kayıtlı yapay zekâ sağlayıcısına bir denetimin en fazla 20 bulgusunun büyük olasılıkla gerçek mi yoksa yanlış pozitif mi olduğunu sorar. Her bulgu bir karar, bir güven değeri ve bir kaynak satırını alıntılayan kısa bir gerekçe alır. Kararlar tavsiye niteliğindedir: önceliği ayarlar ama bulguyu asla bastırmaz ve puanı değiştirmez. Ücretli plan gerekir.yazmaKapsamlar: findings:write
auditIduuidzorunlu
Bulguların ait olduğu denetim.
findingIdsuuid[]zorunlu
vetkit_list_findings ile alınan en fazla 20 bulgu kimliği.
Örnek argümanlar
{ "auditId": "0192f3a4-…", "findingIds": ["0193b2c4-…"] }

vetkit_get_report

Tamamlanmış bir denetimin raporunu döndürür: okunabilir Markdown, grup ve kategori puanlarını ve önceki denetime göre farkları içeren bir JSON özeti ya da SARIF 2.1.0.salt okunurKapsamlar: reports:read
auditIduuidzorunlu
Okunacak denetim.
formatstring
markdown (varsayılan), json veya sarif.
maxCharsnumber
Çıktıyı bu karakter sayısından sonra kısaltır, 2.000–500.000. Varsayılan 40.000.
Örnek argümanlar
{ "auditId": "0192f3a4-…", "format": "markdown" }

vetkit_get_standards_report

Bir denetimin açık bulgularını OWASP Top 10 (2021 veya 2025), CWE Top 25 (2024) ya da OWASP Top 10 for LLM Applications (2025) ile eşler. Her kategori fail, pass (onu tespit edebilen kontrollerden eşlenmiş bulgu yok) veya not covered olur. Bir eşleme yardımcısıdır, uyumluluk sertifikası değildir.salt okunurKapsamlar: reports:read, findings:read
auditIduuidzorunlu
Eşlenecek denetim.
standardstringzorunlu
owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 veya owasp-llm-top10-2025.
Örnek argümanlar
{ "auditId": "0192f3a4-…", "standard": "owasp-top10-2021" }

vetkit_check_packages

Bir bağımlılığı kurmadan önce çağırın. Tek bir ekosistemden en fazla 50 paketi genel paket kayıt deposuna, OSV güvenlik bildirimlerine (bilinen kötü amaçlı paketler dahil), CISA KEV’e ve kuruluşunuzun politikasına karşı kontrol eder; gerekçeleriyle allow, warn veya block döndürür.salt okunurKapsamlar: agent:check
ecosystemstringzorunlu
npm, pypi, cargo, go, rubygems, nuget veya maven. pip ve uv için pypi kullanın.
packagesobject[]zorunlu
En fazla 50 paket: ad (Maven için group:artifact, Go için modül yolu) ve isteğe bağlı tam sürüm.
Örnek argümanlar
{ "ecosystem": "npm", "packages": [{ "name": "left-pad", "version": "1.3.0" }] }

vetkit_scan_changes

Commit etmeden önce çağırın. Değişen en fazla 30 dosyayı (toplam 512 KB) bellekte tarar: biçimi tam eşleşen gizli bilgiler, riskli ajan yapılandırması ve gizli talimatlar, bitmemiş kod ve var olmayan paketlerin içe aktarımları. Hiçbir şey saklanmaz veya çalıştırılmaz.salt okunurKapsamlar: agent:check
filesobject[]zorunlu
Değişen dosyalar: src/app.ts gibi depoya göreli bir yol ve UTF-8 içeriğin tamamı.
Örnek argümanlar
{ "files": [{ "path": "src/config.ts", "content": "…" }] }

Ajan korumaları

İki araç, bir kodlama ajanının harekete geçmeden önce kendi işini kontrol etmesini sağlar: bağımlılık kurmadan önce vetkit_check_packages, commit etmeden önce vetkit_scan_changes. İkisi de agent:check kapsamlı bir API anahtarı gerektirir.

İkisi de gerekçeleriyle birlikte allow, warn veya block kararı döndürür. Block: paket mevcut değilse (uydurulmuş ya da slopsquatting amaçlı bir ad), OSV’de bilinen bir kötü amaçlı paket kaydı varsa, politikanız bilinen istismar edilmiş açıkları engelliyorken bir CISA KEV bildirimi varsa, kuruluşunuzun yasak listesindeki bir lisansı kullanıyorsa ya da değişiklik commit edilmiş bir gizli bilgi içeriyorsa. Warn: yayımlanmamış bir sürüm, çok yeni bir sürüm, düşük benimsenme, politikanızın asgari önem düzeyinde ya da üstünde bir güvenlik bildirimi veya diğer kod bulguları. Erişilemeyen kaynaklar uyarı olarak listelenir; bu kontroller atlanır, asla tahmin edilmez.

Claude Code kancası

vetkit-mcp hook pre-tool-use, Claude Code’un PreToolUse girdisini okur, Bash komutlarındaki paket kurulumlarını bulur ve vetkit bir paketi engellediğinde 2 koduyla çıkar; böylece Claude Code komutu durdurur ve nedenini gösterir. Aksi halde 0 ile çıkar ve varsa uyarıları yazdırır. Hata durumunda engellemez: VETKIT_API_KEY yoksa ya da API’ye ulaşılamıyorsa uyarı verir ve komutun çalışmasına izin verir. .claude/settings.json dosyasına ekleyin:

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

VETKIT_API_KEY değişkenini commit edilen bir dosyada değil, kabuğunuzda agent:check kapsamlı bir anahtara ayarlayın.

Cursor ve diğer istemciler

Kanca yalnızca paket kurulumlarını kontrol eder. Değişiklikleri taramak için ve kanca desteği olmayan Cursor veya diğer istemcilerde, ajana kurulumdan önce vetkit_check_packages, commit’ten önce vetkit_scan_changes çağırmasını söyleyen bir kural ekleyin. vetkit uygulamasındaki MCP sayfasında hazır bir Cursor kuralı bulunur.

Kontroller

Beş puanlanan gruba ek olarak, nota etki etmeyen isteğe bağlı Gizlilik ve Veri Koruma (beta) ile Git geçmişi grupları bulunur. Puanlanan her grup kendi notunu alır; genel puanda Güvenlik %43, Kod kalitesi %18, Sürdürülebilirlik %11, Yapay zekâ kod riskleri %13 ve Canlıya hazırlık %15 ağırlığa sahiptir. Yalnızca çalışan gruplar hesaba katılır ve ağırlıklar bu gruplar arasında paylaştırılır (Canlıya hazırlık olmadan Güvenlik %50, Kod kalitesi %22, Sürdürülebilirlik %13 ve Yapay zekâ kod riskleri %15; yalnızca Güvenlik ve Kod kalitesi çalıştığında Güvenlik %70 ve Kod kalitesi %30). Kontrol kimliklerini analyzers alanında ya da grupları suites alanında iletin.

Güvenlik

  • Kontrol kimliği: postureCommit edilmiş .env dosyaları, özel anahtarlar ve keystore dosyaları, lock dosyası olmayan manifestler, eksik güvenlik politikası.Kategori: SECRETS, DEPENDENCIES, SECURITY
  • Kontrol kimliği: gitleaksKaynak ağacındaki API anahtarları, token’lar, parolalar ve özel anahtarlar.Kategori: SECRETS
  • Kontrol kimliği: secrets-historyCommit edilip sonradan silinmiş ama git geçmişinden hâlâ geri getirilebilen kimlik bilgileri. İsteğe bağlı.Kategori: SECRETS
  • Kontrol kimliği: osvKilitli bağımlılıklardaki bilinen CVE’ler, zararlı paketler ve aktif olarak istismar edilen (CISA KEV) güvenlik duyuruları.Kategori: DEPENDENCIES
  • Kontrol kimliği: vendoredDepoya kopyalanmış, bilinen güvenlik açıkları olan JavaScript kütüphaneleri.Kategori: DEPENDENCIES
  • Kontrol kimliği: eolDesteği bitmiş çalışma ortamları, framework’ler ve container taban imajları.Kategori: DEPENDENCIES
  • Kontrol kimliği: supply-chainLock dosyası enjeksiyonu, güvensiz paket kayıt defterleri, riskli kurulum betikleri, Trojan Source ve commit edilmiş çalıştırılabilir dosyalar.Kategori: DEPENDENCIES, SECURITY
  • Kontrol kimliği: sastDesteklenen dillerde seçili kod güvenliği kuralları ile güvensiz sunucu, mobil ve shell yapılandırmaları.Kategori: SECURITY
  • Kontrol kimliği: sast-communitySerbest lisanslı ek topluluk kural paketleri. İsteğe bağlı, beta.Kategori: SECURITY
  • Kontrol kimliği: iacTerraform, CloudFormation, Kubernetes, Helm ve Dockerfile yapılandırma hataları (Trivy).Kategori: INFRASTRUCTURE
  • Kontrol kimliği: workflowsGitHub Actions betik enjeksiyonu, gereğinden geniş izinler, sabitlenmemiş action’lar ve pwn request’ler (zizmor).Kategori: INFRASTRUCTURE

Kod kalitesi

  • Kontrol kimliği: code-smellsYutulan hatalar, unutulmuş debug ifadeleri, şüpheli karşılaştırmalar ve hataya açık diğer kodlar.Kategori: QUALITY
  • Kontrol kimliği: complexityDöngüsel karmaşıklığı yüksek, derin iç içe yapılı, uzun gövdeli veya uzun parametre listeli fonksiyonlar.Kategori: MAINTAINABILITY
  • Kontrol kimliği: duplicationDosyalar arasında kopyala-yapıştır ile çoğaltılmış kod blokları.Kategori: DUPLICATION
  • Kontrol kimliği: testsHiç olmayan veya yetersiz testler, test edilmemiş büyük dosyalar, odaklanmış ya da atlanmış testler, assertion içermeyen testler, testleri hiç çalıştırmayan CI.Kategori: TESTING
  • Kontrol kimliği: docsKurulum veya kullanım talimatı içermeyen README’ler, belgelenmemiş public API’ler, changelog’u olmayan yayınlanmış paketler.Kategori: DOCUMENTATION
  • Kontrol kimliği: hygieneREADME, LICENSE, CI ve .gitignore; commit edilmiş derleme çıktıları, depoya gömülü bağımlılıklar ve büyük dosyalar.Kategori: HYGIENE

Sürdürülebilirlik

  • Kontrol kimliği: licensesProje lisansıyla çelişen copyleft (GPL, AGPL), kullanımı kısıtlı veya bilinmeyen lisanslı bağımlılıklar.Kategori: LICENSES
  • Kontrol kimliği: dep-healthKullanımdan kaldırılmış, iki veya daha fazla major sürüm geride kalmış ya da artık yeni sürümü çıkmayan doğrudan bağımlılıklar.Kategori: DEPENDENCY_HEALTH
  • Kontrol kimliği: activityBayat depolar, tek kişiye bağımlılık riski (bus factor) ve sık değişen büyük dosyalar.Kategori: ACTIVITY

Yapay zekâ kod riskleri

  • Kontrol kimliği: hallucinated-depsHerkese açık paket kayıt defterinde bulunmayan bağımlılıklar ve import’lar (slopsquatting hedefleri), hiç yayınlanmamış sürümler, ilk sürümü son 30 gün içinde çıkmış paketler ve package.json dosyasında bildirilmemiş import’lar.Kategori: HALLUCINATION
  • Kontrol kimliği: ai-slopTaslak (stub) kodlar, “kodun geri kalanı” yer tutucuları, üretim yollarındaki sahte veriler ve yer tutucu kimlik bilgileri, kopya ekli çift dosyalar ve toptan tip veya lint bastırmaları.Kategori: UNFINISHED_CODE
  • Kontrol kimliği: vibe-stackSatır düzeyi güvenliği (RLS) olmayan Supabase tabloları, public ortam değişkenlerindeki gizli bilgiler, kimlik doğrulaması olmayan API route’ları ve yalnızca istemci tarafında yapılan erişim kontrolleri.Kategori: VIBE_STACK
  • Kontrol kimliği: llm-appPrompt injection yolları, kod çalıştırmaya, SQL sorgularına veya HTML çıktısına ulaşan LLM çıktısı, istemci kodundaki LLM API anahtarları, sınırsız model çağrıları ve riskli yapay zekâ ajanı yapılandırması.Kategori: LLM_SECURITY
  • Kontrol kimliği: ai-signalSezgisel yapay zekâ yazarlığı sinyali. Beta, bilgi amaçlıdır, asla puanlanmaz; yalnızca sunucuda etkinleştirildiğinde çalışır.Kategori: AI_SIGNAL

Canlıya hazırlık

  • Kontrol kimliği: resilienceZaman aşımı olmayan giden HTTP çağrıları, istek yolunda ve async fonksiyonlarda bloklayan çağrılar, her istekte yeniden oluşturulan veritabanı istemcileri.Kategori: RESILIENCE
  • Kontrol kimliği: data-accessDöngü içindeki sorgular (N+1), sayfalaması olmayan liste uç noktaları, indekssiz foreign key’ler, açılışta veri silebilen şema eşitleme.Kategori: DATABASE
  • Kontrol kimliği: operabilityDev sunucusu çalıştıran, parolaları giriş hız sınırı olmadan doğrulayan ya da graceful shutdown, health check veya hata izlemesi olmayan dağıtılmış servisler.Kategori: OPERABILITY

Uzun süren denetimler

Çoğu denetim birkaç dakikada tamamlanır. vetkit_run_audit birkaç saniyede bir durumu sorgular ve beklerken ilerleme bildirimleri gönderir. Bazı istemciler araç çağrılarını sabit bir süreden sonra iptal eder — örneğin Claude Code MCP_TOOL_TIMEOUT ayarına uyar. Sizin istemciniz de böyleyse "wait": false iletin ve vetkit_get_audit ile sorgulayın. timeoutSeconds süresi dolduğunda denetim çalışmaya devam eder ve araç "outcome": "still_running" döndürür.

Hatalar

API hataları isError: true içeren araç sonuçları olarak döner ve HTTP durum kodunu, vetkit hata kodunu, mesajı, istek kimliğini ve bir ipucunu içerir.

  • 401 API_KEY_INVALID, API_KEY_REVOKED, API_KEY_EXPIRED — bir anahtar oluşturun veya mevcut anahtarı yenileyin, VETKIT_API_KEY değerini güncelleyin ve sunucuyu yeniden başlatın.
  • 403 INSUFFICIENT_SCOPE — anahtarda, aracın ihtiyaç duyduğu bir kapsam eksik.
  • 409 AUDIT_CONCURRENCY_LIMIT ve 429 RATE_LIMITED — bekleyip yeniden deneyin; API Retry-After gönderdiğinde ipucu bekleme süresini de içerir.
  • 402 INSUFFICIENT_CREDITS — tam tarama çalışma alanı sahibinden 1 kredi gerektirir. vetkit uygulamasından daha fazla kredi talep edin ya da aylık hak sürdükçe varsayılan dalda ücretsiz bir Quick Scan çalıştırın.
  • 422 ANALYZER_UNAVAILABLE — analyzers alanındaki bir kontrol bu sunucuda çalıştırılamıyor. vetkit_list_checks aracını çağırın ya da yalnızca kullanılabilir kontrolleri seçen suites alanını iletin.
  • INSTALLATION_REQUIRED bir hata olarak değil, GitHub App kurulum URL’sini içeren normal bir sonuç olarak döndürülür.

Güvenlik notları

  • API anahtarına parola gibi davranın. Anahtar, özel depolar dahil kuruluşunuzun denetimlerine ve bulgularına erişim sağlar. Onu asla commit ettiğiniz dosyalarda değil, MCP istemcinizin env yapılandırmasında tutun. Yalnızca ihtiyacınız olan kapsamları verin, bir son kullanma tarihi belirleyin ve sızarsa uygulamadan iptal edin.
  • Anahtar yalnızca VETKIT_API_URL adresine, HTTPS üzerinden bir Authorization: Bearer başlığı olarak gönderilir. Sunucu onu asla loglara yazmaz veya hata mesajlarına eklemez.
  • Sunucu yalnızca stdio üzerinden MCP ile iletişim kurar. Hiçbir ağ portu açmaz ve logları yalnızca stderr akışına yazar.
  • Bulgulardaki kod parçaları vetkit tarafından saklanmadan önce maskelenir; gizli bilgi değerleri asla döndürülmez.
  • Rapor ve bulgu metinleri denetlenen depodan gelir (dosya yolları, mesajlar). Bunları diğer araç çıktıları gibi güvenilmeyen girdi olarak ele alın — kötü niyetli bir depo, ajanınızı hedef alan talimatlar yerleştirmeye çalışabilir.

Doğrudan HTTP mi tercih ediyorsunuz? MCP sunucusunun yaptığı her şey REST API üzerinden de kullanılabilir.

Erken erişim talep edin

Ekibinizden ve denetlemek istediğiniz depolardan kısaca bahsedin. Ekipleri küçük gruplar halinde aramıza alıyoruz; size e-postayla dönüş yapacağız.

Bu bilgileri yalnızca talebinize yanıt vermek için kullanırız. Gizlilik politikası