Справочник

MCP-сервер

Model Context Protocol (MCP) — открытый стандарт для подключения инструментов к ИИ-агентам. Через MCP-сервер srezai.ru агент получает поиск и исследования как встроенные инструменты, без ручной интеграции REST.

Что такое MCP

MCP позволяет ассистентам (Claude, IDE-агентам и совместимым клиентам) вызывать внешние инструменты по единому протоколу. Вы подключаете сервер один раз — агент сам решает, когда искать в вебе.

Эндпоинт#

Сервер работает по транспорту Streamable HTTP на едином адресе. Авторизация — тем же ключом srz_live_…, что и REST:

POSThttps://srezai.ru/api/mcp

Подключение#

Добавьте srezai.ru в конфигурацию MCP-клиента, указав ваш API-ключ в заголовке Authorization:

json
{
  "mcpServers": {
    "srezai": {
      "url": "https://srezai.ru/api/mcp",
      "headers": {
        "Authorization": "Bearer srz_live_ВАШ_КЛЮЧ"
      }
    }
  }
}

Формат ключа и правила безопасности — в разделе Аутентификация.

Доступные инструменты#

  • web_search — веб-поиск с категориями и фильтрами. Параметры: query (обязателен), category, timeRange, language, num, excerpts (подтянуть реальный текст топ-страниц), includeDomains / excludeDomains (искать только на указанных сайтах или исключить их, до 10 доменов). Та же логика, что и у /api/v1/search.
  • image_search — поиск изображений. Параметры: query (обязателен), timeRange, safe. См. /api/v1/media.
  • read_url — текст страницы в чистом markdown. Параметры: url (обязателен), maxChars (200–50000), engine (auto по умолчанию). Скриншот не делает — дешевле и быстрее fetch_page. См. /api/v1/read.
  • read_urls — то же чтение для пачки ссылок. Параметры: urls (обязателен, 1–5 адресов), maxChars, engine. Страницы читаются параллельно, упавшая ссылка не отменяет остальные, каждая тарифицируется как отдельное чтение. См. Несколько страниц за раз.
  • fetch_page — скриншот и структура страницы. Параметры: url (обязателен), maxChars (сколько символов текста вернуть, 200–50000). Открывает страницу в браузере и возвращает скриншот картинкой (её видит vision-модель), ссылку на полноразмерный PNG и текст в markdown. См. /api/v1/fetch.
  • extract — структурированные данные со страницы по вашей JSON Schema. Параметры: url или urls (1–5 ссылок, одна схема на все), schema (обязателен), instruction, engine. Возвращает только описанные схемой поля; чего на странице нет — null. См. /api/v1/extract.
  • deep_research — агентное исследование. Параметр: query (обязателен). Синхронный вызов на 10 сек – 2 мин. См. DeepResearch.
  • get_usage — остаток на счёте, расход суточной квоты, burst-лимит и цены инструментов в кредитах. Без параметров. Вызов бесплатный и квоту не расходует, поэтому агент может спросить остаток даже упёршись в лимит. REST-аналога нет: в REST то же самое приходит в заголовках X-RateLimit-*.

Проверка: список инструментов#

Убедиться, что сервер отвечает и ключ принят, можно вызовом tools/list по JSON-RPC 2.0. Заголовок Accept обязателен — сервер отвечает потоком text/event-stream:

bash
curl -X POST https://srezai.ru/api/mcp \
  -H "Authorization: Bearer srz_live_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Предпочитаете REST?

MCP — это удобная обёртка. Если вы строите собственный пайплайн, работайте напрямую с REST API — контракты те же самые.