// docs / mcp
MCP-сервер
Подключите FixVibe к Claude Desktop, Cursor или любому клиенту с поддержкой Model Context Protocol. Ваш AI-агент получает типизированный доступ к сканированиям, находкам и тем же шаблонным подсказкам исправлений, что питают кнопку Copy fix prompt в панели.
Создайте API-токен
Открой /account/api-tokens и создай token с именем, например claude-desktop. Скопируй plaintext value — оно показывается один раз.
Tokens — это bearer credentials: любой, у кого есть эта строка, может читать твои scans и запускать новые. Храни ее как пароль.
Направь MCP-клиент на /api/mcp
Claude Desktop / Cursor / Continue / Zed:
{
"mcpServers": {
"fixvibe": {
"transport": "streamable-http",
"url": "https://fixvibe.app/api/mcp",
"headers": {
"Authorization": "Bearer fxv_YOUR_TOKEN_HERE"
}
}
}
}Перезапусти client. Сервер fixvibe должен появиться в его списке MCP servers.
Попробуй
Проси своего agent о таком:
- «Покажи мои последние 10 FixVibe scans.»
- «Покажи critical findings в самом свежем scan.»
- «Запусти passive scan для
https://staging.example.com.» - «Для каждой high-severity finding в scan X напиши fix.»
- «Есть ли открытые live-threat alerts по моим domains?»
- Введи
/fixvibe-fixс finding id, чтобы вставить templated remediation prompt прямо в chat.
Инструменты
- list_scansчтение
- Возвращает до 100 самых свежих scans со status + finding counts. Args: limit?: 1..100.
- get_scanчтение
- Scan envelope + severity summary по категориям по умолчанию. Установи include_findings=true для полного отчета (большой для шумных scans — лучше list_findings + filters). Args: scan_id (uuid), include_findings?: boolean.
- list_findingsчтение
- Paginated findings по всем твоим scans. Args: severity?: list, check_id?, since? (ISO 8601), limit?: 1..200.
- start_scanзапись
- Enqueues a scan and returns an id with status queued; poll get_scan to await completion. Passive mode is always available through MCP. Active mode requires a paid plan plus verified-domain authorization from the dashboard. Args: target (URL or hostname), mode? (passive|active).
- list_alertsчтение
- Оповещения об угрозах в реальном времени (диффы CT-логов, изменения DNS, списки threat intel). Доступно только на плане Unlimited; планы Hobby и Pro возвращают пустой список. Аргументы: domain_id?, active_only?, limit?: 1..200.
- get_alertчтение
- Single alert with the relevant domain, severity, type, and event details. Args: alert_id (uuid).
- dismiss_alertзапись · идемпотентно
- Пометить alert как dismissed. Idempotent — повторный dismiss ничего не меняет. Args: alert_id (uuid).
Ресурсы
Resources позволяют твоему client напрямую прикреплять данные FixVibe к беседе, вместо того чтобы agent заново загружал их на каждом turn. В Claude Desktop нажми menu @ → fixvibe.
- fixvibe://scan/{scan_id}/reportjson
- Полный отчет FixVibe scan, включая каждую check и каждую finding.
- fixvibe://finding/{finding_id}json
- Одна finding (severity, title, description, evidence, remediation, CWE).
Slash-команды
- /fixvibe-fixprompt
- Renders a server-side remediation prompt for a finding, using scan context when available and falling back to generic guidance otherwise. Args: finding_id (uuid). No third-party LLM API call is made by FixVibe.
→ Квоты, RLS и severity gating одинаково применяются к вызовам MCP и REST.
