// docs / mcp
Gweinydd MCP
Plygiwch FixVibe i Claude Desktop, Cursor, neu unrhyw gleient sy'n siarad Model Context Protocol. Mae eich asiant AI yn cael mynediad typed at eich sganiau, canfyddiadau, a'r un prompts trwsio wedi'u templedu sy'n pweru botwm Copy fix prompt y dashboard.
Creu token API
Ewch i /account/api-tokens a chreu token o'r enw, e.e., claude-desktop. Copïwch y gwerth plaintext; fe'i dangosir unwaith.
Mae tokens yn gredlythyrau bearer: gall unrhyw un â'r string ddarllen eich sganiau a dechrau rhai newydd. Cadwch ef fel cyfrinair.
Pwyntio eich cleient MCP at /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"
}
}
}
}Ailgychwynwch y cleient. Dylai'r gweinydd fixvibe ymddangos yn ei restr gweinyddion MCP.
Rhowch gynnig arno
Gofynnwch bethau fel hyn i'ch asiant:
- “Rhestra fy 10 sgan FixVibe diwethaf.”
- “Dangos y canfyddiadau critical ar y sgan mwyaf diweddar.”
- “Dechrau sgan goddefol yn erbyn
https://staging.example.com.” - “Ar gyfer pob canfyddiad high-severity ar sgan X, ysgrifennu trwsiad.”
- “A oes unrhyw rybuddion live-threat agored ar fy mharthau?”
- Teipiwch
/fixvibe-fixgydag id canfyddiad i ollwng y prompt adfer wedi'i dempledu yn syth i'r chat.
Offer
- list_scansread
- Yn dychwelyd hyd at 100 sgan mwyaf diweddar gyda status + cyfrifon canfyddiadau. Args: limit?: 1..100.
- get_scanread
- Envelope sgan + crynodeb difrifoldeb fesul categori yn ddiofyn. Gosod include_findings=true ar gyfer yr adroddiad llawn (mawr ar gyfer sganiau swnllyd; gwell list_findings + hidlwyr). Args: scan_id (uuid), include_findings?: boolean.
- list_findingsread
- Canfyddiadau wedi'u tudalennu ar draws eich holl sganiau. Args: severity?: list, check_id?, since? (ISO 8601), limit?: 1..200.
- start_scanwrite
- 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_alertsread
- Rhybuddion bygythiad byw (gwahaniaethau CT log, newidiadau DNS, rhestrau threat intel). Ar gael ar y cynllun Unlimited yn unig; mae'r cynlluniau Hobby a Pro yn dychwelyd rhestr wag. Args: domain_id?, active_only?, limit?: 1..200.
- get_alertread
- Single alert with the relevant domain, severity, type, and event details. Args: alert_id (uuid).
- dismiss_alertwrite · idempotent
- Marcio rhybudd yn dismissed. Idempotent: mae ail-ddismissio yn no-op. Args: alert_id (uuid).
Adnoddau
Mae adnoddau'n gadael i'ch cleient atodi data FixVibe yn uniongyrchol i'r sgwrs, yn hytrach na bod yr asiant yn ei ail-fetchio ar bob tro. Yn Claude Desktop, cliciwch y ddewislen @ → fixvibe.
- fixvibe://scan/{scan_id}/reportjson
- Adroddiad sgan FixVibe llawn gan gynnwys pob check a phob canfyddiad.
- fixvibe://finding/{finding_id}json
- Un canfyddiad (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.
→ Mae cwotâu, RLS, a gating difrifoldeb yn berthnasol yn union yr un fath i alwadau MCP a REST.
