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

MCP

API с CKE 2.0 и инструментами

Получите ключ, вызовите /v1 для инференса, подключите MCP ради CKE 2.0 и инструментов исследования, затем используйте каждый инструмент.

Открыть как Markdown

API отвечает моделью. MCP-сервер добавляет CKE 2.0 и инструменты. Это руководство проводит через оба шага от начала до конца. Если нужна краткая причина, почему они разделены, сначала прочитайте API и MCP.

1. Получите API-ключ

  1. Создайте аккаунт на notholy.com/signup и подтвердите почту.
  2. Пополните кредиты в разделе Billing. Минимальный депозит указан на этой странице.
  3. Откройте API keys и создайте ключ. Он начинается с nh_live_ и показывается один раз.

Один ключ работает и для API, и для MCP-сервера. Экспортируйте его:

Shell
export NOTHOLY_API_KEY="nh_live_..."

2. Вызовите /v1 для инференса

Это сырая модель: без поиска, без инструментов, только ответ.

curl https://api.notholy.com/v1/chat/completions \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "notholy-specter", "messages": [{"role": "user", "content": "Explain IDOR in two sentences."}]}'

Модель отвечает из собственных весов. Спросите у неё CVSS свежей CVE, и она сможет только угадать, потому что искать ей здесь негде. Это и исправляет MCP-сервер.

3. Подключите MCP ради CKE 2.0 и инструментов

Сервер говорит на MCP поверх Streamable HTTP по адресу https://api.notholy.com/mcp. Передавайте тот же ключ в Authorization: Bearer. Выберите свой клиент.

Claude Code

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

Или через конфигурацию, в .mcp.json или ~/.claude.json:

JSON
{"mcpServers": {"notholy": {"type": "http", "url": "https://api.notholy.com/mcp", "headers": {"Authorization": "Bearer ${NOTHOLY_API_KEY}"}}}}

Cursor

Добавьте сервер в .cursor/mcp.json проекта (или в ~/.cursor/mcp.json для всех проектов):

JSON
{"mcpServers": {"notholy": {"url": "https://api.notholy.com/mcp", "headers": {"Authorization": "Bearer nh_live_..."}}}}

Claude Desktop

Claude Desktop читает mcpServers из своего файла конфигурации (Settings → Developer → Edit Config). Удалённый сервер он подключает через mcp-remote:

JSON
{"mcpServers": {"notholy": {"command": "npx", "args": ["-y", "mcp-remote", "https://api.notholy.com/mcp", "--header", "Authorization: Bearer nh_live_..."]}}}

Перезапустите Claude Desktop. Инструменты notholy появятся в меню инструментов.

Свой код (MCP SDK)

Подойдёт любая клиентская библиотека MCP. Направьте её транспорт Streamable HTTP на этот URL и задайте заголовок.

import os, asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://api.notholy.com/mcp"
HEADERS = {"Authorization": f"Bearer {os.environ['NOTHOLY_API_KEY']}"}

async def main():
    async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])
            out = await session.call_tool("cve_lookup", {"id": "CVE-2021-44228"})
            print(out.structuredContent)

asyncio.run(main())

Чистый JSON-RPC

Сервер — это обычный JSON-RPC 2.0 поверх HTTP, так что для списка инструментов или вызова одного из них хватит curl.

curl
curl https://api.notholy.com/mcp \
  -H "Authorization: Bearer $NOTHOLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

4. Используйте инструменты

Каждый вызов инструмента — это сообщение tools/call. Ответ содержит две копии результата: content[0].text (с префиксом в виде строки, которая помечает его как недоверенные внешние данные) и structuredContent.data (разобранный объект). В примерах ниже показан сокращённый structuredContent.data.

kb_search: поиск по CKE 2.0

Ищет по курируемой базе знаний по безопасности. Фильтруйте по domain (web, api, mobile, offensive, tools, cloud, ir, attack), source или tool. Каждый результат несёт лицензию источника и id документа для kb_read.

JSON
{"jsonrpc": "2.0", "id": 2, "method": "tools/call",
 "params": {"name": "kb_search", "arguments": {"query": "ssrf prevention", "domain": "web", "limit": 3}}}
JSON
{"data": {"hits": [
  {"id": "owasp-cheatsheet-ssrf", "title": "SSRF Prevention Cheat Sheet", "source": "OWASP", "licence": "CC-BY-SA-4.0", "score": 0.82,
   "snippet": "Validate the host against an allow-list, resolve it, and pin the connection to the resolved IP..."}
]}}

kb_read: открыть документ

Читает один документ CKE 2.0 по id (из kb_search), постранично по разделам через from и limit.

JSON
{"jsonrpc": "2.0", "id": 3, "method": "tools/call",
 "params": {"name": "kb_read", "arguments": {"id": "owasp-cheatsheet-ssrf", "from": 0, "limit": 2}}}
JSON
{"data": {"id": "owasp-cheatsheet-ssrf", "title": "SSRF Prevention Cheat Sheet", "source": "OWASP",
  "sections": [{"heading": "Allow-list the destination", "text": "..."}],
  "next": 2, "total": 9}}

cve_lookup: одна запись CVE

Сводная запись по идентификатору CVE: описание, CVSS, EPSS, статус в CISA KEV, затронутые продукты и ссылки.

JSON
{"jsonrpc": "2.0", "id": 4, "method": "tools/call",
 "params": {"name": "cve_lookup", "arguments": {"id": "CVE-2021-44228"}}}
JSON
{"data": {"id": "CVE-2021-44228", "cvss": {"score": 10.0, "vector": "CVSS:3.1/AV:N/AC:L/..."},
  "epss": {"score": 0.975, "percentile": 0.999}, "kev": {"listed": true, "known_ransomware": true},
  "cwe": ["CWE-502", "CWE-917"], "references": ["https://nvd.nist.gov/vuln/detail/CVE-2021-44228"]}}

cve_search: поиск по CVE

Поиск по тексту, вендору или CWE с фильтрами min_cvss, min_epss и kev.

JSON
{"jsonrpc": "2.0", "id": 5, "method": "tools/call",
 "params": {"name": "cve_search", "arguments": {"vendor": "apache", "cwe": "CWE-502", "kev": true, "limit": 5}}}

Остальные инструменты в одну строку

Полный список с лимитами см. в разделе Удалённый MCP-сервер. Остальные устроены так же:

  • advisory_query — бюллетени для пакета: {"name": "lodash", "ecosystem": "npm", "version": "4.17.15"}.
  • web_search — публичный веб: {"query": "log4shell detection"}.
  • read_url — одна публичная страница через читалку с защитой от SSRF: {"url": "https://example.com/advisory"}.
  • analyze_file — статический анализ; удалённо передавайте name и content_base64: {"name": "handler.js", "content_base64": "..."}.
  • ip_info, domain_info, asn_lookup, site_check, breach_check — пассивная сетевая разведка.
  • port_scan — единственный активный инструмент; сканируйте только хосты, которые вам разрешено проверять.
  • darkweb_search — поиск по индексу Tor; вызывайте его, только когда пользователь просит поиск по даркнету.
  • skills_search, skill_get, skill_invoke — реестр навыков.

Кредит и лимиты

Инструментам нужен кредит на счёте. Без него маршруты исследования отвечают 402 insufficient_credits, а вызов инструмента возвращает это сообщение вместо результата, со ссылкой на оплату. Сервер MCP при этом подключается и показывает список инструментов. Вызовы считаются в лимит 120 запросов в минуту для маршрутов исследования. Инференс на /v1 оплачивается за токены, а инструменты исследования токены не расходуют.

Что дальше