Para dar a um agente de IA um eSIM global, aponte qualquer cliente compatível com MCP para o endpoint remoto da Roamzy — três passos, cerca de dois minutos, sem instalação e sem conta — ou adicione um bloco de configuração npm em clientes de desktop, em cerca de cinco. O agente passa a ter 12 ferramentas, um único eSIM que funciona em 193 países, e pode comprar com uma recarga em stablecoin a partir de $20 USDT.

A maioria das demos de “a IA compra algo para você” é fumaça. O agente preenche um formulário, ou manda você para uma página de checkout, ou supõe em silêncio que há um humano de plantão para ler um código. Conectividade é uma das poucas categorias em que o ciclo inteiro de fato se fecha dentro do chat — e este é o tutorial que leva você até lá.

No final, você vai ter um agente capaz de responder a “quanto me custariam dados no Japão?” e, quando você pedir, gerar um eSIM real e entregar um código QR e um link de pagamento — sem que você jamais crie uma conta Roamzy. A seguir vêm dois caminhos de configuração. Escolha um; os dois chegam ao mesmo lugar.

Trinta segundos de contexto antes de conectar qualquer coisa

Ajuda saber ao que você está se conectando, porque não tem o formato dos produtos de eSIM que você talvez já tenha usado:

  • Um produto, não um catálogo. Um único eSIM universal que funciona em todos os 193 países. Não há pacotes por país para escolher nem nada para selecionar em tamanho ou duração.
  • Por megabyte, sem validade. Você coloca saldo em stablecoins; os dados são debitados na tarifa local por MB onde quer que o aparelho esteja; o saldo não usado fica para sempre. O modelo é explicado em detalhe em pagamento por MB explicado.
  • Anônimo por padrão. O agente não precisa de conta nem de token para começar. A primeira chamada autenticada cria automaticamente uma conta Roamzy anônima. A identidade é opcional, para depois.
  • Doze ferramentas. As ferramentas de leitura (status, catálogo, detalhe do país, estimativa de custo, seus eSIMs e pedidos) são abertas; a ferramenta de compra é a única que movimenta dinheiro, e ela é limitada pelos tetos de gasto que você vai ver abaixo.

Se o que você procura é o argumento mais amplo de “por que a conectividade é a primeira coisa natural que um agente compra”, e não a parte da conexão, comece por comércio agêntico e conectividade e volte aqui.

Caminho A — Endpoint remoto, zero instalação (cerca de 2 minutos)

Este é o caminho mais rápido e não exige nada instalado. Funciona com o Claude.ai e com qualquer cliente que fale MCP remoto (Streamable HTTP).

  1. Abra as configurações de conectores do seu cliente. No Claude.ai, isso fica em Configurações → Conectores → Adicionar conector personalizado.
  2. Cole a URL do endpoint: https://roamzy.io/mcp
  3. Salve. As doze ferramentas da Roamzy aparecem. Você está conectado.

Essa é a instalação inteira. Não há token para colar nem pacote para baixar. O endpoint é anônimo por padrão, por design — ele nunca devolve um 401, então um cliente se conecta sem a dança do OAuth e age sobre uma conta anônima nova. (Existe uma camada de identidade OAuth para clientes que queiram login nomeado, mas você não precisa dela para começar.) Pule para o resultado de cinco minutos abaixo.

Caminho B — Instalação local via npm (cerca de 5 minutos)

Use este caminho para clientes de desktop e de editor: Claude Desktop, Cursor, Continue, Cline, Windsurf, Zed ou qualquer outro que rode um servidor MCP local via stdio.

Adicione um bloco ao arquivo de configuração MCP do seu cliente — no Claude Desktop no macOS, é ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "roamzy": {
      "command": "npx",
      "args": ["-y", "@roamzy/mcp-server"]
    }
  }
}

Não é preciso bloco de ambiente — deixar ROAMZY_API_TOKEN sem valor é o que coloca o servidor em modo anônimo. Se você já roda outros servidores MCP, acrescente a chave roamzy ao seu objeto mcpServers existente em vez de substituir o arquivo. Depois reinicie o cliente por completo (no Claude Desktop, saia com Cmd-Q, não feche só a janela). A primeira chamada autenticada de ferramenta cria a sua conta anônima.

Há três variáveis de ambiente opcionais, nenhuma necessária para o fluxo anônimo:

  • ROAMZY_API_TOKEN — preencha com um token do seu painel para agir como conta nomeada em vez de anônima.
  • ROAMZY_ENABLE_PURCHASE — o padrão é false para um token nomeado (só leitura até você ativar), mas fica ativo automaticamente no modo anônimo. Com um token nomeado, a ferramenta de compra fica oculta até você definir isto como true — defesa em profundidade contra um erro de configuração que gaste dinheiro.
  • ROAMZY_API_BASE — substitui a base da API para backends de staging ou auto-hospedados.

O resultado de cinco minutos: peça para ele comprar

Antes da conversa de exemplo, um modelo mental que costuma confundir as pessoas. Como a Roamzy é um único eSIM global cobrado por megabyte, há duas coisas que você não deve dizer ao agente, e um agente bem-comportado não vai pedir:

  • Não um país. O eSIM funciona em qualquer lugar; você não compra “um eSIM do Japão”.
  • Não uma quantidade de dados. Não há pacote para dimensionar. Você não está comprando gigabytes; está colocando saldo.

O que o agente de fato precisa de você é um valor de recarga (mínimo $20 USDT) e qual stablecoin e rede você quer usar para pagar. Este é o fluxo de ponta a ponta:

Você: Vou para a Tailândia na semana que vem — resolve os dados para mim.

Agente: A Roamzy é um eSIM universal que funciona em 193 países, cobrado por MB na tarifa local — sem pacotes, sem validade. Quanto você quer recarregar? O mínimo é $20 USDT. E com qual stablecoin e rede você quer pagar — por exemplo, USDT na TRON, BSC ou TON, ou USDC na Solana?

Você: $20, USDC na Solana.

Agente: Pronto. O número do seu eSIM é 2040XXXXXX. Pague aqui: [link de pagamento]. Guarde este link de recuperação para acessar este eSIM a partir de outro chat: [link de reivindicação]. Vou buscar o seu QR assim que o pagamento confirmar.

O que aconteceu nos bastidores, ferramenta por ferramenta:

  1. roamzy_status — uma verificação rápida de disponibilidade e de política (o serviço está no ar, as compras estão ativadas).
  2. roamzy_estimate(country_slug, mb_estimated) — opcional, só se você perguntou “quanto custaria X”. É um cálculo de referência, não um dado de compra; não compromete nada.
  3. roamzy_payment_options — busca a lista em tempo real de stablecoins e redes, para que o agente ofereça escolhas reais em vez de chutar. Este passo é obrigatório antes de uma compra: escolher uma rede por você prenderia o checkout a uma chain que você talvez não tenha.
  4. roamzy_create_order(amount_usdt, pay_currency, country_slug) — gera o eSIM e a fatura. Aqui, country_slug é só uma etiqueta da fatura (por padrão usa uma referência de tarifa baixa); não restringe onde o eSIM funciona. Devolve o seu número de telefone (MSISDN), uma URL de pagamento e — no modo anônimo — uma URL de reivindicação.
  5. roamzy_order_status(order_id) — consultado em ciclo até o pagamento em USDT confirmar, tipicamente de um a quinze minutos, dependendo da rede.
  6. roamzy_get_esim(esim_id) — devolve as formas de ativação depois do pagamento: uma imagem QR para renderizar no chat, o payload QR bruto e um link de instalação com um toque para quando o agente e o celular são o mesmo aparelho.

As salvaguardas que você recebe sem configurar nada

A autonomia só é razoável se for limitada, por isso os limites vêm ativados por padrão. Cada token de agente — incluindo o anônimo criado para você — carrega:

  • Tetos de gasto. Uma sessão anônima é limitada a $40 por dia, $100 por mês, um teto de resfriamento de $40 num token recém-criado, um único eSIM ativo, e qualquer transação acima de $50 volta para confirmação humana. Uma conta nomeada (reivindicada) recebe $50/dia, $500/mês, um resfriamento de $50, uma trava de transação grande em $200 e até cinco eSIMs.
  • Um orçamento que o agente enxerga. Os limites restantes voltam em cada chamada, para que o agente raciocine sobre o que ainda tem em vez de descobrir um teto ao bater nele.
  • Botões de emergência. Três independentes — revogar um único token, bloquear o acesso de agentes de uma conta específica ou pausar globalmente todas as compras de agentes —, com o estado atual legível em roamzy_status.

Você não liga nada disso. É o padrão, e a justificativa de design mais profunda está no guia do desenvolvedor.

De anônimo para uma conta nomeada

Um eSIM anônimo funciona plenamente — pode ser recarregado e usado indefinidamente. Quando você quiser vinculá-lo a uma identidade real (para subir os tetos, gerenciá-lo num navegador ou simplesmente não depender de um link guardado), reivindique-o. Abra o link de reivindicação, entre com o Google ou o Telegram e digite o código de uso único; o eSIM e o saldo dele passam para a sua conta nomeada. É totalmente opcional e acontece depois da compra, nunca antes. Pago em USDT ou USDC, o saldo não se importa com qual conta o detém.

Quando algo não funciona

  • Nenhuma ferramenta da Roamzy aparece. Quase sempre é um erro de digitação no JSON da configuração ou um reinício incompleto. Valide o JSON e, no Claude Desktop, saia por completo com Cmd-Q em vez de fechar a janela.
  • O agente consegue ler, mas não comprar. O modo anônimo expõe a ferramenta de compra automaticamente. Com um token nomeado, você precisa tanto do escopo de compra no token quanto de ROAMZY_ENABLE_PURCHASE definido como true.
  • O agente pergunta “qual país?” Esse é o antipadrão de antes — o eSIM é global. Um agente correto pede só um valor de recarga e um método de pagamento. Se o seu insiste num país, ele está raciocinando a partir de um modelo de pacotes que não se aplica aqui.
  • O pagamento parece travado. As confirmações de USDT e USDC levam aproximadamente de um a quinze minutos, dependendo da rede; o agente deve consultar roamzy_order_status em ciclo em vez de supor falha.

Para onde ir depois

Agora você tem um agente capaz de comprar conectividade. Para a arquitetura por trás do servidor MCP e as escolhas de design da API, leia o guia do desenvolvedor. Para ver como isso se compara com o marketplace de consumo já estabelecido, a comparação Roamzy vs Airalo é franca sobre onde cada um ganha. A visão geral de uma página de toda a superfície para agentes está em agents.html, a API REST está documentada em /api/v1/docs, e orientações extensas escritas para mecanismos de busca estão em /llms-full.txt. Se travar em algo, o bot de suporte é o @roamzy_support_bot.