// docs / mcp

خادم MCP

وصّل FixWeb بـ Claude Desktop أو Cursor أو أي عميل يتحدث Model Context Protocol. يحصل وكيل الذكاء الاصطناعي لديك على وصول مضبوط الأنواع إلى فحوصك ونتائجك، وإلى نفس مطالبات الإصلاح القالبية التي تشغّل زر نسخ مطالبة الإصلاح في لوحة التحكم.

أنشئ رمز API

زُر /account/api-tokens وأنشئ رمزًا باسم، مثلًا، claude-desktop. انسخ القيمة النصية — تُعرض مرة واحدة.

الرموز هي بيانات اعتماد Bearer: أي شخص يحمل السلسلة يمكنه قراءة فحوصك وبدء فحوص جديدة. خزّنها ككلمة مرور.

وجّه عميل MCP إلى /api/mcp

Claude Desktop / Cursor / Continue / Zed:

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

أعد تشغيل العميل. ينبغي أن يظهر خادم fixweb في قائمة خوادم MCP لديه.

جرّبه

اطلب من وكيلك أشياء مثل:

“اعرض آخر 10 فحوص FixWeb لدي.”
“أرني النتائج الحرجة في أحدث فحص.”
“ابدأ فحصًا سلبيًا ضد https://staging.example.com.”
“لكل نتيجة عالية الشدة في الفحص X، اكتب إصلاحًا.”
“هل توجد أي تنبيهات تهديد مباشر مفتوحة على نطاقاتي؟”
اكتب /fixweb-fix مع معرّف نتيجة لإسقاط مطالبة العلاج القالبية مباشرة في المحادثة.

الأدوات

list_scansقراءة: يعيد حتى 100 من أحدث الفحوص مع الحالة + أعداد النتائج. الوسائط: limit?: 1..100.
get_scanقراءة: غلاف الفحص + ملخص الشدة لكل فئة افتراضيًا. عيّن include_findings=true للتقرير الكامل (كبير للفحوص كثيرة الضوضاء — فضّل list_findings + المرشحات). الوسائط: scan_id (uuid)، include_findings?: boolean.
list_findingsقراءة: نتائج مرقمة الصفحات عبر كل فحوصك. الوسائط: severity?: list، check_id?، since? (ISO 8601)، limit?: 1..200.
start_scanكتابة: Enqueues a passive scan. Returns an id with status queued; poll get_scan to await completion. Owner-depth mode is gated behind on-site attestation and not exposed via MCP. Args: target (URL or hostname).
list_alertsقراءة: تنبيهات تهديد حية (فروقات سجلات CT، وتغييرات DNS، وقوائم استخبارات التهديدات). متاحة فقط على خطة Unlimited؛ تُعيد خطتا Hobby و Pro قائمة فارغة. الوسائط: domain_id?، active_only?، limit?: 1..200.
get_alertقراءة: تنبيه واحد مع الحمولة الكاملة (فرق DNS، وشهادات جديدة، وتفاصيل الإدراج). الوسائط: alert_id (uuid).
dismiss_alertكتابة · idempotent: وضع علامة مرفوض على تنبيه. Idempotent — إعادة الرفض لا تفعل شيئًا. الوسائط: alert_id (uuid).

الموارد

تتيح الموارد لعميلك إرفاق بيانات FixWeb في المحادثة مباشرة، بدل أن يعيد الوكيل جلبها في كل دور. في Claude Desktop، انقر قائمة @ → fixweb.

fixweb://scan/{scan_id}/reportjson: تقرير فحص FixWeb الكامل بما في ذلك كل فحص وكل نتيجة.
fixweb://finding/{finding_id}json: نتيجة واحدة (الشدة، العنوان، الوصف، الدليل، العلاج، CWE).

أوامر الشرطة المائلة

/fixweb-fixprompt: يعرض مطالبة علاج قالبية لنتيجة. يكتشف إطار قاعدة الشفرة من بصمة التقنية في الفحص ويحقن نصائح خاصة بالإطار عند توفرها؛ وإلا يعود إلى وصفة عامة. الوسائط: finding_id (uuid). لا يوجد استدعاء Claude API — قالبية من جهة الخادم.

→ تنطبق الحصص وRLS وبوابات الشدة بالطريقة نفسها على استدعاءات MCP وREST.