Guía

Conecta un asistente de IA al servidor MCP de Atli eSIM

Conecta ChatGPT, Claude, Gemini o tu agente de IA al servidor MCP de Atli para buscar planes de eSIM, procesar compras y dar instrucciones de instalación.

Un chat de IA en el que Atli ofrece planes para Japón y un enlace de pago seguro, junto a la mascota azul con alas de Atli saliendo de un móvil

Atli ofrece un servidor MCP público que permite a los asistentes de IA vender eSIM de viaje. Con esta integración, los asistentes pueden buscar planes, comprobar la compatibilidad del dispositivo, procesar pedidos y dar instrucciones para instalar la eSIM.

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA interactuar con herramientas y servicios externos. El servidor MCP de Atli da acceso a su catálogo de eSIM en vivo, de modo que la información de los planes y los precios llegan directamente de Atli y no del conocimiento previo del asistente de IA.

Tu código de socio forma parte de la dirección del servidor MCP. Los clientes nuevos que compran como invitados a través de un asistente conectado a esa dirección se atribuyen a tu cuenta de socio. Esto se aplica tanto a los asistentes de IA que desarrolles como a los asistentes de terceros compatibles que se configuren con tu dirección MCP.

Tu dirección MCP

Inicia sesión en partners.heyatli.com y abre Servidor MCP. La dirección que aparece ahí lleva tu código de socio y tiene un botón para copiarla.

El recuadro Tu dirección de la página Servidor MCP de partners.heyatli.com, con la dirección del servidor, un botón para copiarla y un botón Añadir código de referido

Para formar la dirección tú mismo, añade tu código de socio después de /r/:

https://mcp.heyatli.com/r/YOUR_CODE

Los clientes invitados nuevos que compran a través de tu dirección MCP se atribuyen a tu código de socio. Si tu código incluye un descuento, se aplica a su primer pedido.

La dirección estándar https://mcp.heyatli.com también admite compras, pero no atribuye la venta a ningún socio. Usa siempre tu dirección de referido completa para que se te atribuyan las ventas elegibles.

Conectar ChatGPT, Claude y Gemini

Los menús de configuración pueden cambiar cuando las plataformas de IA actualizan su interfaz. Los nombres de los menús son los de la interfaz en inglés de cada app, como en las imágenes. Si las instrucciones no coinciden con lo que ves, consulta la documentación de la plataforma sobre servidores MCP o conectores personalizados.

ChatGPT. Abre Plugins en la barra lateral, elige Add y luego Add custom MCP server. Ponle el nombre Atli eSIM, deja seleccionado Server URL, pega la dirección y pon Authentication en No authentication. Marca I understand and want to continue y elige Create as a plugin; después instala el plugin y pruébalo en un chat nuevo. OpenAI da soporte completo a los servidores MCP personalizados en Business, Enterprise y Edu, donde los administradores del espacio de trabajo deciden quién puede añadirlos. En Pro solo permite acciones de lectura y consulta, así que cuenta con que la búsqueda de planes funcione ahí y la compra no. Si la opción no aparece en el menú, tu plan o tu espacio de trabajo no la ofrece.

Añadir Atli eSIM a ChatGPT: Plugins en la barra lateral, Add y luego Add custom MCP server. El formulario lleva el nombre Atli eSIM, la dirección https://mcp.heyatli.com/r/YOUR_CODE y No authentication. La casilla del aviso de riesgo está marcada antes de Create as a plugin

Claude. Abre Customize y luego Connectors. Elige + Add y después Add custom connector. Ponle el nombre Atli eSIM, pega la dirección y elige Continue. Vuelve a elegir Continue para pasar los ajustes de autenticación que detecta Claude. En Authentication, elige Sign in when needed, deja el cliente OAuth recomendado por Claude y elige Add. Claude solo pide al usuario que inicie sesión en Atli cuando una operación requiere acceso a la cuenta. En los planes Team y Enterprise, un propietario añade el conector en Organization settings y después los miembros eligen Connect. En el plan Free, Claude permite un solo conector personalizado.

Añadir Atli eSIM a Claude: Connectors, + Add y Add custom connector, luego el nombre Atli eSIM y la dirección, y después Sign in when needed con el cliente OAuth recomendado por Claude y Add

Gemini. En gemini.google.com, abre Settings y luego Connected Apps. Si no está ahí, búscalo en Personal Intelligence. En Custom apps, elige Add a custom app, pega la dirección, elige Next y sigue los pasos. Gemini no pide un nombre, y el servidor de Atli se presenta como Atli eSIM. Gemini tiene requisitos de uso adicionales. Las apps personalizadas necesitan una cuenta personal de Google y History activado. Solo funcionan en inglés, y hay que tener 18 años o más y estar en Estados Unidos. Una vez configurada desde la web, la app personalizada también está disponible en la app móvil de Gemini.

Añadir Atli eSIM a Gemini: Settings, Connected Apps, Add a custom app dentro de Custom apps, luego la dirección https://mcp.heyatli.com/r/YOUR_CODE y Next

Muse. Pídeselo a Muse con estas palabras: «Añade el MCP de Atli eSIM desde esta dirección: https://mcp.heyatli.com/r/YOUR_CODE». Confirma si Muse te lo pide.

Añadir Atli eSIM a Muse: un chat nuevo con el mensaje que pide añadir el MCP de Atli eSIM desde esta dirección, seguido de la dirección de socio, y después una confirmación si Muse la pide

Claude Code. Un solo comando añade el servidor:

Bash
claude mcp add --transport http atli-esim https://mcp.heyatli.com/r/YOUR_CODE

Cursor, VS Code y otras apps. Añade un servidor MCP remoto, ponle el nombre Atli eSIM si la app lo pide, pega la dirección y deja vacío el inicio de sesión. Funciona cualquier app compatible con servidores MCP remotos por Streamable HTTP.

Después haz la pregunta que haría un viajero: «planes de eSIM para 10 días en Japón, en euros».

Qué puede hacer el asistente

La referencia MCP ofrece en directo la lista de herramientas disponibles y sus parámetros de entrada.

  • Buscar un plan. search_plans busca por destino, duración, cantidad de datos y moneda. get_plan ofrece más detalles del plan y las redes compatibles. list_destinations muestra los destinos disponibles, y check_device_support comprueba si un móvil, una tableta o un reloj es compatible con eSIM.
  • Comprar. get_quote obtiene el precio final con los descuentos aplicables. start_purchase crea un pedido y genera un enlace de pago. get_order_status consulta el estado del pedido, y cancel_order y get_receipt se encargan de las cancelaciones y los recibos.
  • Después de comprar. get_install_instructions da dos enlaces para la persona que va a usar la eSIM. Uno la abre en la app de Atli, y el otro la instala desde un navegador y muestra los datos que quedan sin necesidad de una cuenta de Atli. También da un código QR, los enlaces de instalación para iPhone y Android y las instrucciones para instalarla a mano. list_my_esims obtiene las eSIM del cliente, y refresh_usage actualiza la información sobre el consumo de datos.
  • Otras funciones. El servidor también permite compartir eSIM, usar métodos de pago guardados, cupones y créditos Atli, consultar los artículos de ayuda y gestionar un Atli Group.

Cómo se paga en un chat

Los datos de la tarjeta de pago no se comparten con el asistente de IA ni con su proveedor. El cliente recibe un enlace a la página de pago segura de Atli, donde Stripe procesa el pago y muestra el total antes de la confirmación.

Los clientes con una tarjeta guardada también pueden pagar dentro del chat. El servidor de Atli indica al asistente que haga el cargo en esa tarjeta solo después de que el cliente haya revisado el precio y la tarjeta elegida y haya aprobado ambas cosas de forma explícita. Una petición general de comprar una eSIM no cuenta como esa aprobación. El servidor no garantiza por sí mismo que se cumpla este requisito.

Los clientes pueden comprar eSIM como invitados sin iniciar sesión. El asistente guarda una clave de invitado asociada a la conversación, lo que permite al cliente volver al mismo chat para ver las instrucciones de instalación o consultar los datos que le quedan. Los enlaces de instalación también funcionan fuera del chat. Abren la eSIM en la app de Atli o en heyatli.com, que muestra los datos que quedan sin necesidad de cuenta.

Los clientes que inician sesión en Atli pueden acceder a las eSIM de su cuenta desde cualquier conversación compatible. La autenticación se hace en heyatli.com, así que las contraseñas y los códigos de verificación no pasan por el chat.

Crear tu propio agente

Los agentes propios pueden conectarse al servidor MCP de Atli por Streamable HTTP. El siguiente ejemplo usa el SDK oficial de TypeScript:

JavaScript
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'my-travel-agent', version: '1.0.0' });
await client.connect(
  new StreamableHTTPClientTransport(new URL('https://mcp.heyatli.com/r/YOUR_CODE'))
);

const result = await client.callTool({
  name: 'search_plans',
  arguments: { destination: 'Japan', days: 10, currency: 'EUR' },
});
console.log(result.content[0].text);

La primera llamada a una herramienta de compra crea una cuenta de invitado y devuelve una guest_key. Guarda esta clave de forma segura en la sesión de conversación del usuario e inclúyela en las solicitudes posteriores.

La guest_key identifica la cuenta de invitado y da acceso a las eSIM asociadas a ella.

Para hacer pruebas, conéctate al servidor de Sandbox en https://staging.public.mcp.heyatli.com/r/YOUR_CODE. Sandbox admite pagos de prueba con la tarjeta de prueba de Stripe 4242 4242 4242 4242. Las eSIM de Sandbox vienen de un operador de prueba, así que no se pueden instalar en un móvil, y las ventas en Sandbox nunca generan comisión.

Cuando la referencia MCP se cambia a Sandbox, también ofrece un botón Probar con el que se puede ejecutar cada herramienta por separado.

Cómo se atribuyen las ventas por MCP

Los clientes invitados nuevos que compran a través de tu dirección MCP se atribuyen a tu código de socio.

Atli tiene que activar aparte la atribución de los clientes que inician sesión con una cuenta de Atli que ya tenían. Una vez que un cliente queda atribuido a tu cuenta de socio, sus compras futuras elegibles en todos los canales de Atli se suman a tus ganancias por referidos.

Para conocer los detalles de las comisiones y los pagos, consulta Cómo paga el programa de afiliados de Atli. La guía de la API de Atli trata las apps que necesitan una interfaz propia.

Preguntas frecuentes

¿El servidor MCP de Atli necesita una clave de API?
No. El servidor MCP es de acceso público. Los clientes pueden consultar planes sin cuenta, y las cuentas de invitado se crean automáticamente cuando hacen falta para una compra. Iniciar sesión en Atli es opcional.
¿El asistente puede gastar dinero sin preguntar?
Un enlace de pago solo se paga cuando el cliente completa el pago en la página de pago de Atli. Con una tarjeta guardada o la tarjeta de un Atli Group, Atli indica al asistente que pida al cliente su aprobación del precio y de la tarjeta o el grupo antes de hacer el cargo. El servidor no garantiza por sí mismo que se cumpla este requisito.
¿Qué asistentes de IA funcionan con él?
Cualquiera que admita servidores MCP remotos por Streamable HTTP. Entre ellos están los plugins de ChatGPT, los conectores personalizados de Claude, las apps personalizadas de Gemini, Muse, Claude Code, Cursor y VS Code.
¿Dónde encuentra la persona su eSIM después?
En los enlaces de instalación que da el asistente después del pago. Uno abre la eSIM en la app de Atli, y el otro la abre en heyatli.com, que la instala y muestra los datos que quedan sin necesidad de cuenta. Cualquiera que tenga esos enlaces puede instalar la eSIM, así que solo deben llegar a la persona que la va a usar. Los clientes invitados también pueden volver a la conversación original, y quienes compraron con la sesión iniciada pueden acceder a sus eSIM desde su cuenta de Atli en otras conversaciones compatibles.
¿Conectar el servidor cuesta algo?
No. Añadir Atli a un asistente es gratis, y la gente solo paga la eSIM que elige. El plan del propio asistente puede limitar qué conectores se pueden añadir.