MCP
API מול MCP
ה-API נותן את המודל הגולמי. שרת ה-MCP נותן למודל את CKE 2.0 ואת כלי המחקר. אפשר לחבר את שניהם.
NotHoly מגישה שני ממשקים, ולכל אחד תפקיד אחר.
- ה-API בכתובת
https://api.notholy.com/v1הוא inference גולמי. שולחים הודעות ומקבלים את התשובה של המודל. הוא תואם ל-OpenAI ול-Anthropic, ולכן כל לקוח שמדבר עם ה-APIs האלה מדבר גם עם NotHoly. כאן למודל אין שליפת מידע ואין כלים משלו. - שרת ה-MCP בכתובת
https://api.notholy.com/mcpהוא שכבת האינטליגנציה. הוא נותן למודל את Cybersecurity Knowledge Engine 2.0 (CKE 2.0) ואת כלי המחקר: רשומות CVE, התרעות על חבילות, קריאת אינטרנט ודפים, ניתוח קבצים, מודיעין רשת פסיבי ורישום הסקילים. אלה אותם כלים שרצים בצ׳אט המחקר.
אם מחברים רק את ה-API, מקבלים את המודל לבדו. CKE 2.0 והכלים נמצאים מאחורי שרת ה-MCP. כדי לקבל אותם, מחברים את ה-MCP.
מה כל אחד נותן
API /v1 | MCP /mcp | |
|---|---|---|
| Inference (צ׳אט, השלמות, הודעות Anthropic) | כן | לא, זו לא נקודת קצה ל-inference |
| תואם ל-OpenAI ול-Anthropic | כן | — |
בסיס הידע CKE 2.0 (kb_search, kb_read) | לא | כן |
| רשומות CVE וחיפוש | לא | כן |
| התרעות על חבילות (OSV) | לא | כן |
| חיפוש ברשת וקריאת דפים | לא | כן |
| ניתוח סטטי של קבצים | לא | כן |
| מודיעין רשת פסיבי (IP, DNS, WHOIS, ASN, אתר, דליפות) | לא | כן |
| חיפוש באינדקס ה-dark web | לא | כן |
| רישום הסקילים | לא | כן |
| תעבורה | HTTP (REST, SSE לסטרימינג) | Streamable HTTP (MCP, JSON-RPC) |
| אימות | Authorization: Bearer או x-api-key | Authorization: Bearer |
נקודות הקצה הגולמיות של המודל, POST /v1/chat/completions, /v1/responses ו-/v1/messages, לא כוללות אף אחד מהכלים האלה. המודל מקבל רק את כלי הפונקציה שאתם מגדירים ושולחים, והקוד שלכם מריץ אותם. שרת ה-MCP הוא הדרך לתת למודל את הכלים של NotHoly בלי לכתוב את החיווט הזה בעצמכם.
רוצים את CKE 2.0 ואת הכלים? מחברים את ה-MCP
מכוונים את לקוח ה-MCP אל https://api.notholy.com/mcp ושולחים את מפתח ה-API בכותרת Authorization: Bearer. אותו מפתח עובד גם ב-API וגם בשרת ה-MCP.
claude mcp add --transport http notholy https://api.notholy.com/mcp --header "Authorization: Bearer $NOTHOLY_API_KEY"המדריך מקצה לקצה עובר על קבלת מפתח, קריאה ל-/v1 ל-inference, חיבור ה-MCP בלקוחות הנפוצים והפעלה של כל כלי עם קלט ופלט לדוגמה.
באיזו דרך לבחור
- רוצים רק תשובות מודל מהקוד או מהלקוח שלכם: משתמשים ב-API. אין מה להגדיר מעבר לזה.
- רוצים שמודל (ב-Claude Code, ב-Cursor, בסוכן משלכם) יחפש CVEs, יחפש ב-CKE 2.0, יקרא דפים או ינתח קבצים: מחברים את שרת ה-MCP.
- רוצים את הנתונים האלה בקוד שלכם בלי סוכן, כ-HTTP פשוט: API המחקר חושף נתיבי CKE 2.0, CVE, התרעות, אינטרנט וקבצים תחת
/v1.