Dê ao seu agente de IA um eSIM global em cinco minutos

A maioria das demos de “a IA compra algo por ti” é fumo. O agente preenche um formulário, ou passa-te para uma página de checkout, ou assume silenciosamente que há um humano de prontidão para ler um código. A conectividade é uma das poucas categorias em que o ciclo inteiro de facto se fecha dentro do chat — e este é o tutorial que te leva lá.

No final vais ter um agente capaz de responder a “quanto me custariam dados no Japão?” e, quando lho pedires, gerar-te um eSIM real e entregar-te um código QR e um link de pagamento — sem nunca criares uma conta Roamzy. Seguem-se dois caminhos de configuração. Escolhe um; chegam ao mesmo sítio.

Trinta segundos de contexto antes de ligares seja o que for

Ajuda saber a que te estás a ligar, porque não tem o formato dos produtos de eSIM que talvez já tenhas 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 e nada para selecionar em tamanho ou duração.
• Por megabyte, sem expiração. Financias um saldo em stablecoins; os dados debitam-no à tarifa local por MB onde quer que o dispositivo esteja; o saldo não usado transita para sempre. O modelo é coberto em profundidade no pagamento por MB explicado.
• Anónimo por omissão. O agente não precisa de conta nem de token para começar. A primeira chamada autenticada gera automaticamente uma conta Roamzy anónima. A identidade é opcional, mais tarde.
• Doze ferramentas. As ferramentas de leitura (estado, catálogo, detalhe de país, estimativa de custo, os teus eSIMs e encomendas) estão abertas; a ferramenta de compra é a única que movimenta dinheiro, e está limitada pelos tetos de gasto que verás abaixo.

Se o que procuras é o argumento mais amplo de “porque é que a conectividade é a primeira coisa natural que um agente compra” e não a parte da ligação, começa por comércio agêntico e conectividade e volta aqui.

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

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

1. Abre as definições de conectores do teu cliente. No Claude.ai isso é Definições → Conectores → Adicionar conector personalizado.
2. Cola o URL do endpoint: https://roamzy.io/mcp
3. Guarda. As doze ferramentas Roamzy aparecem. Estás ligado.

Essa é a instalação inteira. Não há token para colar nem pacote para descarregar. O endpoint é anónimo por omissão por design — nunca devolve um 401, por isso um cliente liga-se sem uma dança de OAuth e age sobre uma conta anónima nova. (Existe uma camada de identidade OAuth para clientes que queiram início de sessão nomeado, mas não precisas dela para começar.) Salta para o resultado de cinco minutos abaixo.

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

Usa isto para clientes de desktop e de editor: Claude Desktop, Cursor, Continue, Cline, Windsurf, Zed, ou qualquer outro que corra um servidor MCP local via stdio.

Adiciona um bloco ao ficheiro de configuração MCP do teu cliente — no Claude Desktop em macOS isso é ~/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 por definir é o que põe o servidor em modo anónimo. Se já corres outros servidores MCP, junta a chave roamzy ao teu objeto mcpServers existente em vez de substituíres o ficheiro. Depois reinicia o cliente por completo (no Claude Desktop, sai com Cmd-Q, não feches apenas a janela). A primeira chamada autenticada de ferramenta gera a tua conta anónima.

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

• ROAMZY_API_TOKEN — define isto com um token do teu painel para agires como conta nomeada em vez de anónima.
• ROAMZY_ENABLE_PURCHASE — por omissão é false para um token nomeado (só de leitura até optares por ativar), mas está ativo automaticamente em modo anónimo. Com um token nomeado, a ferramenta de compra fica oculta até definires isto como true — defesa em profundidade contra um erro de configuração a gastar dinheiro.
• ROAMZY_API_BASE — substitui a base da API para backends de staging ou auto-hospedados.

O resultado de cinco minutos: pede-lhe para comprar

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

• Não um país. O eSIM funciona em todo o lado; não compras “um eSIM do Japão”.
• Não uma quantidade de dados. Não há pacote para dimensionar. Não estás a comprar gigabytes; estás a financiar um saldo.

O que o agente de facto precisa de ti é um valor de recarga (mínimo $20 USDT) e qual stablecoin e rede queres usar para pagar. Aqui está o fluxo de ponta a ponta:

Tu: Vou para a Tailândia na próxima semana — trata-me dos dados.

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

Tu: $20, USDC na Solana.

Agente: Feito. O teu número de eSIM é 2040XXXXXX. Paga aqui: [link de pagamento]. Guarda este link de recuperação para poderes alcançar este eSIM a partir de outro chat: [link de reivindicação]. Vou buscar o teu QR assim que o pagamento confirmar.

O que aconteceu nos bastidores, ferramenta a ferramenta:

1. roamzy_status — uma verificação rápida de disponibilidade e política (o serviço está ativo, as compras estão ativadas).
2. roamzy_estimate(country_slug, mb_estimated) — opcional, só se perguntaste “quanto custaria X”. Isto é um cálculo de referência, não um input de compra; não compromete nada.
3. roamzy_payment_options — vai buscar a lista em tempo real de stablecoins e redes, para que o agente te ofereça escolhas reais em vez de adivinhar. Este passo é obrigatório antes de uma compra: escolher uma rede por ti prenderia o checkout a uma chain que talvez não tenhas.
4. roamzy_create_order(amount_usdt, pay_currency, country_slug) — gera o eSIM e a fatura. country_slug aqui é apenas uma etiqueta de fatura (por omissão usa uma referência de tarifa baixa); não restringe onde o eSIM funciona. Devolve o teu número de telefone (MSISDN), um URL de pagamento e — em modo anónimo — um URL de reivindicação.
5. roamzy_order_status(order_id) — consultado em ciclo até o pagamento em USDT confirmar, tipicamente um a quinze minutos consoante a rede.
6. roamzy_get_esim(esim_id) — devolve as superfícies de ativação depois de pago: uma imagem QR para renderizar no chat, o payload QR em bruto, e um link de instalação com um toque para quando o agente e o telemóvel são o mesmo dispositivo.

As salvaguardas que recebes sem configurar nada

A autonomia só é razoável se for limitada, por isso os limites estão ativos por omissão. Cada token de agente — incluindo o anónimo criado para ti — carrega:

• Tetos de gasto. Uma sessão anónima é limitada a $30 por dia, $100 por mês, um teto de arrefecimento de $30 num token recém-criado, um único eSIM ativo, e qualquer transação acima de $50 devolvida para confirmação humana. Uma conta nomeada (reivindicada) recebe $50/dia, $500/mês, um arrefecimento de $50, uma porta de transação grande aos $200, e até cinco eSIMs.
• Um orçamento que o agente vê. Os limites restantes voltam a cada chamada, para que o agente raciocine sobre o que lhe resta em vez de descobrir um teto ao bater nele.
• Interruptores de emergência. Três independentes — revogar um único token, bloquear o acesso de agente de uma conta individual, ou pausar globalmente toda a compra de agentes — com o estado atual legível em roamzy_status.

Não ligas nada disto. É o padrão, e a justificação de design mais profunda está no guia do programador.

Subir de anónimo para uma conta nomeada

Um eSIM anónimo funciona plenamente — pode ser recarregado e usado indefinidamente. Quando quiseres ligá-lo a uma identidade real (para subir os tetos, geri-lo num browser, ou simplesmente não depender de um link guardado), reivindica-o. Abre o link de reivindicação, inicia sessão com o Google ou Telegram, e introduz o código de uso único; o eSIM e o seu saldo passam para a tua conta nomeada. É inteiramente opcional e acontece depois da compra, nunca antes dela. Pago em USDT ou USDC, o saldo não se importa com que conta o detém.

Quando algo não funciona

• Não aparece nenhuma ferramenta Roamzy. Quase sempre um erro de digitação no JSON da configuração ou um reinício incompleto. Valida o JSON, e no Claude Desktop sai 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 precisas tanto do escopo de compra no token como de ROAMZY_ENABLE_PURCHASE definido como true.
• O agente pergunta “que país?” Esse é o anti-padrão de antes — o eSIM é global. Um agente correto pede apenas um valor de recarga e um método de pagamento. Se o teu insiste num país, está a raciocinar a partir de um modelo de pacotes que não se aplica aqui.
• O pagamento parece preso. As confirmações de USDT e USDC demoram aproximadamente um a quinze minutos consoante a rede; o agente deve consultar roamzy_order_status em ciclo em vez de assumir falha.

Para onde ir a seguir

Tens agora um agente capaz de comprar conectividade. Para a arquitetura por trás do servidor MCP e as escolhas de design da API, lê o guia do programador. Para ver como isto 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 de agente está em agents.html, a API REST está documentada em /api/v1/docs, e orientação extensa escrita para motores está em /llms-full.txt. Se ficares preso, o bot de apoio é o @roamzy_support_bot.