API и MCP

MCP для ИИ-агентов — паспорт домена

Как подключить MCP-сервер ZRAZU к Claude, ChatGPT или Cursor: адрес, инструмент паспорта домена, лимиты и то, чего агент не видит.

MCP — способ дать ИИ-ассистенту доступ к внешнему инструменту. Сервер ZRAZU открытый: ключ и регистрация не нужны. У него один инструмент — паспорт домена, и он только читает.

Что получает агент

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

  • Через MCP ничего нельзя изменить: ни домен, ни записи, ни счёт.
  • Персональные данные владельца домена мы не отдаём никогда.
  • Слова «свободно» через MCP нет. Доказать, что имя свободно, может только реестр, и только в момент покупки. Если источники не подтвердили, что домен занят, ответ — «не смогли проверить».

Подключить

Адрес сервера: https://api.zrazu.com/mcp. Аутентификация — «без аутентификации».

Claude, ChatGPT и другие клиенты с удалёнными MCP-серверами.

  1. Откройте настройки подключений (коннекторов) вашего клиента и добавьте собственный MCP-сервер.
  2. Укажите адрес https://api.zrazu.com/mcp.
  3. В поле аутентификации выберите «без аутентификации».

Claude Code:

claude mcp add --transport http zrazu https://api.zrazu.com/mcp

Cursor, VS Code и другие клиенты с конфигурацией JSON:

{ "mcpServers": { "zrazu": { "type": "http", "url": "https://api.zrazu.com/mcp" } } }

Транспорт — Streamable HTTP. Каждый запрос — отдельный POST, ответ — один JSON.

Инструмент domain_passport

Вход — domain: имя домена (kava.com.ua), адрес страницы (https://kava.com.ua/menu) или почты (hello@kava.com.ua). Домен выделяется сам, до 300 знаков.

Пример запроса к агенту: «Проверь домен kava.com.ua: когда истекает и всё ли в порядке с почтой».

Выход — паспорт в JSON и тот же текст:

ПолеЧто это
statetaken — домен занят; unknown — не смогли проверить
phraseодно предложение о домене человеческим языком
barsчетыре полосы состояния: domain, dns, site, mail
statusesстатусы реестра с пояснением
lifecycleэтап, даты регистрации и окончания, когда имя может освободиться
nameservers, registrarсерверы имён и регистратор
problemsнайденные проблемы, чем грозят, готовое исправление
checked_atкогда именно смотрели

Если имя не удалось проверить, ответ короткий: state: "unknown", причина reason и retry: true — стоит спросить позже.

Запрос вручную

Сессия начинается с initialize; сервер возвращает номер сессии в заголовке Mcp-Session-Id. Номер действует 24 часа.

curl -si https://api.zrazu.com/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}' \
  | grep -i mcp-session-id

curl -s https://api.zrazu.com/mcp -H 'content-type: application/json' -H 'Mcp-Session-Id: <номер>' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"domain_passport","arguments":{"domain":"kava.com.ua"}}}'

Лимиты

ЧтоЛимит
Паспорт через MCP30 в минуту и 300 в час на сессию
Все сессии с одного адресав 10 раз больше
Новые сессии с одного адреса600 в час

Паспорт кэшируется до 6 часов (для домена в очереди на удаление — 15 минут). Когда именно смотрели, видно в checked_at.

Приватность

Каждый запрос записывается в журнал без вашего адреса и без имени домена: только инструмент, результат и время. Каждое проверенное имя на 90 дней попадает в стоп-лист: мы не берём его себе, в стоп-листе лежит отпечаток имени, а не само имя.

Если не получилось

  • Ответ `404`. Номер сессии просрочен (действует 24 часа). Начните с initialize снова.
  • Результат с `isError: true`. Агент отправил имя без зоны, IP-адрес вместо домена или слишком длинную строку. Текст ошибки можно показать человеку.
  • `state: "unknown"` и `retry: true`. Источники не подтвердили состояние или исчерпан лимит. Спросите через несколько минут.
  • Клиент просит ключ. Выберите «без аутентификации»: ключ API здесь не нужен.
  • Чтобы работать с вашими доменами (список, DNS, сертификаты), используйте API по ключу.

Эта страница в Markdown