Lo más difícil del comercio con agentes es que la mayoría de los productos nunca se diseñaron para agentes. Los flujos de tarjeta guardada dan por hecho que hay una persona entornando los ojos frente a una pantalla de facturación. Las apps de eSIM dan por hecho que hay un teléfono con la cámara lista para escanear un código QR. Stripe da por hecho que hay una página de pago vinculada a una cookie de sesión, algo que un servidor MCP no puede proporcionar.
Roamzy se reconstruyó desde la capa de la API hacia abajo para eliminar esas suposiciones. El resultado es una instalación de cinco minutos que permite a Claude Desktop consultar, estimar y (con tu consentimiento explícito) comprar una eSIM global en USDT, además de un modelo de seguridad explícito que acota el alcance del daño si se filtra un token.
Con qué vas a terminar
Tras este tutorial:
- Claude Desktop con ocho herramientas de Roamzy registradas (catálogo, detalle de país, estimación, estado, además de herramientas de lectura autenticadas para tus propias eSIM y pedidos)
- Un token de API en tu configuración de Claude que permite al agente actuar en tu nombre, limitado de forma predeterminada a solo lectura
- La posibilidad de habilitar compras cambiando una sola variable de entorno cuando estés listo
Tiempo total: unos 60 segundos de instalación y 4 minutos pidiéndole a Claude que haga cosas interesantes.
Paso 1: Crea un token de API en el panel de Roamzy
Inicia sesión en roamzy.io/dashboard con Google o Telegram. Abre Ajustes → API y agentes. Haz clic en Crear nuevo token.
El texto plano del token aparece una sola vez y nunca más: cópialo de inmediato en un gestor de contraseñas. El servidor nunca almacena el texto plano después de que se cierre esta pantalla; conserva un hash SHA-256 para la verificación y una pista de prefijo de 12 caracteres (rk_live_abc1…) para mostrarla.
Deja la casilla Permitir compras sin marcar en tu primera instalación. Los tokens de solo lectura no pueden gastar USDT: solo pueden consultar catálogos y comprobar el estado. Este es el valor predeterminado correcto. Siempre puedes crear más tarde un segundo token con el alcance de compras habilitado.
Paso 2: Encuentra el archivo de configuración de Claude Desktop
En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%\Claude\claude_desktop_config.json
Si el archivo aún no existe, créalo. Es JSON plano.
Paso 3: Añade el servidor MCP de 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"
}
}
}
}
Sustituye rk_live_xxx por tu token real. El comando npx descargará el tarball directamente desde nuestro dominio: no hacen falta credenciales de GitHub ni de NPM.
Si ya tienes otros servidores MCP configurados, fusiona la clave roamzy dentro de tu objeto mcpServers existente en lugar de reemplazar todo el archivo.
Paso 4: Reinicia Claude Desktop
Cierra Claude Desktop por completo (Cmd-Q en Mac, no basta con cerrar la ventana) y vuelve a abrirlo. Al iniciarse, Claude lee el archivo de configuración una vez y arranca cada servidor MCP como un subproceso.
Deberías ver las herramientas de Roamzy en el menú de herramientas (el iconito en la esquina inferior derecha del área de entrada). Si no aparecen en diez segundos, revisa el registro de Claude Desktop en busca de errores: normalmente es una errata en la configuración JSON o un token equivocado.
Paso 5: Pídele a Claude algo interesante
Prueba este prompt:
La semana que viene viajo a Tokio para un viaje de 10 días. ¿Cuánto me costará una eSIM con Roamzy si espero usar unos 2 GB en total?
Lo que Claude hace entre bastidores:
- Llama a
roamzy_country_detail(country_slug="esim-japan")para confirmar que Japón tiene cobertura y obtener la tarifa por MB actual. - Llama a
roamzy_estimate(country_slug="esim-japan", mb_estimated=2048)para proyectar el coste en USDT. - Devuelve una respuesta concisa con el coste proyectado y la recarga mínima.
Para 2 GB en Japón a nuestra tarifa actual de $0.0033/MB, el coste proyectado ronda los $9 USDT. La recarga mínima en Roamzy es de $20, así que Claude te dirá que recargues al menos $20 para ir sobre seguro.
Habilitar las compras (cuando estés listo)
Para que Claude pueda comprar de verdad una eSIM en lugar de solo estimarla, tienen que cumplirse dos cosas:
- El token debe tener habilitado el alcance de compras. Edita el token en el panel, o revócalo y crea uno nuevo con la casilla Permitir compras.
- La configuración del servidor MCP debe tener
ROAMZY_ENABLE_PURCHASE: "true". Este es un indicador independiente del alcance del token: incluso con un token habilitado para compras, el servidor MCP no expondrá las herramientas de compra a menos que esta variable de entorno esté configurada. Defensa en profundidad frente a erratas de configuración.
Una vez que ambas condiciones se cumplan, reinicia Claude Desktop y prueba:
Cómprame una eSIM de Roamzy para el viaje a Tokio con una recarga de $20.
Claude llamará a roamzy_create_order, que gasta del presupuesto diario del token (predeterminado $50). La API devuelve una URL de pago en USDT; Claude te la comparte, tú pagas desde tu monedero, el webhook lo confirma y entonces Claude puede obtener la URL de la imagen QR para mostrarla en el chat. Escanéala con la cámara de tu teléfono y la eSIM se instala.
El modelo de seguridad en un párrafo
Cinco capas te protegen de un agente descontrolado. Límites de gasto diarios y mensuales por token (predeterminados $50/día, $500/mes, configurables hasta $1000/$10000). Un periodo de enfriamiento de 7 días con $50 de gasto total en cada token nuevo, no ampliable. Confirmación de transacciones grandes: cualquier importe superior a $200 USDT se bloquea a nivel de API y exige que lo confirmes en el panel. El alcance de compras es opcional por token. Y hay tres interruptores de apagado independientes: revocación por token, bloqueo de agentes por usuario y pausa global de agentes, con el estado visible en /api/v1/status.
Para más detalle, consulta /llms-full.txt, la guía extensa que publicamos específicamente para agentes y motores de IA.
¿Y otros clientes de IA?
Cursor, Continue, Cline, Windsurf y cualquier otro cliente compatible con MCP usan el mismo bloque de configuración: simplemente colócalo en su respectivo archivo de configuración. Para clientes que no son MCP (LangChain, function calling de OpenAI, n8n, scripts de Python personalizados), llama directamente a la API REST en /api/v1/docs. El mismo token, el mismo modelo de seguridad.
Ese es todo el tutorial. Si te atascas, el bot de soporte de Roamzy en Telegram está en @roamzy_support_bot.