// docs / mcp
MCP server
Вклучете го FixVibe во Claude Desktop, Cursor или кој било client што зборува Model Context Protocol. Вашиот AI agent добива типизиран пристап до scans, findings и истите templated fix prompts што го напојуваат копчето Copy fix prompt во dashboard.
Издајте API token
Посетете /account/api-tokens и креирајте token именуван, на пример, claude-desktop. Копирајте ја plaintext value — се прикажува еднаш.
Tokens се bearer credentials: секој со string може да ги чита вашите scans и да стартува нови. Чувајте го како password.
Насочете го MCP client кон /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. Server fixvibe треба да се појави во неговата MCP server list.
Пробајте
Прашајте го 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 за да го drop-нете templated remediation prompt директно во chat.
Tools
- list_scansчитање
- Враќа до 100 most-recent scans со status + finding counts. Args: limit?: 1..100.
- get_scanчитање
- Scan envelope + per-category severity summary by default. Set include_findings=true за full report (large for noisy scans — prefer 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 враќаат празна листа. Args: 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запис · idempotent
- Означи alert како dismissed. Idempotent — re-dismissing е no-op. Args: alert_id (uuid).
Resources
Resources му дозволуваат на client да attach FixVibe data директно во conversation, наместо agent да re-fetch на секој turn. Во Claude Desktop, кликнете @ menu → fixvibe.
- fixvibe://scan/{scan_id}/reportjson
- Целосен FixVibe scan report со секој check и секој finding.
- fixvibe://finding/{finding_id}json
- Еден finding (severity, title, description, evidence, remediation, CWE).
Slash commands
- /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.
→ Quotas, RLS и severity gating важат идентично за MCP и REST calls.
