Подключение

Три интерфейса срезAI: MCP, CLI и REST API

Один и тот же набор инструментов — веб-поиск, чтение страниц, карта сайта, извлечение по схеме, проверка фактов, готовые ответы — доступен тремя способами. Ключ и баланс общие: можно начать с одного, а потом добавить остальные.

Коротко

Клиент умеет MCP — берите MCP. Агент запускает команды — берите CLI со скиллом: дешевле по контексту. Пишете свой код — берите REST API. Не уверены — начните с промпта на странице интеграций: он работает без настройки и без ключа.

  • Готовые клиенты

    MCP-сервер

    Протокол, по которому агент получает инструменты как встроенные: он сам решает, когда звать поиск, чтение или проверку фактов.

    Кому:
    Claude Desktop, Cursor, Claude Code, n8n и другие клиенты с поддержкой MCP.
    Плюс:
    Подключили один раз — доступны все инструменты сразу, без кода.
    Минус:
    Описания инструментов висят в каждом запросе: ≈10,8 тыс. токенов в каждом запросе.
    Настройка:
    2–5 минут: адрес сервера и ключ в конфиг клиента.
    Готовые конфиги по клиентам

  • Терминал и агент

    CLI и скилл

    Команда srezai, которую агент запускает как обычную программу. Скилл — короткая инструкция, чтобы агент знал, какую команду и когда звать.

    Кому:
    Claude Code, Codex, DSH, bash-агенты, скрипты и CI.
    Плюс:
    Дешевле по контексту: 0,3–1,7 тыс. токенов на задачу вместо описаний всех инструментов.
    Минус:
    Нужен Node.js 18+ и агент, который умеет запускать команды.
    Настройка:
    Десять секунд: npx без установки, ключ одной командой.
    Инструкция по CLI и скиллу

  • Свой код

    REST API

    HTTP-методы /api/v1/*: поиск, чтение страницы, карта сайта, извлечение по схеме, проверка утверждений, готовые ответы.

    Кому:
    Python, TypeScript, Go, бэкенды, RAG-пайплайны и HTTP-нода в n8n.
    Плюс:
    Полный контроль над запросами, ответами и ретраями; контекст модели не расходуется.
    Минус:
    Нужно написать код и самому обрабатывать ошибки и лимиты.
    Настройка:
    Ключ и один POST-запрос; примеры в документации.
    Документация API

Сравнение по делу

MCPCLI + скиллREST API
Что этоПротокол для клиентовКоманда в терминалеHTTP-методы
КомуCursor, Claude, n8nClaude Code, Codex, DSHСвой код, скрипты
Контекст≈10,8 тыс. токенов в каждом запросе0,3–1,7 тыс. токенов на задачу0 — отвечает ваша программа
Что ставитьКонфиг и ключNode.js 18+Ничего, только HTTP
Пробный режим без ключаДа, search/readДа, search/read/transcriptДа, search/read
Когда выбиратьКлиент уже умеет MCPАгент умеет запускать командыНужен полный контроль

Что выбрать в вашей ситуации

  • Клиент умеет MCP (Cursor, Claude Desktop, n8n)

    Берите MCP: конфиг из готовых, ключ, перезапуск. Это самый короткий путь без кода. Конфиги MCP

  • Агент работает в терминале (Claude Code, Codex, DSH)

    Берите CLI со скиллом: агент сам узнает, как искать и читать, и потратит в 6–30 раз меньше контекста. CLI и скилл

  • Пишете свой сервис или скрипт

    Берите REST API: те же инструменты, полный контроль и никакого расхода контекста модели. Документация API

  • Пока не понятно, нужен ли вообще веб-поиск

    Скопируйте промпт на странице интеграций и вставьте в чат агента: он начнёт искать в пробном режиме без ключа и настройки. Скопировать промпт

Проверьте без ключа и регистрации

Пробный режим включён для поиска, чтения страницы и субтитров: 25 запросов в сутки с одного IP. Один и тот же запрос любым интерфейсом:

CLInpx srezai-cli search "ИИ в России законы 2026" --num 3
MCPhttps://srezai.ru/api/mcp
REST APIcurl -s https://srezai.ru/api/v1/search -H "Content-Type: application/json" -d '{"query":"ИИ в России законы 2026","num":3}'

Скилл и промпт — не четвёртый интерфейс

Рядом с тремя интерфейсами стоят две инструкции. Скилл — текст, который учит агента, когда и какой инструмент звать: npx skills add srezai-team/srezai-web-search-pro-skill, каталог https://skills.sh/srezai-team/srezai-web-search-pro-skill. Промпт — текст для первого подключения: его копируют на странице интеграций и вставляют в чат агента. Подробная инструкция, которую агент читает сам, — /agent-onboarding.md.

Частые вопросы

Чем MCP отличается от CLI?

MCP — протокол: клиент сам видит инструменты и вызывает их как встроенные, но описания всех инструментов едут в каждом запросе (около 10,8 тыс. токенов). CLI — команда: агент запускает её как программу, а в контексте держит только короткое описание навыка (0,3–1,7 тыс. токенов). Функции и цены у них одинаковые.

Что выбрать для Cursor, Claude Desktop или n8n?

MCP: эти клиенты поддерживают протокол, подключение занимает минуту — вставить адрес https://srezai.ru/api/mcp и ключ в готовый конфиг. Инструкция и конфиги — на странице интеграций.

Что выбрать для Claude Code, Codex или своего bash-агента?

CLI и скилл: npx srezai-cli работает без установки, а npx skills add srezai-team/srezai-web-search-pro-skill ставит навык, после которого агенту достаточно сказать «поищи в интернете». Так дешевле по контексту и воспроизводимо в скриптах.

Нужен ли отдельный ключ для каждого интерфейса?

Нет, ключ один на MCP, CLI и REST API, баланс тоже общий. Без ключа работает пробный режим: поиск, чтение страницы и субтитры — 25 запросов в сутки с одного IP. Новому ключу сразу начисляются 20 стартовых кредитов.

Можно ли пользоваться MCP и CLI одновременно?

Да, это нормальный сценарий: например, MCP для Cursor и CLI для Claude Code. Один ключ, один баланс, одинаковые цены и лимиты.

Скилл и промпт — это четвёртый интерфейс?

Нет. Скилл и промпт не дают доступа сами по себе: это инструкции, которые объясняют агенту, как пользоваться одним из трёх интерфейсов — MCP, CLI или REST API.

Сколько стоит один запрос?

1 кредит = 0,10 ₽. Поиск и чтение страницы — 1 кредит, извлечение — 2, проверка утверждения — 8, готовый ответ — от 3. Неудачный или пустой вызов не списывается. Новому ключу — 20 стартовых кредитов, ещё 100 ₽ бонусом после подтверждения Telegram.

Подключить MCPЦены: 0,10 ₽ за запрос

Исходники открыты: репозиторий CLI и пакет в npm. Ещё: MCP-сервер, CLI и скиллы, REST API.