API и MCP
MCP для ИИ-агентов — паспорт домена
Как подключить MCP-сервер ZRAZU к Claude, ChatGPT или Cursor: адрес, инструмент паспорта домена, лимиты и то, чего агент не видит.
MCP — способ дать ИИ-ассистенту доступ к внешнему инструменту. Сервер ZRAZU открытый: ключ и регистрация не нужны. У него один инструмент — паспорт домена, и он только читает.
Что получает агент
Паспорт домена: кто регистратор, когда домен зарегистрирован и когда истекает, статусы реестра человеческим языком, когда имя может освободиться, серверы имён, состояние DNS, сертификата сайта и почты с готовыми исправлениями.
- Через MCP ничего нельзя изменить: ни домен, ни записи, ни счёт.
- Персональные данные владельца домена мы не отдаём никогда.
- Слова «свободно» через MCP нет. Доказать, что имя свободно, может только реестр, и только в момент покупки. Если источники не подтвердили, что домен занят, ответ — «не смогли проверить».
Подключить
Адрес сервера: https://api.zrazu.com/mcp. Аутентификация — «без аутентификации».
Claude, ChatGPT и другие клиенты с удалёнными MCP-серверами.
- Откройте настройки подключений (коннекторов) вашего клиента и добавьте собственный MCP-сервер.
- Укажите адрес
https://api.zrazu.com/mcp. - В поле аутентификации выберите «без аутентификации».
Claude Code:
claude mcp add --transport http zrazu https://api.zrazu.com/mcpCursor, 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 и тот же текст:
| Поле | Что это |
|---|---|
state | taken — домен занят; 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"}}}'Лимиты
| Что | Лимит |
|---|---|
| Паспорт через MCP | 30 в минуту и 300 в час на сессию |
| Все сессии с одного адреса | в 10 раз больше |
| Новые сессии с одного адреса | 600 в час |
Паспорт кэшируется до 6 часов (для домена в очереди на удаление — 15 минут). Когда именно смотрели, видно в checked_at.
Приватность
Каждый запрос записывается в журнал без вашего адреса и без имени домена: только инструмент, результат и время. Каждое проверенное имя на 90 дней попадает в стоп-лист: мы не берём его себе, в стоп-листе лежит отпечаток имени, а не само имя.
Если не получилось
- Ответ `404`. Номер сессии просрочен (действует 24 часа). Начните с
initializeснова. - Результат с `isError: true`. Агент отправил имя без зоны, IP-адрес вместо домена или слишком длинную строку. Текст ошибки можно показать человеку.
- `state: "unknown"` и `retry: true`. Источники не подтвердили состояние или исчерпан лимит. Спросите через несколько минут.
- Клиент просит ключ. Выберите «без аутентификации»: ключ API здесь не нужен.
- Чтобы работать с вашими доменами (список, DNS, сертификаты), используйте API по ключу.