API и MCP

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

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

Этот MCP-сервер работает от имени вашей организации по ключу API. Агент видит только те инструменты, на которые у ключа есть права, и платит только с баланса. Правила те же, что в покупках через API: список IP, лимиты, дневной лимит ключа и журнал действий.

Открытый сервер паспорта домена без ключа описан в MCP для ИИ-агентов.

Подключить

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

Claude Code:

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

Cursor, VS Code и другие клиенты с конфигурацией 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.

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

  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. Запрос пришёл со страницы в браузере. Ключ работает только из программ.

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