Самое сложное в агентной коммерции — то, что большинство продуктов никогда не создавались для агентов. Сценарии с сохранённой картой предполагают, что человек вглядывается в экран оплаты. Приложения для eSIM предполагают, что телефон с готовой камерой отсканирует QR-код. Stripe предполагает наличие страницы оформления заказа, привязанной к session-cookie, которую MCP-сервер предоставить не может.
Roamzy был перестроен начиная с API-слоя, чтобы убрать эти предположения. Результат — пятиминутная установка, которая позволяет Claude Desktop запрашивать каталог, оценивать стоимость и (с вашего явного согласия) покупать глобальную eSIM за USDT, а также явная модель безопасности, ограничивающая радиус поражения при утечке токена.
Что вы получите в итоге
После этого туториала:
- Claude Desktop с восемью зарегистрированными инструментами Roamzy (каталог, информация о стране, оценка стоимости, статус, плюс авторизованные инструменты чтения для ваших собственных eSIM и заказов)
- API-токен в конфиге Claude, который позволяет агенту действовать от вашего имени, по умолчанию ограниченный режимом «только чтение»
- Возможность включить покупки, переключив одну переменную окружения, когда вы будете готовы
Всего времени: около 60 секунд на установку и 4 минуты на то, чтобы попросить Claude сделать что-нибудь интересное.
Шаг 1: Создайте API-токен в личном кабинете Roamzy
Войдите на roamzy.io/dashboard через Google или Telegram. Откройте Settings → API & Agents. Нажмите Create new token.
Открытый текст токена показывается ровно один раз — немедленно скопируйте его в менеджер паролей. После закрытия этого экрана сервер не хранит открытый текст: он держит SHA-256-хеш для проверки и 12-символьную подсказку-префикс (rk_live_abc1…) для отображения.
Для первой установки оставьте флажок Allow purchases снятым. Токены «только для чтения» не могут тратить USDT — они лишь запрашивают каталоги и проверяют статус. Это правильное значение по умолчанию. Вы всегда сможете позже создать второй токен с включённым правом на покупки.
Шаг 2: Найдите файл конфигурации Claude Desktop
На macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
На Windows: %APPDATA%\Claude\claude_desktop_config.json
Если файла ещё нет, создайте его. Это обычный JSON.
Шаг 3: Добавьте MCP-сервер Roamzy
{
"mcpServers": {
"roamzy": {
"command": "npx",
"args": ["-y", "https://roamzy.io/mcp/roamzy-mcp-latest.tgz"],
"env": {
"ROAMZY_API_TOKEN": "rk_live_xxx",
"ROAMZY_ENABLE_PURCHASE": "false"
}
}
}
}
Замените rk_live_xxx на ваш настоящий токен. Команда npx скачает архив напрямую с нашего домена — учётные данные GitHub или NPM не нужны.
Если у вас уже настроены другие MCP-серверы, добавьте ключ roamzy в существующий объект mcpServers, а не заменяйте весь файл.
Шаг 4: Перезапустите Claude Desktop
Полностью закройте Claude Desktop (Cmd-Q на Mac, а не просто закрытие окна) и откройте заново. При запуске Claude один раз считывает файл конфигурации и поднимает каждый MCP-сервер как подпроцесс.
В меню инструментов (маленькая иконка в правом нижнем углу области ввода) должны появиться инструменты Roamzy. Если они не появятся в течение десяти секунд, проверьте лог Claude Desktop на наличие ошибок — обычно это опечатка в JSON-конфиге или неверный токен.
Шаг 5: Спросите у Claude что-нибудь интересное
Попробуйте такой запрос:
На следующей неделе я лечу в Токио на 10 дней. Во сколько мне обойдётся eSIM через Roamzy, если я рассчитываю израсходовать всего около 2 ГБ?
Что Claude делает за кулисами:
- Вызывает
roamzy_country_detail(country_slug="esim-japan"), чтобы подтвердить, что Япония поддерживается, и узнать текущий тариф за МБ. - Вызывает
roamzy_estimate(country_slug="esim-japan", mb_estimated=2048), чтобы спрогнозировать стоимость в USDT. - Возвращает краткий ответ с прогнозируемой стоимостью и минимальным пополнением.
Для 2 ГБ в Японии по нашему текущему тарифу $0.0033/МБ прогнозируемая стоимость составит около $9 USDT. Минимальное пополнение в Roamzy — $20, поэтому Claude посоветует пополнить баланс минимум на $20 для запаса.
Включение покупок (когда будете готовы)
Чтобы Claude мог действительно купить eSIM, а не просто оценить её стоимость, должны выполняться два условия:
- У токена должно быть включено право на покупки. Отредактируйте токен в личном кабинете либо отзовите его и создайте новый с установленным флажком Allow purchases.
- В конфигурации MCP-сервера должно быть
ROAMZY_ENABLE_PURCHASE: "true". Это отдельный флаг, не зависящий от прав токена: даже с токеном, разрешающим покупки, MCP-сервер не предоставит инструменты покупки, пока не задана эта переменная окружения. Глубокая защита от опечаток в конфиге.
Когда оба условия выполнены, перезапустите Claude Desktop и попробуйте:
Купи мне eSIM Roamzy для поездки в Токио с пополнением на $20.
Claude вызовет roamzy_create_order, который списывает средства из дневного бюджета токена (по умолчанию $50). API возвращает ссылку на оплату в USDT — Claude передаёт её вам, вы платите из своего кошелька, вебхук подтверждает оплату, после чего Claude может получить URL QR-изображения и показать его в чате. Сканируете камерой телефона — и eSIM устанавливается.
Модель безопасности в одном абзаце
От вышедшего из-под контроля агента вас защищают пять уровней. Дневные и месячные лимиты трат на каждый токен (по умолчанию $50/день, $500/месяц, настраиваемые до $1000/$10000). 7-дневный «период остывания» с лимитом $50 суммарных трат на каждый новый токен, который нельзя повысить. Подтверждение крупных транзакций: всё, что превышает $200 USDT, блокируется на уровне API и требует подтверждения в личном кабинете. Право на покупки включается отдельно для каждого токена. И есть три независимых «рубильника»: отзыв отдельного токена, блокировка агентов для конкретного пользователя и глобальная остановка агентов, статус которой виден по адресу /api/v1/status.
Подробности смотрите в /llms-full.txt — это развёрнутые рекомендации, которые мы публикуем специально для AI-агентов и движков.
А что насчёт других AI-клиентов?
Cursor, Continue, Cline, Windsurf и любой другой MCP-совместимый клиент используют тот же блок конфигурации — просто поместите его в соответствующий файл настроек. Для клиентов без поддержки MCP (LangChain, function calling от OpenAI, n8n, собственные Python-скрипты) обращайтесь к REST API напрямую по адресу /api/v1/docs. Тот же токен, та же модель безопасности.
Вот и весь туториал. Если что-то не получается, бот поддержки Roamzy в Telegram доступен по адресу @roamzy_support_bot.