Документация · MCP
MCP-сервер vetkit
Дайте вашему ИИ-агенту аудитора кода. MCP-сервер vetkit позволяет любому клиенту Model Context Protocol с поддержкой stdio подключать репозитории, запускать аудиты и читать находки и отчёты.
MCP — открытый стандарт, а не интеграция только для Claude. Настройте локальный stdio-сервер с именем vetkit по описанию ниже и следуйте инструкции вашего клиента. Структура конфигурации зависит от клиента. Клиенты, принимающие только удалённые HTTP/SSE-серверы, не могут подключиться напрямую; vetkit не предоставляет удалённую точку подключения MCP.
{ "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" }}Затем попросите агента, например: «Проведи аудит acme/payments-api и скажи, что исправить в первую очередь». Перезагрузите клиент и убедитесь, что vetkit_list_repos появился в списке инструментов.
Требования
- Node.js 20.3 или новее,
npxдолжен быть вPATH. - Аккаунт vetkit и доступ к репозиториям GitHub, Bitbucket Cloud или GitLab.com, которые вы хотите проверять.
- API-ключ vetkit (следующий шаг).
Создайте API-ключ
- Откройте Настройки рабочего пространства → API-ключи в приложении vetkit. Управлять ключами могут только владельцы и администраторы организации.
- Назовите ключ по месту, где он будет использоваться, например «MCP — ноутбук».
- Для запуска аудитов репозиториев выберите
repos:read,audits:readиaudits:run(илиaudits:write). Добавьтеrepos:writeдля подключения репозиториев,findings:readдля чтения результатов иreports:readдля чтения отчётов. Для запуска или отмены оценок ИИ требуетсяaudits:write. Для агента только для чтения выберите лишь области доступа для чтения. - При желании задайте срок действия и лимит запросов в минуту (по умолчанию 60, максимум 600).
- Скопируйте секрет. Он выглядит как
vk_live_…и показывается один раз; vetkit хранит только его хеш.
Перевыпуск и отзыв
401 API_KEY_REVOKED.Установка
Cursor
Добавьте запись vetkit ниже в ~/.cursor/mcp.json (глобально) или в .cursor/mcp.json в проекте. Не коммитьте конфигурацию проекта, если в ней есть ваш ключ.
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}VS Code / GitHub Copilot
Добавьте эту запись в .vscode/mcp.json, сохранив существующие серверы. VS Code / GitHub Copilot использует servers, а не mcpServers. Запустите и разрешите vetkit в списке MCP-серверов. Замените заполнитель ключа и никогда не коммитьте конфигурацию с вашим секретом.
{ "servers": { "vetkit": { "type": "stdio", "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Codex
Добавьте эти разделы TOML в ~/.codex/config.toml, не заменяя существующие настройки. Codex CLI и расширение IDE используют общую конфигурацию. Замените заполнитель ключа, перезапустите клиент и проверьте с помощью codex mcp list. Храните этот файл конфиденциально.
[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/mcpДобавьте --scope user, чтобы vetkit был доступен во всех проектах, а не только в текущем.
Claude Desktop
Откройте Settings → Developer → Edit Config, добавьте vetkit в claude_desktop_config.json и перезапустите Claude Desktop:
{ "mcpServers": { "vetkit": { "command": "npx", "args": [ "-y", "@vetkit/mcp" ], "env": { "VETKIT_API_KEY": "<your-api-key>" } } }}Другие MCP-клиенты
Подойдёт любой клиент, который умеет запускать stdio-сервер: выполните npx -y @vetkit/mcp с переменной VETKIT_API_KEY в окружении. Также можно установить пакет глобально и запускать исполняемый файл vetkit-mcp напрямую.
npm install -g @vetkit/mcpVETKIT_API_KEY=vk_live_... vetkit-mcpКонфигурация
Сервер полностью настраивается через переменные окружения.
| Переменная | Обязательна | Описание |
|---|---|---|
VETKIT_API_KEY | Да | Ваш API-ключ: vk_live_… или vk_test_…. |
VETKIT_API_URL | Нет | Базовый URL API. По умолчанию https://api.vetkit.dev. Должен использовать HTTPS; обычный HTTP допускается только для localhost. |
VETKIT_ORG_ID | Нет | ID организации. Каждый API-ключ принадлежит ровно одной организации, которая и используется по умолчанию, поэтому эта переменная нужна редко. |
VETKIT_APP_URL | Нет | URL веб-приложения для ссылок на аудиты. По умолчанию https://app.vetkit.dev. |
Инструменты
Каждый инструмент возвращает читаемый текст, а все инструменты, кроме vetkit_get_report, также возвращают типизированный структурированный контент. У инструментов есть аннотации MCP, поэтому клиенты могут автоматически одобрять инструменты только для чтения. Ни один инструмент ничего не удаляет.
vetkit_list_repos
Возвращает список репозиториев, подключённых к вашей организации, с оценкой и баллом последнего аудита.только чтениеОбласти доступа: repos:read
limitnumber- Размер страницы, 1–100. По умолчанию 25.
cursorstring- Значение nextCursor из предыдущей страницы.
| Аргумент | Тип | Описание |
|---|---|---|
limit | number | Размер страницы, 1–100. По умолчанию 25. |
cursor | string | Значение nextCursor из предыдущей страницы. |
{ "limit": 10 }vetkit_connect_repo
Подключает репозиторий GitHub, Bitbucket Cloud или GitLab.com. Если для владельца репозитория GitHub ещё не установлено приложение vetkit GitHub App, возвращает результат "installation_required" со ссылкой для установки. Для приватных репозиториев Bitbucket и GitLab нужен токен доступа, который vetkit сохраняет для последующих проверок.записьОбласти доступа: repos:write
urlstringобязательный- URL репозитория GitHub, Bitbucket Cloud или GitLab.com либо "owner/name" для GitHub.
accessTokenstring- Необязательный токен доступа к репозиторию; обязателен для приватных репозиториев Bitbucket или GitLab. Передаётся в vetkit и сохраняется для последующих проверок.
| Аргумент | Тип | Описание |
|---|---|---|
urlобязательный | string | URL репозитория GitHub, Bitbucket Cloud или GitLab.com либо "owner/name" для GitHub. |
accessToken | string | Необязательный токен доступа к репозиторию; обязателен для приватных репозиториев Bitbucket или GitLab. Передаётся в vetkit и сохраняется для последующих проверок. |
{ "url": "https://github.com/acme/payments-api" }vetkit_run_audit
Запускает аудит и по умолчанию ждёт его завершения, отправляя уведомления о ходе выполнения. При необходимости сначала подключает репозиторий. Возвращает общую оценку, оценку каждого выполненного набора проверок, балл и количество находок. Этот инструмент не принимает токены доступа. Сначала подключите приватные репозитории Bitbucket или GitLab через vetkit_connect_repo с параметром accessToken.записьОбласти доступа: repos:read, audits:read, audits:run или audits:write (+ repos:write для автоподключения)
repostringобязательный- Идентификатор репозитория, "owner/name" для GitHub либо URL GitHub, Bitbucket Cloud или GitLab.com. URL GitHub может содержать /tree/<branch>.
mode"QUICK" | "FULL"- «QUICK» запускает бесплатный Quick Scan (10 в месяц на владельца рабочего пространства: posture, gitleaks и osv на последнем коммите ветки по умолчанию). «FULL» запускает полное сканирование за 1 кредит, который списывается с владельца рабочего пространства. По умолчанию «QUICK» или «FULL», если указаны ref, suites или analyzers.
refstring- Ветка, тег или SHA коммита. По умолчанию — ref из URL, а если его нет — ветка по умолчанию.
suitesstring[]- Выберите из "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Запускаются доступные проверки выбранных наборов, включённые по умолчанию; явный выбор privacy или git-history также включает их доступные дополнительные проверки. Для точного выбора используйте analyzers. По умолчанию используется настройка репозитория.
analyzersstring[]- Точный список проверок по ID (см. раздел «Проверки» ниже); имеет приоритет над suites. Нужна хотя бы одна проверка, кроме ai-signal.
excludeAssetsboolean- Не скачивать изображения, видео, аудио, 3D-модели, шрифты, файлы дизайна и PDF. По умолчанию используется настройка репозитория.
waitboolean- Ждать финального статуса. По умолчанию true.
timeoutSecondsnumber- Максимальное время ожидания, 10–1800. По умолчанию 600. После тайм-аута аудит продолжает выполняться.
| Аргумент | Тип | Описание |
|---|---|---|
repoобязательный | string | Идентификатор репозитория, "owner/name" для GitHub либо URL GitHub, Bitbucket Cloud или GitLab.com. URL GitHub может содержать /tree/<branch>. |
mode | "QUICK" | "FULL" | «QUICK» запускает бесплатный Quick Scan (10 в месяц на владельца рабочего пространства: posture, gitleaks и osv на последнем коммите ветки по умолчанию). «FULL» запускает полное сканирование за 1 кредит, который списывается с владельца рабочего пространства. По умолчанию «QUICK» или «FULL», если указаны ref, suites или analyzers. |
ref | string | Ветка, тег или SHA коммита. По умолчанию — ref из URL, а если его нет — ветка по умолчанию. |
suites | string[] | Выберите из "security", "quality", "sustainability", "ai-risks", "production", "privacy", "git-history". Запускаются доступные проверки выбранных наборов, включённые по умолчанию; явный выбор privacy или git-history также включает их доступные дополнительные проверки. Для точного выбора используйте analyzers. По умолчанию используется настройка репозитория. |
analyzers | string[] | Точный список проверок по ID (см. раздел «Проверки» ниже); имеет приоритет над suites. Нужна хотя бы одна проверка, кроме ai-signal. |
excludeAssets | boolean | Не скачивать изображения, видео, аудио, 3D-модели, шрифты, файлы дизайна и PDF. По умолчанию используется настройка репозитория. |
wait | boolean | Ждать финального статуса. По умолчанию true. |
timeoutSeconds | number | Максимальное время ожидания, 10–1800. По умолчанию 600. После тайм-аута аудит продолжает выполняться. |
{ "repo": "acme/payments-api", "ref": "main", "suites": ["security"] }vetkit_list_checks
Возвращает все проверки, сгруппированные по наборам, с используемым инструментом и его версией, доступностью на сервере и признаком запуска по умолчанию.только чтениеОбласти доступа: audits:read
Без аргументов.
| Аргумент | Тип | Описание |
|---|---|---|
| Без аргументов. | ||
{}vetkit_get_audit
Возвращает для одного аудита статус, общую оценку и оценки по наборам проверок, балл, количество находок и ход выполнения каждой проверки — включая такие метрики, как доля дублированного кода, средняя сложность, соотношение тестов и кода и фактор автобуса (bus factor).только чтениеОбласти доступа: audits:read
auditIduuidобязательный- ID аудита, возвращённый vetkit_run_audit.
| Аргумент | Тип | Описание |
|---|---|---|
auditIdобязательный | uuid | ID аудита, возвращённый vetkit_run_audit. |
{ "auditId": "0192f3a4-5b6c-7d8e-9f01-23456789abcd" }vetkit_list_findings
Возвращает находки аудита, начиная с самых критичных. Компактная таблица возвращается текстом, а полные сведения — сообщение, замаскированный фрагмент кода, рекомендации по исправлению, ссылки — структурированным контентом.только чтениеОбласти доступа: findings:read
auditIduuidобязательный- Аудит, данные которого нужно прочитать.
severitystring[]- CRITICAL, HIGH, MEDIUM, LOW или INFO.
suitestring- SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY или GIT_HISTORY: только находки этого набора проверок.
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 или PRIVACY_LIFECYCLE.
statusstring- NEW (появилась после предыдущего аудита) или EXISTING.
limitnumber- Размер страницы, 1–100. По умолчанию 25.
cursorstring- Значение nextCursor из предыдущей страницы.
| Аргумент | Тип | Описание |
|---|---|---|
auditIdобязательный | uuid | Аудит, данные которого нужно прочитать. |
severity | string[] | CRITICAL, HIGH, MEDIUM, LOW или INFO. |
suite | string | SECURITY, QUALITY, SUSTAINABILITY, AI_RISKS, PRODUCTION, PRIVACY или GIT_HISTORY: только находки этого набора проверок. |
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 или PRIVACY_LIFECYCLE. |
status | string | NEW (появилась после предыдущего аудита) или EXISTING. |
limit | number | Размер страницы, 1–100. По умолчанию 25. |
cursor | string | Значение nextCursor из предыдущей страницы. |
{ "auditId": "0192f3a4-…", "severity": ["CRITICAL", "HIGH"] }vetkit_suggest_fix
Предлагает минимальный патч для находки в коде (SAST, секреты, LLM-приложение, IaC) с помощью ИИ-провайдера, сохранённого вашей организацией в vetkit, или исправление из правила, если анализатор его предоставляет. Возвращает unified diff, пояснение, уровень уверенности и статус проверки. Провайдеру отправляется только замаскированный фрагмент примерно из 60 строк. Ничего не записывается: ни ветки, ни коммита, ни pull request. Нужен ключ, созданный администратором организации.только чтениеОбласти доступа: findings:write
findingIduuidобязательный- Id находки в коде из vetkit_list_findings.
providerstring- Сохранённый ИИ-провайдер. По умолчанию — первое проверенное подключение.
| Аргумент | Тип | Описание |
|---|---|---|
findingIdобязательный | uuid | Id находки в коде из vetkit_list_findings. |
provider | string | Сохранённый ИИ-провайдер. По умолчанию — первое проверенное подключение. |
{ "findingId": "0193b2c4-…" }vetkit_triage_findings
Спрашивает сохранённого ИИ-провайдера вашей организации, являются ли до 20 находок аудита скорее истинными или ложными срабатываниями. Каждая получает вердикт, уверенность и короткое обоснование с цитатой строки исходного кода. Вердикты носят рекомендательный характер: они меняют приоритет, но никогда не подавляют находку и не меняют оценку. Нужен платный тариф.записьОбласти доступа: findings:write
auditIduuidобязательный- Аудит, к которому относятся находки.
findingIdsuuid[]обязательный- До 20 id находок из vetkit_list_findings.
| Аргумент | Тип | Описание |
|---|---|---|
auditIdобязательный | uuid | Аудит, к которому относятся находки. |
findingIdsобязательный | uuid[] | До 20 id находок из vetkit_list_findings. |
{ "auditId": "0192f3a4-…", "findingIds": ["0193b2c4-…"] }vetkit_get_report
Возвращает отчёт о завершённом аудите: читаемый Markdown, JSON-сводку с баллами по наборам проверок и категориям и сравнением с предыдущим аудитом или SARIF 2.1.0.только чтениеОбласти доступа: reports:read
auditIduuidобязательный- Аудит, данные которого нужно прочитать.
formatstring- markdown (по умолчанию), json или sarif.
maxCharsnumber- Обрезать вывод, если он длиннее указанного числа символов, 2 000–500 000. По умолчанию 40 000.
| Аргумент | Тип | Описание |
|---|---|---|
auditIdобязательный | uuid | Аудит, данные которого нужно прочитать. |
format | string | markdown (по умолчанию), json или sarif. |
maxChars | number | Обрезать вывод, если он длиннее указанного числа символов, 2 000–500 000. По умолчанию 40 000. |
{ "auditId": "0192f3a4-…", "format": "markdown" }vetkit_get_standards_report
Сопоставляет открытые находки аудита с OWASP Top 10 (2021 или 2025), CWE Top 25 (2024) или OWASP Top 10 for LLM Applications (2025). Каждая категория получает статус fail, pass (нет сопоставленных находок от проверок, способных её обнаружить) или not covered. Это помощь в сопоставлении, а не сертификация соответствия.только чтениеОбласти доступа: reports:read, findings:read
auditIduuidобязательный- Аудит для сопоставления.
standardstringобязательный- owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 или owasp-llm-top10-2025.
| Аргумент | Тип | Описание |
|---|---|---|
auditIdобязательный | uuid | Аудит для сопоставления. |
standardобязательный | string | owasp-top10-2021, owasp-top10-2025, cwe-top25-2024 или owasp-llm-top10-2025. |
{ "auditId": "0192f3a4-…", "standard": "owasp-top10-2021" }vetkit_check_packages
Вызывайте перед установкой зависимости. Проверяет до 50 пакетов одной экосистемы по публичному реестру, бюллетеням OSV (включая известные вредоносные пакеты), CISA KEV и политике вашей организации и возвращает allow, warn или block с причинами.только чтениеОбласти доступа: agent:check
ecosystemstringобязательный- npm, pypi, cargo, go, rubygems, nuget или maven. Для pip и uv используйте pypi.
packagesobject[]обязательный- До 50 пакетов: имя (для Maven group:artifact, для Go путь модуля) и необязательная точная версия.
| Аргумент | Тип | Описание |
|---|---|---|
ecosystemобязательный | string | npm, pypi, cargo, go, rubygems, nuget или maven. Для pip и uv используйте pypi. |
packagesобязательный | object[] | До 50 пакетов: имя (для Maven group:artifact, для Go путь модуля) и необязательная точная версия. |
{ "ecosystem": "npm", "packages": [{ "name": "left-pad", "version": "1.3.0" }] }vetkit_scan_changes
Вызывайте перед коммитом. Сканирует в памяти до 30 изменённых файлов (всего 512 КБ) на секреты точного формата, рискованную конфигурацию агентов и скрытые инструкции, незавершённый код и импорты несуществующих пакетов. Ничего не сохраняется и не запускается.только чтениеОбласти доступа: agent:check
filesobject[]обязательный- Изменённые файлы: путь относительно репозитория, например src/app.ts, и полное содержимое в UTF-8.
| Аргумент | Тип | Описание |
|---|---|---|
filesобязательный | object[] | Изменённые файлы: путь относительно репозитория, например src/app.ts, и полное содержимое в UTF-8. |
{ "files": [{ "path": "src/config.ts", "content": "…" }] }Защита для агентов
Два инструмента позволяют агенту для программирования проверить свою работу, прежде чем действовать: vetkit_check_packages — перед установкой зависимости, vetkit_scan_changes — перед коммитом. Обоим нужен API-ключ со scope agent:check.
Оба возвращают вердикт allow, warn или block с причинами. Block: пакет не существует (выдуманное или slopsquatting-имя), в OSV есть запись о нём как об известном вредоносном пакете, есть бюллетень CISA KEV, когда ваша политика блокирует известные эксплуатируемые уязвимости, используется лицензия из запрещённого списка вашей организации, или изменение содержит закоммиченный секрет. Warn: неопубликованная версия, очень свежий релиз, низкая популярность, бюллетень с уровнем не ниже минимального по вашей политике или другие находки в коде. Недоступные источники перечисляются как предупреждения; такие проверки пропускаются, а не угадываются.
Хук для Claude Code
vetkit-mcp hook pre-tool-use читает входные данные PreToolUse из Claude Code, находит установки пакетов в командах Bash и завершается с кодом 2, если vetkit блокирует пакет, — тогда Claude Code останавливает команду и показывает причину. Иначе он завершается с кодом 0 и выводит предупреждения, если они есть. При ошибках он не блокирует: без VETKIT_API_KEY или если API недоступен, он предупреждает и даёт команде выполниться. Добавьте его в .claude/settings.json:
{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "npx -y @vetkit/mcp hook pre-tool-use", "timeout": 30 } ] } ] }}Задайте VETKIT_API_KEY в своей оболочке — ключ со scope agent:check, — а не в файле, который попадает в репозиторий.
Cursor и другие клиенты
vetkit_check_packages перед установкой и vetkit_scan_changes перед коммитом. На странице MCP в приложении vetkit есть готовое правило для Cursor.Проверки
Доступны пять оцениваемых наборов, а также дополнительные наборы «Конфиденциальность и защита данных» (бета) и «История Git», которые не влияют на оценку. Каждый оцениваемый набор получает собственную оценку, а веса в общем балле таковы: «Безопасность» — 43%, «Качество кода» — 18%, «Устойчивость» — 11%, «Риски ИИ-кода» — 13% и «Готовность к продакшену» — 15%. Учитываются только выполненные наборы, и их веса перераспределяются между ними: без набора «Готовность к продакшену» — «Безопасность» 50%, «Качество кода» 22%, «Устойчивость» 13% и «Риски ИИ-кода» 15%; если выполнялись только два первых набора — «Безопасность» 70% и «Качество кода» 30%. Передавайте ID проверок в analyzers или набор в suites.
Безопасность
- ID проверки:
postureЗакоммиченные файлы .env, приватные ключи и хранилища ключей, манифесты без lock-файла, отсутствие политики безопасности.Категория: SECRETS, DEPENDENCIES, SECURITY - ID проверки:
gitleaksAPI-ключи, токены, пароли и приватные ключи в исходном коде.Категория: SECRETS - ID проверки:
secrets-historyУчётные данные, которые были закоммичены и позже удалены, но всё ещё восстанавливаются из истории git. Включается вручную.Категория: SECRETS - ID проверки:
osvИзвестные CVE, вредоносные пакеты и бюллетени об активно эксплуатируемых уязвимостях (CISA KEV) среди зафиксированных зависимостей.Категория: DEPENDENCIES - ID проверки:
vendoredБиблиотеки JavaScript с известными уязвимостями, скопированные в репозиторий.Категория: DEPENDENCIES - ID проверки:
eolСреды выполнения, фреймворки и базовые образы контейнеров с истёкшим сроком поддержки.Категория: DEPENDENCIES - ID проверки:
supply-chainВнедрение в lock-файлы, небезопасные реестры, рискованные скрипты установки, Trojan Source и закоммиченные исполняемые файлы.Категория: DEPENDENCIES, SECURITY - ID проверки:
sastОтдельные правила безопасности кода для поддерживаемых языков и небезопасные настройки серверов, мобильных приложений и shell.Категория: SECURITY - ID проверки:
sast-communityДополнительные наборы правил от сообщества с разрешительными лицензиями. Включается вручную, бета.Категория: SECURITY - ID проверки:
iacОшибки конфигурации Terraform, CloudFormation, Kubernetes, Helm и Dockerfile (Trivy).Категория: INFRASTRUCTURE - ID проверки:
workflowsИнъекции в скрипты GitHub Actions, избыточные разрешения, actions без закреплённой версии и pwn requests (zizmor).Категория: INFRASTRUCTURE
Качество кода
- ID проверки:
code-smellsПроглоченные ошибки, забытые отладочные инструкции, подозрительные сравнения и другой код, провоцирующий ошибки.Категория: QUALITY - ID проверки:
complexityФункции с высокой цикломатической сложностью, глубокой вложенностью, длинным телом или длинным списком параметров.Категория: MAINTAINABILITY - ID проверки:
duplicationСкопированные между файлами блоки кода.Категория: DUPLICATION - ID проверки:
testsОтсутствующие или скудные наборы тестов, крупные непротестированные файлы, сфокусированные или пропущенные тесты, тесты без проверок (assertions), CI, который никогда не запускает тесты.Категория: TESTING - ID проверки:
docsREADME без инструкций по установке и использованию, недокументированные публичные API, опубликованные пакеты без журнала изменений.Категория: DOCUMENTATION - ID проверки:
hygieneREADME, LICENSE, CI и .gitignore; закоммиченные результаты сборки, скопированные в репозиторий зависимости и большие файлы.Категория: HYGIENE
Устойчивость
- ID проверки:
licensesЗависимости под копилефт-лицензиями (GPL, AGPL), лицензиями с ограничениями на использование или неизвестными лицензиями, которые конфликтуют с лицензией проекта.Категория: LICENSES - ID проверки:
dep-healthПрямые зависимости, объявленные устаревшими (deprecated), отстающие на две и более мажорные версии или больше не получающие новых выпусков.Категория: DEPENDENCY_HEALTH - ID проверки:
activityЗаброшенные репозитории, зависимость от единственного мейнтейнера (фактор автобуса) и большие файлы, которые часто меняются.Категория: ACTIVITY
Риски ИИ-кода
- ID проверки:
hallucinated-depsЗависимости и импорты, которых нет в публичном реестре (мишени для slopsquatting), версии, которые никогда не публиковались, пакеты, впервые опубликованные за последние 30 дней, и импорты, не объявленные в package.json.Категория: HALLUCINATION - ID проверки:
ai-slopЗаглушки, плейсхолдеры вида «остальной код», фиктивные данные и учётные данные-заглушки в рабочем коде, копии файлов с суффиксом copy и массовое отключение проверок типов или линтера.Категория: UNFINISHED_CODE - ID проверки:
vibe-stackТаблицы Supabase без защиты на уровне строк (RLS), секреты в публичных переменных окружения, API-маршруты без аутентификации и проверки доступа только на стороне клиента.Категория: VIBE_STACK - ID проверки:
llm-appПути для промпт-инъекций, вывод LLM, попадающий в выполнение кода, SQL или HTML, API-ключи LLM в клиентском коде, вызовы модели без ограничений и рискованная конфигурация ИИ-агентов.Категория: LLM_SECURITY - ID проверки:
ai-signalЭвристический сигнал ИИ-авторства. Бета, только для информации, никогда не влияет на балл; работает, только если включён на сервере.Категория: AI_SIGNAL
Готовность к продакшену
- ID проверки:
resilienceИсходящие HTTP-запросы без таймаута, блокирующие вызовы при обработке запросов и в async-функциях, клиенты базы данных, создаваемые на каждый запрос.Категория: RESILIENCE - ID проверки:
data-accessЗапросы внутри циклов (N+1), эндпоинты списков без пагинации, внешние ключи без индекса, синхронизация схемы при запуске, способная удалить данные.Категория: DATABASE - ID проверки:
operabilityРазвёрнутые сервисы, которые запускают сервер разработки, проверяют пароли без лимита на попытки входа или не имеют корректного завершения работы, health check или отслеживания ошибок.Категория: OPERABILITY
Долгие аудиты
Большинство аудитов завершается за несколько минут. Пока vetkit_run_audit ждёт, он опрашивает статус каждые несколько секунд и отправляет уведомления о ходе выполнения. Некоторые клиенты отменяют вызовы инструментов через фиксированное время — например, Claude Code учитывает MCP_TOOL_TIMEOUT. Если ваш клиент так делает, передайте "wait": false и опрашивайте статус через vetkit_get_audit. Когда истекает timeoutSeconds, аудит продолжает выполняться, а инструмент возвращает "outcome": "still_running".
Ошибки
Ошибки API возвращаются как результаты инструментов с isError: true и содержат HTTP-статус, код ошибки vetkit, сообщение, ID запроса и подсказку.
401 API_KEY_INVALID,API_KEY_REVOKED,API_KEY_EXPIRED— создайте или перевыпустите ключ, обновитеVETKIT_API_KEYи перезапустите сервер.403 INSUFFICIENT_SCOPE— у ключа нет области доступа, нужной инструменту.409 AUDIT_CONCURRENCY_LIMITи429 RATE_LIMITED— подождите и повторите попытку; если API отправляетRetry-After, подсказка содержит время ожидания.402 INSUFFICIENT_CREDITS— полной проверке нужен 1 кредит владельца рабочего пространства. Запросите дополнительные кредиты в приложении vetkit или запустите бесплатный Quick Scan ветки по умолчанию, пока не исчерпан месячный лимит.422 ANALYZER_UNAVAILABLE— проверку изanalyzersнельзя запустить на этом сервере. Вызовитеvetkit_list_checksили передайтеsuites: в этом случае выбираются только доступные проверки.INSTALLATION_REQUIREDвозвращается как обычный результат с URL установки GitHub App, а не как ошибка.
Замечания по безопасности
- Обращайтесь с API-ключом как с паролем. Он даёт доступ к аудитам и находкам вашей организации, включая приватные репозитории. Храните его в конфигурации
envвашего MCP-клиента и никогда — в файлах, которые вы коммитите. Выдавайте только нужные области доступа, задайте срок действия и отзовите ключ в приложении, если произошла утечка. - Ключ отправляется только на
VETKIT_API_URLв заголовкеAuthorization: Bearerпо HTTPS. Сервер никогда не записывает его в логи и не включает в сообщения об ошибках. - Сервер работает по MCP только через stdio. Он не открывает сетевых портов и пишет логи только в stderr.
- Фрагменты кода в находках маскируются до того, как vetkit их сохранит; значения секретов никогда не возвращаются.
- Текст отчётов и находок берётся из проверяемого репозитория (пути к файлам, сообщения). Считайте его недоверенными входными данными, как и любой другой вывод инструментов: вредоносный репозиторий может попытаться встроить инструкции, адресованные вашему агенту.
Предпочитаете чистый HTTP? Всё, что делает MCP-сервер, доступно через REST API.