// docs / mcp
Server MCP
Conectează FixVibe la Claude Desktop, Cursor sau orice client care vorbește Model Context Protocol. Agentul tău AI primește acces tipizat la scanările și constatările tale, plus aceleași prompturi de remediere șablonate care alimentează butonul Copy fix prompt din dashboard.
Emite un token API
Vizitează /account/api-tokens și creează un token numit, de exemplu, claude-desktop. Copiază valoarea în text clar: este afișată o singură dată.
Tokenurile sunt credențiale bearer: oricine are șirul îți poate citi scanările și poate porni unele noi. Stochează-l ca pe o parolă.
Indică-i clientului 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"
}
}
}
}Repornește clientul. Serverul fixvibe ar trebui să apară în lista sa de servere MCP.
Încearcă-l
Întreabă-ți agentul lucruri precum:
- „Listează ultimele mele 10 scanări FixVibe.”
- „Arată-mi constatările critice din cea mai recentă scanare.”
- „Pornește o scanare pasivă pentru
https://staging.example.com.” - „Pentru fiecare constatare de severitate înaltă din scanarea X, scrie o remediere.”
- „Există alerte live-threat deschise pe domeniile mele?”
- Tastează
/fixvibe-fixcu un id de constatare ca să inserezi promptul de remediere șablonat direct în chat.
Unelte
- list_scanscitire
- Întoarce până la 100 dintre cele mai recente scanări, cu stare + număr de constatări. Argumente: limit?: 1..100.
- get_scancitire
- Implicit, anvelopa scanării + rezumatul severității pe categorie. Setează include_findings=true pentru raportul complet (mare pentru scanări zgomotoase: preferă list_findings + filtre). Argumente: scan_id (uuid), include_findings?: boolean.
- list_findingscitire
- Constatări paginate din toate scanările tale. Argumente: severity?: list, check_id?, since? (ISO 8601), limit?: 1..200.
- start_scanscriere
- 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_alertscitire
- Alerte de amenințare live (diff-uri CT log, schimbări DNS, listări de threat intel). Disponibile doar pe planul Unlimited; planurile Hobby și Pro returnează o listă goală. Args: domain_id?, active_only?, limit?: 1..200.
- get_alertcitire
- Single alert with the relevant domain, severity, type, and event details. Args: alert_id (uuid).
- dismiss_alertscriere · idempotent
- Marchează o alertă ca respinsă. Idempotent: respingerea repetată nu face nimic. Argumente: alert_id (uuid).
Resurse
Resursele îi permit clientului tău să atașeze date FixVibe direct în conversație, în loc ca agentul să le refetch-uiască la fiecare tură. În Claude Desktop, apasă meniul @ → fixvibe.
- fixvibe://scan/{scan_id}/reportjson
- Raport complet de scanare FixVibe, incluzând fiecare verificare și fiecare constatare.
- fixvibe://finding/{finding_id}json
- O singură constatare (severitate, titlu, descriere, dovezi, remediere, CWE).
Comenzi 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.
→ Cotele, RLS și gatingul pe severitate se aplică identic apelurilor MCP și REST.
