Большинство демок «ИИ покупает за тебя» — это дым. Агент заполняет форму, или передаёт тебя на страницу оформления, или негласно полагает, что рядом стоит человек, готовый отсканировать код. Связь — одна из немногих категорий, где весь цикл реально замыкается прямо в чате, и это тот туториал, который тебя туда приведёт.
К концу у тебя будет агент, который сможет ответить «сколько мне будет стоить трафик в Японии?» и, когда попросишь, выпустить тебе настоящую eSIM и выдать QR-код и платёжную ссылку — без того, чтобы ты вообще создавал аккаунт Roamzy. Дальше два пути настройки. Выбери один; они приводят в одно и то же место.
Тридцать секунд контекста, прежде чем что-то подключать
Полезно понимать, к чему ты подключаешься, потому что это устроено не так, как eSIM-продукты, которыми ты, возможно, пользовался:
- Один продукт, а не каталог. Единая универсальная eSIM, которая работает во всех 193 странах. Нет страновых пакетов на выбор и нечего подбирать по объёму или сроку.
- За мегабайт, без срока. Ты пополняешь баланс в стейблкоинах; трафик списывает его по локальной ставке за МБ там, где находится устройство; неиспользованный баланс переносится навсегда. Модель подробно разобрана в статье про оплату по мегабайтам.
- Анонимно по умолчанию. Агенту не нужен аккаунт или токен, чтобы начать. Первый аутентифицированный вызов автоматически выпускает анонимный аккаунт Roamzy. Идентичность — опционально и позже.
- Двенадцать инструментов. Инструменты чтения (статус, каталог, детали по стране, оценка стоимости, твои eSIM и заказы) открыты; инструмент покупки — единственный, что двигает деньги, и он ограничен потолками трат, которые ты увидишь ниже.
Если тебе нужен более широкий аргумент «почему связь — естественная первая вещь, которую покупает агент», а не проводка, начни с статьи про агентную коммерцию и связь и вернись сюда.
Путь A — Удалённый эндпоинт, без установки (около 2 минут)
Это самый быстрый путь, и для него ничего не нужно ставить. Работает с Claude.ai и любым клиентом, который говорит на удалённом (Streamable HTTP) MCP.
- Открой настройки коннекторов своего клиента. В Claude.ai это Settings → Connectors → Add custom connector.
- Вставь URL эндпоинта:
https://roamzy.io/mcp - Сохрани. Появляются двенадцать инструментов Roamzy. Ты подключён.
Это вся установка. Нет токена, который надо вставлять, и пакета, который надо качать. Эндпоинт anonymous-first by design — он никогда не возвращает 401, так что клиент подключается без OAuth-танца и действует от лица свежего анонимного аккаунта. (Слой OAuth-идентичности существует для клиентов, которым нужен именной вход, но для старта он тебе не нужен.) Переходи сразу к пятиминутной развязке ниже.
Путь B — Локальная установка через npm (около 5 минут)
Используй его для десктопных и редакторных клиентов: Claude Desktop, Cursor, Continue, Cline, Windsurf, Zed или чего угодно ещё, что запускает локальный MCP-сервер поверх stdio.
Добавь один блок в файл MCP-конфига своего клиента — для Claude Desktop на macOS это ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"roamzy": {
"command": "npx",
"args": ["-y", "@roamzy/mcp-server"]
}
}
}
Блок окружения не нужен — то, что ROAMZY_API_TOKEN оставлен незаданным, и переводит сервер в анонимный режим. Если у тебя уже запущены другие MCP-серверы, влей ключ roamzy в свой существующий объект mcpServers, а не перезаписывай файл. Затем полностью перезапусти клиент (в Claude Desktop выйди через Cmd-Q, а не просто закрой окно). Первый аутентифицированный вызов инструмента выпускает твой анонимный аккаунт.
Есть три опциональные переменные окружения, ни одна не нужна для анонимного флоу:
ROAMZY_API_TOKEN— задай её токеном из своего дашборда, чтобы действовать как именной аккаунт, а не анонимный.ROAMZY_ENABLE_PURCHASE— по умолчаниюfalseдля именного токена (только чтение, пока ты не согласишься явно), но в анонимном режиме включена автоматически. С именным токеном инструмент покупки остаётся скрытым, пока ты не выставишь это вtrue— защита в глубину против опечатки в конфиге, тратящей деньги.ROAMZY_API_BASE— переопределить базу API для staging или self-hosted бэкендов.
Пятиминутная развязка: попроси его купить
Перед примером диалога — одна ментальная модель, на которой люди спотыкаются. Поскольку Roamzy — это единая глобальная eSIM с тарификацией за мегабайт, есть две вещи, которые ты не должен сообщать агенту, и хорошо ведущий себя агент не станет их у тебя спрашивать:
- Не страну. eSIM работает везде; ты не покупаешь «eSIM для Японии».
- Не объём данных. Нет пакета, размер которого надо задавать. Ты не покупаешь гигабайты; ты пополняешь баланс.
Что агенту действительно нужно от тебя — это сумма пополнения (минимум $20 USDT) и то, каким стейблкоином и в какой сети ты хочешь платить. Вот флоу от начала до конца:
Ты: На следующей неделе еду в Таиланд — настрой мне трафик.
Агент: Roamzy — это одна универсальная eSIM, работающая в 193 странах, с тарификацией за МБ по локальной ставке — без пакетов, без срока. На сколько хочешь пополнить? Минимум — $20 USDT. И каким стейблкоином и в какой сети хочешь платить — например, USDT на TRON, BSC или TON, либо USDC на Solana?
Ты: $20, USDC на Solana.
Агент: Готово. Номер твоей eSIM — 2040XXXXXX. Оплати здесь: [платёжная ссылка]. Сохрани эту ссылку восстановления, чтобы достучаться до этой eSIM из другого чата: [ссылка claim]. Подтянy QR, как только платёж подтвердится.
Что произошло под капотом, инструмент за инструментом:
roamzy_status— быстрая проверка живости и политик (поднят ли сервис, включены ли покупки).roamzy_estimate(country_slug, mb_estimated)— опционально, только если ты спросил «сколько будет стоить X». Это справочный расчёт, а не вход для покупки; он ничего не фиксирует.roamzy_payment_options— подтягивает живой список стейблкоинов и сетей, чтобы агент предлагал реальные варианты, а не угадывал. Этот шаг обязателен перед покупкой: выбрать сеть за тебя означало бы привязать оформление к цепочке, которой у тебя может не быть.roamzy_create_order(amount_usdt, pay_currency, country_slug)— выпускает eSIM и инвойс.country_slugздесь — лишь тег инвойса (по умолчанию страна-референс с низкой ставкой); он не ограничивает, где работает eSIM. Возвращает твой телефонный номер (MSISDN), платёжный URL и — в анонимном режиме — URL claim.roamzy_order_status(order_id)— опрашивается, пока платёж в USDT не подтвердится, обычно от одной до пятнадцати минут в зависимости от сети.roamzy_get_esim(esim_id)— после оплаты возвращает поверхности активации: QR-изображение для отрисовки в чате, сырой QR-payload и ссылку установки в одно касание для случая, когда агент и телефон — одно устройство.
Ограничители, которые ты получаешь без всякой настройки
Автономия разумна, только если она ограничена, поэтому ограничения включены по умолчанию. Каждый агентный токен — включая анонимный, созданный для тебя, — несёт:
- Потолки трат. Анонимная сессия держится в рамках $30 в день, $100 в месяц, потолка «остывания» $30 на совсем новом токене, одной активной eSIM, и любая транзакция свыше $50 отбивается обратно на подтверждение человеку. Именной (заклеймленный) аккаунт получает $50/день, $500/месяц, $50 «остывания», гейт крупных транзакций на $200 и до пяти eSIM.
- Бюджет, который агент видит. Остатки лимитов возвращаются на каждом вызове, так что агент рассуждает о том, что у него осталось, а не обнаруживает потолок, врезавшись в него.
- Аварийные выключатели. Три независимых — отозвать отдельный токен, заблокировать агентный доступ конкретного аккаунта или поставить на паузу все агентные покупки глобально — с текущим состоянием, читаемым через
roamzy_status.
Ничего из этого ты не включаешь. Это значения по умолчанию, а более глубокое обоснование дизайна — в гиде для разработчиков.
Апгрейд с анонимного до именного аккаунта
Анонимная eSIM работает полноценно — её можно пополнять и использовать бесконечно. Когда захочешь привязать её к реальной личности (чтобы поднять потолки, управлять ею в браузере или просто не зависеть от сохранённой ссылки), заклейми её. Открой ссылку claim, войди через Google или Telegram и введи одноразовый код; eSIM и её баланс переезжают на твой именной аккаунт. Это полностью опционально и происходит после покупки, никогда до неё. Оплаченный в USDT или USDC баланс не волнует, какой аккаунт его держит.
Когда что-то не работает
- Инструменты Roamzy не появляются. Почти всегда это опечатка в JSON конфига или неполный перезапуск. Проверь JSON, а в Claude Desktop выйди полностью через Cmd-Q, а не закрывая окно.
- Агент может читать, но не покупать. Анонимный режим выставляет инструмент покупки автоматически. С именным токеном тебе нужны и scope покупки на токене, и
ROAMZY_ENABLE_PURCHASE, выставленный вtrue. - Агент спрашивает «какая страна?» Это тот самый антипаттерн из начала — eSIM глобальна. Корректный агент спрашивает только сумму пополнения и способ оплаты. Если твой настаивает на стране, он рассуждает из пакетной модели, которая здесь не применима.
- Платёж как будто завис. Подтверждения USDT и USDC занимают примерно от одной до пятнадцати минут в зависимости от сети; агент должен опрашивать
roamzy_order_status, а не предполагать провал.
Куда двигаться дальше
Теперь у тебя есть агент, который может покупать связь. За архитектурой MCP-сервера и решениями по дизайну API — в гиде для разработчиков. За тем, как это смотрится против действующего потребительского маркетплейса, — в сравнении Roamzy и Airalo, оно откровенно о том, где кто выигрывает. Одностраничный обзор всей агентной поверхности живёт на agents.html, REST API задокументирован на /api/v1/docs, а развёрнутые рекомендации, написанные для движков, — на /llms-full.txt. Если застрял, бот поддержки — @roamzy_support_bot.