Перейти к содержимому
NotHolyДокументация

MCP

API и MCP

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

Открыть как Markdown

У 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, бюллетени по пакетам, чтение веба и страниц, анализ файлов, пассивную сетевую разведку и реестр навыков. Это те же инструменты, на которых работает исследовательский чат.

Если подключить только API, вы получите одну модель. CKE 2.0 и инструменты находятся за MCP-сервером. Чтобы получить их, подключите MCP.

Что даёт каждый из них

API /v1MCP /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-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 для инференса, подключить MCP в популярных клиентах и использовать каждый инструмент, с примерами входа и выхода.

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

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

Что дальше