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.
{ "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;
npxkomutuPATHü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
- vetkit uygulamasında Çalışma alanı ayarları → API anahtarları sayfasını açın. Anahtarları yalnızca kuruluş sahipleri ve yöneticileri yönetebilir.
- Anahtara, kullanılacağı yeri belirten bir ad verin; örneğin “MCP — dizüstü”.
- Depo denetimleri çalıştırmak için
repos:read,audits:readveaudits:run(veyaaudits:write) seçin. Depo bağlamak içinrepos:write, bulguları okumak içinfindings:read, raporları okumak içinreports:readekleyin. AI Evaluation başlatmak veya iptal etmekaudits:writegerektirir. Salt okunur bir ajan için yalnızca okuma kapsamlarını seçin. - İ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).
- Gizli değeri kopyalayın.
vk_live_…biçimindedir ve bir kez gösterilir; vetkit yalnızca hash’ini saklar.
Yenileme ve iptal
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.
{ "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.
{ "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.
[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/mcpvetkit’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:
{ "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.
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcpYapılandırma
Sunucu tamamen ortam değişkenleriyle yapılandırılır.
| Değişken | Zorunlu | Açıklama |
|---|---|---|
VETKIT_API_KEY | Evet | API anahtarınız: vk_live_… veya vk_test_…. |
VETKIT_API_URL | Hayır | API 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_ID | Hayır | Kuruluş 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_URL | Hayır | Denetim 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.
| Argüman | Tür | Açıklama |
|---|---|---|
limit | number | Sayfa boyutu, 1–100. Varsayılan 25. |
cursor | string | Önceki sayfadaki nextCursor değeri. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
urlzorunlu | string | GitHub, Bitbucket Cloud veya GitLab.com depo URL’si; GitHub için "owner/name" da kullanılabilir. |
accessToken | string | İ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. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
repozorunlu | string | 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. |
ref | string | Dal, etiket veya commit SHA’sı. Varsayılan olarak URL’deki ref, o da yoksa varsayılan dal kullanılır. |
suites | string[] | "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. |
analyzers | string[] | Ç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. |
excludeAssets | boolean | Görseller, video, ses, 3D modeller, fontlar, tasarım dosyaları ve PDF’ler indirilmez. Varsayılan olarak depo ayarı kullanılır. |
wait | boolean | Nihai bir durumu bekler. Varsayılan true. |
timeoutSeconds | number | En uzun bekleme süresi, 10–1800. Varsayılan 600. Zaman aşımından sonra denetim çalışmaya devam eder. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
| Argüman yok. | ||
{}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.
| Argüman | Tür | Açıklama |
|---|---|---|
auditIdzorunlu | uuid | vetkit_run_audit tarafından döndürülen denetim kimliği. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
auditIdzorunlu | uuid | Okunacak denetim. |
severity | string[] | CRITICAL, HIGH, MEDIUM, LOW veya INFO. |
suite | string | SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY veya GIT_HISTORY: yalnızca o grubun bulguları. |
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 veya PRIVACY_LIFECYCLE. |
status | string | NEW (önceki denetimden bu yana ortaya çıkan) veya EXISTING. |
limit | number | Sayfa boyutu, 1–100. Varsayılan 25. |
cursor | string | Önceki sayfadaki nextCursor değeri. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
findingIdzorunlu | uuid | vetkit_list_findings ile alınan kod bulgusunun kimliği. |
provider | string | Kullanılacak kayıtlı yapay zekâ sağlayıcısı. Varsayılan, doğrulanmış ilk bağlantıdır. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
auditIdzorunlu | uuid | Bulguların ait olduğu denetim. |
findingIdszorunlu | uuid[] | vetkit_list_findings ile alınan en fazla 20 bulgu kimliği. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
auditIdzorunlu | uuid | Okunacak denetim. |
format | string | markdown (varsayılan), json veya sarif. |
maxChars | number | Çıktıyı bu karakter sayısından sonra kısaltır, 2.000–500.000. Varsayılan 40.000. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
auditIdzorunlu | uuid | Eşlenecek denetim. |
standardzorunlu | string | owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 veya owasp-llm-top10-2025. |
{ "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.
| Argüman | Tür | Açıklama |
|---|---|---|
ecosystemzorunlu | string | npm, pypi, cargo, go, rubygems, nuget veya maven. pip ve uv için pypi kullanın. |
packageszorunlu | object[] | 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. |
{ "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ı.
| Argüman | Tür | Açıklama |
|---|---|---|
fileszorunlu | object[] | Değişen dosyalar: src/app.ts gibi depoya göreli bir yol ve UTF-8 içeriğin tamamı. |
{ "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:
{ "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
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_KEYdeğerini güncelleyin ve sunucuyu yeniden başlatın.403 INSUFFICIENT_SCOPE— anahtarda, aracın ihtiyaç duyduğu bir kapsam eksik.409 AUDIT_CONCURRENCY_LIMITve429 RATE_LIMITED— bekleyip yeniden deneyin; APIRetry-Aftergö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—analyzersalanındaki bir kontrol bu sunucuda çalıştırılamıyor.vetkit_list_checksaracını çağırın ya da yalnızca kullanılabilir kontrolleri seçensuitesalanını iletin.INSTALLATION_REQUIREDbir 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
envyapı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_URLadresine, HTTPS üzerinden birAuthorization: Bearerbaş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.