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