Guide

Connectez un assistant IA au serveur MCP eSIM d'Atli

Connectez ChatGPT, Claude, Gemini ou votre agent IA au serveur MCP d'Atli pour chercher des forfaits eSIM, gérer les achats et guider l'installation.

Une conversation avec une IA dans laquelle Atli propose des forfaits pour le Japon et un lien de paiement sécurisé, à côté de la mascotte bleue ailée d'Atli qui sort d'un téléphone

Atli met à disposition un serveur MCP public qui permet aux assistants IA de vendre des eSIM de voyage. Grâce à cette intégration, les assistants peuvent rechercher des forfaits, vérifier la compatibilité des appareils, traiter les commandes et fournir les instructions d’installation de l’eSIM.

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA d’interagir avec des outils et des services externes. Le serveur MCP d’Atli donne accès au catalogue d’eSIM en temps réel. Les informations sur les forfaits et les prix proviennent ainsi directement d’Atli et non des connaissances préalables de l’assistant IA.

Votre code partenaire est intégré à l’URL du serveur MCP. Les nouveaux clients qui achètent en tant qu’invités via un assistant connecté à cette URL sont rattachés à votre compte partenaire. Cela vaut aussi bien pour les assistants IA que vous développez que pour les assistants tiers compatibles configurés avec votre adresse MCP.

Votre adresse MCP

Connectez-vous sur partners.heyatli.com et ouvrez Serveur MCP. L’adresse affichée contient votre code partenaire et dispose d’un bouton de copie.

Le bloc Votre adresse de la page Serveur MCP de partners.heyatli.com, avec l'adresse du serveur, un bouton de copie et un bouton Ajouter un code de parrainage

Pour composer l’URL vous-même, ajoutez votre code partenaire après /r/ :

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

Les nouveaux clients invités qui achètent via votre URL MCP sont rattachés à votre code partenaire. Si votre code comporte une réduction, elle s’applique à leur première commande.

L’URL standard https://mcp.heyatli.com permet aussi d’acheter, mais elle ne rattache aucune vente à un partenaire. Utilisez toujours votre URL de parrainage complète pour que les ventes éligibles soient suivies.

Connecter ChatGPT, Claude et Gemini

Les menus de configuration peuvent changer lorsque les plateformes d’IA mettent à jour leur interface. Les noms de menus sont ceux de l’interface anglaise des applications, que montrent aussi les captures d’écran. Si les instructions ne correspondent pas à ce que vous voyez, consultez la documentation de la plateforme sur les serveurs MCP personnalisés ou les connecteurs.

ChatGPT. Ouvrez Plugins dans la barre latérale, choisissez Add puis Add custom MCP server. Nommez-le Atli eSIM, laissez Server URL sélectionné, collez l’adresse et réglez Authentication sur No authentication. Cochez I understand and want to continue et choisissez Create as a plugin, puis installez le plugin et essayez-le dans une nouvelle conversation. OpenAI prend entièrement en charge les serveurs MCP personnalisés sur les abonnements Business, Enterprise et Edu, où les administrateurs de l’espace de travail décident qui peut en ajouter. Sur Pro, il n’autorise que les actions de lecture et de récupération : attendez-vous donc à pouvoir y consulter les forfaits, mais pas à acheter. Si l’option n’apparaît pas dans le menu, votre abonnement ou votre espace de travail ne la propose pas.

Ajout d'Atli eSIM à ChatGPT : Plugins dans la barre latérale, Add puis Add custom MCP server. Le formulaire contient le nom Atli eSIM, l'adresse https://mcp.heyatli.com/r/YOUR_CODE et No authentication. La case sur les risques est cochée avant Create as a plugin

Claude. Ouvrez Customize, puis Connectors. Choisissez + Add, puis Add custom connector. Nommez-le Atli eSIM, collez l’adresse et choisissez Continue, puis de nouveau Continue à l’écran des réglages d’authentification que Claude détecte. Sous Authentication, choisissez Sign in when needed, gardez le client OAuth recommandé par Claude et choisissez Add. Claude invite l’utilisateur à se connecter à Atli uniquement lorsqu’une opération nécessite l’accès à son compte. Avec les offres Team et Enterprise, un propriétaire ajoute le connecteur dans Organization settings, puis les membres choisissent Connect. Avec l’offre Free, Claude autorise un seul connecteur personnalisé.

Ajout d'Atli eSIM à Claude : Connectors, + Add et Add custom connector, puis le nom Atli eSIM et l'adresse, suivis de Sign in when needed avec le client OAuth recommandé par Claude et Add

Gemini. Sur gemini.google.com, ouvrez Settings, puis Connected Apps. Si cette entrée n’y est pas, cherchez sous Personal Intelligence. Sous Custom apps, choisissez Add a custom app, collez l’adresse, choisissez Next et suivez les étapes. Gemini ne demande pas de nom, et le serveur d’Atli se présente comme Atli eSIM. Gemini impose des conditions d’éligibilité supplémentaires. Les applications personnalisées exigent un compte Google personnel et l’option History activée. Elles ne fonctionnent qu’en anglais, et il faut avoir 18 ans ou plus et se trouver aux États-Unis. Une fois configurée depuis l’interface web, l’application personnalisée est aussi disponible dans l’application mobile Gemini.

Ajout d'Atli eSIM à Gemini : Settings, Connected Apps, Add a custom app sous Custom apps, puis l'adresse https://mcp.heyatli.com/r/YOUR_CODE et Next

Muse. Écrivez à Muse : « Ajoute le MCP Atli eSIM depuis cette adresse : https://mcp.heyatli.com/r/YOUR_CODE ». Confirmez si Muse vous le demande.

Ajout d'Atli eSIM à Muse : une nouvelle conversation avec le message qui demande d'ajouter le MCP Atli eSIM depuis cette adresse, suivi de l'adresse partenaire, puis une confirmation si Muse en demande une

Claude Code. Une seule commande ajoute le serveur :

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

Cursor, VS Code et autres applications. Ajoutez un serveur MCP distant, nommez-le Atli eSIM si l’application le demande, collez l’adresse et laissez vides les champs de connexion. Toute application compatible avec les serveurs MCP distants en Streamable HTTP fonctionne.

Posez ensuite le genre de question qu’un voyageur poserait : « Forfaits eSIM pour le Japon pendant 10 jours, en euros ».

Ce que l’assistant peut faire

La référence MCP fournit en temps réel la liste des outils disponibles et de leurs paramètres d’entrée.

  • Trouver un forfait. search_plans recherche par destination, durée, volume de données et devise. get_plan fournit le détail d’un forfait et indique les réseaux pris en charge. list_destinations récupère les destinations disponibles, et check_device_support vérifie la compatibilité eSIM des téléphones, des tablettes et des montres.
  • Acheter. get_quote récupère le prix final avec les réductions applicables. start_purchase crée une commande et génère un lien de paiement. get_order_status vérifie l’avancement de la commande, et cancel_order et get_receipt gèrent les annulations et les reçus.
  • Après l’achat. get_install_instructions fournit deux liens destinés à la personne qui utilisera l’eSIM. L’un l’ouvre dans l’application Atli, et l’autre l’installe depuis un navigateur et affiche les données restantes sans compte Atli. L’outil fournit aussi un QR code, les liens d’installation pour iPhone et Android et les instructions d’installation manuelle. list_my_esims récupère les eSIM du client, et refresh_usage met à jour les informations sur la consommation de données.
  • Autres fonctionnalités. Le serveur prend aussi en charge le partage d’eSIM, les moyens de paiement enregistrés, les bons, les crédits Atli, l’accès aux articles d’aide et la gestion d’un Atli Group.

Comment fonctionne le paiement dans une conversation

Les informations de carte bancaire ne sont communiquées ni à l’assistant IA ni à son fournisseur. Le client reçoit un lien vers la page de paiement sécurisée d’Atli, où Stripe traite le paiement et affiche le montant total avant la confirmation.

Un client qui a enregistré une carte peut aussi payer dans la conversation. Le serveur d’Atli donne pour instruction à l’assistant de ne la débiter qu’après que le client a vérifié le prix et la carte choisie, puis a explicitement accepté les deux. Une simple demande d’achat d’eSIM ne vaut pas cet accord. Le serveur ne vérifie pas lui-même que cette exigence est respectée.

Les clients peuvent acheter des eSIM en tant qu’invités sans se connecter. L’assistant conserve une clé d’invité associée à la conversation, ce qui permet au client de revenir dans la même conversation pour accéder aux instructions d’installation ou vérifier ses données restantes. Les liens d’installation fonctionnent aussi en dehors de la conversation. Ils ouvrent l’eSIM dans l’application Atli ou sur heyatli.com, qui affiche les données restantes sans compte.

Les clients qui se connectent à Atli peuvent accéder aux eSIM liées à leur compte depuis les conversations compatibles. L’authentification se fait sur heyatli.com : les mots de passe et les codes de vérification ne transitent donc pas par la conversation.

Créer votre propre agent

Les agents personnalisés peuvent se connecter au serveur MCP d’Atli en Streamable HTTP. L’exemple suivant utilise le SDK TypeScript officiel :

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);

Le premier appel à un outil d’achat crée un compte invité et renvoie une guest_key. Conservez cette clé de façon sécurisée dans la session de conversation de l’utilisateur et incluez-la dans les requêtes suivantes.

La guest_key identifie le compte invité et donne accès aux eSIM qui y sont associées.

Pour vos tests, connectez-vous au serveur Sandbox https://staging.public.mcp.heyatli.com/r/YOUR_CODE. Sur Sandbox, les paiements de test se font avec le numéro de carte de test de Stripe 4242 4242 4242 4242. Les eSIM Sandbox proviennent d’un opérateur de test : elles ne peuvent donc pas être installées sur un téléphone, et les ventes Sandbox ne rapportent jamais de commission.

Lorsque la référence MCP est basculée sur Sandbox, elle propose aussi un bouton Essayer pour tester chaque outil individuellement.

Comment les ventes MCP vous sont attribuées

Les nouveaux clients invités qui achètent via votre URL MCP sont rattachés à votre code partenaire.

Le rattachement des clients qui se connectent à un compte Atli existant nécessite une activation supplémentaire de la part d’Atli. Une fois qu’un client est rattaché à votre compte partenaire, ses futurs achats éligibles sur tous les canaux Atli sont pris en compte dans vos gains de parrainage.

Pour en savoir plus sur les commissions et les versements, consultez le guide du programme d’affiliation Atli. Le guide de l’API Atli couvre les applications qui nécessitent une interface personnalisée.

FAQ

Le serveur MCP Atli a-t-il besoin d'une clé API ?
Non. Le serveur MCP est accessible publiquement. Les clients peuvent consulter les forfaits sans compte, et un compte invité est créé automatiquement lorsqu’un achat le nécessite. La connexion à Atli est facultative.
L'assistant peut-il dépenser de l'argent sans demander ?
Un lien de paiement n’est réglé que lorsque le client finalise le paiement sur la page de paiement d’Atli. Pour une carte enregistrée ou la carte d’un Atli Group, Atli donne pour instruction à l’assistant de demander au client d’approuver le prix et la carte ou le groupe avant tout débit. Le serveur ne vérifie pas lui-même que cette exigence est respectée.
Quels assistants IA sont compatibles ?
Tous ceux qui prennent en charge les serveurs MCP distants en Streamable HTTP. C’est le cas des plugins ChatGPT, des connecteurs personnalisés de Claude, des applications personnalisées de Gemini, de Muse, de Claude Code, de Cursor et de VS Code.
Où la personne retrouve-t-elle son eSIM ensuite ?
Dans les liens d’installation que l’assistant fournit après le paiement. L’un ouvre l’eSIM dans l’application Atli, et l’autre l’ouvre sur heyatli.com, qui l’installe et affiche les données restantes sans compte. Toute personne qui a ces liens peut installer l’eSIM : ils ne doivent donc être transmis qu’à la personne qui l’utilisera. Les clients invités peuvent aussi revenir dans la conversation d’origine, et ceux qui ont acheté en étant connectés peuvent retrouver leurs eSIM via leur compte Atli dans d’autres conversations compatibles.
Connecter le serveur est-il payant ?
Non. Ajouter Atli à un assistant est gratuit, et les gens ne paient que l’eSIM qu’ils choisissent. L’abonnement de l’assistant peut limiter les connecteurs qu’on peut y ajouter.