# API и MCP

> API даёт сырую модель. MCP-сервер даёт этой модели CKE 2.0 и инструменты исследования. Подключите оба.


У NotHoly две поверхности, и задачи у них разные.

- **API** по адресу `https://api.notholy.com/v1` — это чистый инференс. Вы отправляете сообщения и получаете ответ модели. API совместим с OpenAI и Anthropic, поэтому любой клиент, который говорит на этих API, говорит и на 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` |
|---|---|---|
| Инференс (chat, completions, сообщения Anthropic) | Да | Нет, это не эндпоинт инференса |
| Совместимость с OpenAI и Anthropic | Да | — |
| База знаний CKE 2.0 (`kb_search`, `kb_read`) | Нет | Да |
| Записи CVE и поиск по ним | Нет | Да |
| Бюллетени по пакетам (OSV) | Нет | Да |
| Поиск в вебе и чтение страниц | Нет | Да |
| Статический анализ файлов | Нет | Да |
| Пассивная сетевая разведка (IP, DNS, WHOIS, ASN, сайт, утечки) | Нет | Да |
| Поиск по индексу даркнета | Нет | Да |
| Реестр навыков | Нет | Да |
| Транспорт | 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"
```

В [сквозном руководстве](/ru/mcp/connect) разобрано, как получить ключ, вызвать `/v1` для инференса, подключить MCP в популярных клиентах и использовать каждый инструмент, с примерами входа и выхода.

## Какой путь вам нужен

- Вам нужны только ответы модели из своего кода или клиента: используйте [API](/ru/api/chat-completions). Больше ничего настраивать не нужно.
- Вы хотите, чтобы модель (в Claude Code, Cursor, вашем агенте) искала CVE, обращалась к CKE 2.0, читала страницы или анализировала файлы: подключите [MCP-сервер](/ru/mcp/remote).
- Вам нужны эти данные в собственном коде без агента, обычным HTTP: [Research API](/ru/api/research) отдаёт маршруты CKE 2.0, CVE, бюллетеней, веба и файлов под `/v1`.

## Что дальше

- [API с CKE 2.0 и инструментами](/ru/mcp/connect)
- [Удалённый MCP-сервер](/ru/mcp/remote)
- [Локальный MCP-сервер](/ru/mcp/local)
