דילוג לתוכן
NotHolyתיעוד

MCP

API מול MCP

ה-API נותן את המודל הגולמי. שרת ה-MCP נותן למודל את CKE 2.0 ואת כלי המחקר. אפשר לחבר את שניהם.

להציג כ-Markdown

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 /v1MCP /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-keyAuthorization: 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.

Shell
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.

הבא