// docs / mcp

MCP server

FixVibe bike nav Claude Desktop, Cursor, an her clientek ku Model Context Protocol diaxive. Agentê AI ya te gihîştina typed li scan, finding û heman promptên sererastkirina bi qalib ku bişkoka Copy fix prompt a dashboardê dimeşînin werdigire.

API tokenek çêbike

Here /account/api-tokens û tokenek bi navek wekî claude-desktop çêbike. Nirxa plaintext kopî bike — carekê tê nîşandan.

Token credentialsên bearer in: her kesê ku string hebe dikare scanên te bixwîne û yên nû dest pê bike. Wê wekî password hilanîne.

Clienta MCP ya xwe li /api/mcp nîşan bide

Claude Desktop / Cursor / Continue / Zed:

{
  "mcpServers": {
    "fixvibe": {
      "transport": "streamable-http",
      "url": "https://fixvibe.app/api/mcp",
      "headers": {
        "Authorization": "Bearer fxv_YOUR_TOKEN_HERE"
      }
    }
  }
}

Client ji nû ve dest pê bike. Servera fixvibe divê di lîsteya MCP server de xuya bibe.

Biceribîne

Ji agenta xwe tiştên wiha bipirse:

“10 scanên dawî yên FixVibe yên min lîste bike.”
“Findingên critical li ser scan-a herî dawî nîşan bide.”
“Scanek passive li dijî https://staging.example.com dest pê bike.”
“Ji bo her finding-a high-severity li ser scan X, sererastkirinek binivîse.”
“Li ser domainên min hişyariyên live-threat vekirî hene?”
/fixvibe-fix bi finding id binivîse da prompt-a remediation ya bi qalib rasterast bike nav chatê.

Amûr

list_scansxwendin: Heta 100 scanên herî dawî bi status + hejmarên finding vedigerîne. Args: limit?: 1..100.
get_scanxwendin: Bi default envelope-a scan + kurtasiya severity ya her category. Ji bo rapora tevahî include_findings=true bike (ji bo scanên dengdar mezin e — list_findings + filteran tercîh bike). Args: scan_id (uuid), include_findings?: boolean.
list_findingsxwendin: Findingên paginated li ser hemû scanên te. Args: severity?: list, check_id?, since? (ISO 8601), limit?: 1..200.
start_scannivîsandin: 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_alertsxwendin: Hişyariyên tehdîda zindî (cudahiyên CT log, guhertinên DNS, lîsteyên threat intel). Tenê di plana Unlimited de berdest; planên Hobby û Pro lîsteyek vala vedigerînin. Args: domain_id?, active_only?, limit?: 1..200.
get_alertxwendin: Single alert with the relevant domain, severity, type, and event details. Args: alert_id (uuid).
dismiss_alertnivîsandin · idempotent: Hişyariyek wek dismissed nîşan bike. Idempotent — dismisskirina ji nû ve no-op e. Args: alert_id (uuid).

Çavkanî

Resources dihêlin clienta te daneyên FixVibe rasterast bike nav axaftinê, ne ku agent di her turnê de wan ji nû ve fetch bike. Di Claude Desktop de, menuya @ bikire → fixvibe.

fixvibe://scan/{scan_id}/reportjson: Rapora scan-a FixVibe ya tevahî, tevî her check û her finding.
fixvibe://finding/{finding_id}json: Findingek yekane (severity, sernav, danasîn, evidence, remediation, CWE).

Fermanên 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.

→ Quota, RLS, û gating-a severity bi awayek heman li ser MCP û bangên REST tên sepandin.