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

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

URL: https://zrazu.com/ru/docs/api-mcp/

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

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

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

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

## Подключить

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

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

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

**Claude Code:**

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

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

```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 часа.

```sh
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 по ключу](https://zrazu.com/ru/docs/api-overview.md).