# MCP с ключом — покупки ИИ-агентом

> Как подключить MCP-сервер ZRAZU с ключом API: агент регистрирует и продлевает домены, заказывает SSL с баланса и даёт человеку ссылку на доплату.

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

Этот MCP-сервер работает от имени вашей организации по [ключу API](https://zrazu.com/ru/docs/api-keys.md). Агент видит только те инструменты, на которые у ключа есть права, и платит только с баланса. Правила те же, что в [покупках через API](https://zrazu.com/ru/docs/api-orders.md): список IP, лимиты, дневной лимит ключа и журнал действий.

Открытый сервер паспорта домена без ключа описан в [MCP для ИИ-агентов](https://zrazu.com/ru/docs/api-mcp.md).

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

Адрес сервера: `https://api.zrazu.com/v1/mcp`. Ключ передаётся в заголовке `Authorization: Bearer`.

**Claude Code:**

```sh
claude mcp add --transport http zrazu-account https://api.zrazu.com/v1/mcp --header "Authorization: Bearer zr_live_..."
```

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

```json
{ "mcpServers": { "zrazu-account": { "type": "http", "url": "https://api.zrazu.com/v1/mcp", "headers": { "Authorization": "Bearer zr_live_..." } } } }
```

Ключ, который тратит деньги, работает только с адресов из своего списка. Поэтому подключайте сервер в агенте, который работает на вашем компьютере или сервере. Облачные ассистенты ходят с адресов своего провайдера, и такой ключ им откажет.

## Инструменты

| Инструмент | Что делает | Право |
|---|---|---|
| `whoami` | права ключа, его домены, адреса и срок | любое |
| `balance_get` | баланс организации | `billing.read` |
| `domains_list` | домены организации | `domain.read` |
| `owners_list` | кого можно записать владельцем нового домена | `domain.register` |
| `domain_register` | зарегистрировать домен | `domain.register` |
| `domain_renew` | продлить домен; `expires_at` из `domains_list` обязателен — второго продления не будет | `domain.renew` |
| `ssl_catalog` | сертификаты и цены | `ssl.read` |
| `ssl_order` | заказать сертификат | `ssl.order` |
| `order_get` | состояние заказа, с ожиданием `wait` до 60 с | любое из прав заказов |
| `order_payment_link` | новая ссылка на доплату | право покупок |
| `order_pay` | оплатить заказ с баланса | право покупок |

Ответ инструмента — тот же, что в API: код и тело. Ошибки имеют те же коды, см. [покупки через API](https://zrazu.com/ru/docs/api-orders.md).

## Как агент покупает

1. У каждой покупки есть `idempotency_key` — любая уникальная строка. Повторяя ту же покупку после обрыва, агент передаёт ту же строку, и второго списания не будет.
2. Если денег не хватает, в ответе есть `payment_url`. Это не ошибка: агент передаёт ссылку человеку, а потом ждёт через `order_get` с `wait`, пока заказ не станет `paid` и `fulfilled`.
3. Для регистрации агент берёт владельца из `owners_list`. Первый вызов возвращает `documents_required` с документами реестра и `documents_hash`. Агент показывает документы человеку. Если ваша организация разрешила агенту соглашаться без человека, повторный вызов с этим отпечатком — согласие самой организации, как галочка в кабинете.

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

- **Инструментов почти нет.** Агент видит только то, на что у ключа есть права. Посмотрите права через `whoami`.
- **`403 ip_not_allowed`.** Агент ходит не с адреса из списка ключа. Проверьте, где он работает.
- **`400` или `413`.** В запросе больше 10 сообщений JSON-RPC или тело больше 256 КБ. Отправляйте меньше.
- **`401`.** Ключ не передан, отозван или просрочен.
- **Ответ `403` без JSON-RPC.** Запрос пришёл со страницы в браузере. Ключ работает только из программ.