// docs / mcp
MCP server
FixVibe ናብ Claude Desktop, Cursor, ወይ ናብ ዝኾነ Model Context Protocol ዝዛረብ client ኣብጽሖ። AI agentካ ናብ scansካ፣ findingsካ፣ ከምኡውን እቶም ኣብ dashboard Copy fix prompt ዘስርሑ templated fix prompts ብ type ዝተወሰነ መእተዊ ይረክብ።
API token ፍጠር
ናብ /account/api-tokens ኪድ፣ ንኣብነት claude-desktop ዝብል token ፍጠር። 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 እንደገና ጀምር። fixvibe server ኣብ MCP server list ክርአ ኣለዎ።
ፈትኖ
Agentካ ከምዚ ዝብሉ ነገራት ሕተቶ:
- “ናይ መወዳእታ 10 FixVibe scans ዘርዝርለይ።”
- “ኣብ ዝሓደሰ scan ዘለዉ critical findings ኣርእየኒ።”
- “ኣብ
https://staging.example.compassive scan ጀምር።” - “ንነፍሲ ወከፍ high-severity finding ኣብ scan X መፍትሒ ጽሓፍ።”
- “ኣብ domainsይ open live-threat alerts ኣለዉዶ?”
- Finding id ምስ
/fixvibe-fixጽሓፍ፣ templated remediation prompt ቀጥታ ናብ chat ክወድቕ።
መሳርሒታት
- list_scansኣንብብ
- ክሳብ 100 ዝሓደሱ scans ምስ status + finding counts ይመልስ። Args: limit?: 1..100።
- get_scanኣንብብ
- ብ default scan envelope + per-category severity summary። include_findings=true ንምሉእ report ኣቐምጥ (ን noisy 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 log ፍልልያት፣ ናይ 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 እዩ፤ እንደገና dismiss ምግባር no-op እዩ። Args: alert_id (uuid)።
Resources
Resources clientካ FixVibe data ቀጥታ ናብ ዝርርብ ከተሓሕዝ የኽእሉ፣ agent ኣብ ነፍሲ ወከፍ turn እንደገና fetch ክገብር ኣየድልን። ኣብ 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 ተመሳሳሊ ይትግበሩ።
