# 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, התרעות על חבילות, קריאת אינטרנט ודפים, ניתוח קבצים, מודיעין רשת פסיבי ורישום הסקילים. אלה אותם כלים שרצים ב[צ׳אט המחקר](https://notholy.com/chat).

אם מחברים רק את ה-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` |

> [!NOTE]
> נקודות הקצה הגולמיות של המודל, `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.

```bash
claude mcp add --transport http notholy https://api.notholy.com/mcp --header "Authorization: Bearer $NOTHOLY_API_KEY"
```

[המדריך מקצה לקצה](/he/mcp/connect) עובר על קבלת מפתח, קריאה ל-`/v1` ל-inference, חיבור ה-MCP בלקוחות הנפוצים והפעלה של כל כלי עם קלט ופלט לדוגמה.

## באיזו דרך לבחור

- רוצים רק תשובות מודל מהקוד או מהלקוח שלכם: משתמשים ב-[API](/he/api/chat-completions). אין מה להגדיר מעבר לזה.
- רוצים שמודל (ב-Claude Code, ב-Cursor, בסוכן משלכם) יחפש CVEs, יחפש ב-CKE 2.0, יקרא דפים או ינתח קבצים: מחברים את [שרת ה-MCP](/he/mcp/remote).
- רוצים את הנתונים האלה בקוד שלכם בלי סוכן, כ-HTTP פשוט: [API המחקר](/he/api/research) חושף נתיבי CKE 2.0, CVE, התרעות, אינטרנט וקבצים תחת `/v1`.

## הבא

- [שימוש ב-API עם CKE 2.0 וכלים](/he/mcp/connect)
- [שרת MCP מרוחק](/he/mcp/remote)
- [שרת MCP מקומי](/he/mcp/local)
