Ratgeber

KI-Assistenten mit dem eSIM-MCP-Server von Atli verbinden

Verbinde ChatGPT, Claude, Gemini oder deinen KI-Agenten mit dem MCP-Server von Atli. Er sucht eSIM-Tarife, wickelt Käufe ab und erklärt die Installation.

Ein KI-Chat, in dem Atli Japan-Tarife und einen sicheren Zahlungslink anbietet, neben dem geflügelten blauen Atli-Maskottchen, das aus einem Handy steigt

Atli stellt einen öffentlichen MCP-Server bereit, über den KI-Assistenten Reise-eSIMs verkaufen können. Damit suchen Assistenten Tarife, prüfen, ob ein Gerät eSIM unterstützt, wickeln Bestellungen ab und liefern Anleitungen zur Installation der eSIM.

Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Assistenten mit externen Tools und Diensten arbeiten können. Der MCP-Server von Atli gibt Zugriff auf den Live-Katalog der eSIMs. Dadurch kommen Tarifangaben und Preise direkt von Atli und nicht aus dem Wissen, das der KI-Assistent bereits mitbringt.

Dein Partnercode ist Teil der URL des MCP-Servers. Neue Kunden, die als Gast über einen mit dieser URL verbundenen Assistenten kaufen, werden deinem Partnerkonto zugeordnet. Das gilt sowohl für KI-Assistenten, die du selbst entwickelst, als auch für unterstützte Assistenten anderer Anbieter, in denen deine MCP-Adresse eingerichtet ist.

Deine MCP-Adresse

Melde dich auf partners.heyatli.com an und öffne MCP-Server. Die Adresse dort enthält deinen Partnercode und hat einen Kopier-Button.

Das Feld Deine Adresse auf der Seite MCP-Server von partners.heyatli.com mit der Serveradresse, einem Kopier-Button und dem Button Empfehlungscode hinzufügen

Um die URL selbst zusammenzusetzen, füge deinen Partnercode hinter /r/ ein:

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

Neue Gastkunden, die über deine MCP-URL kaufen, werden deinem Partnercode zugeordnet. Enthält dein Code einen Rabatt, gilt er für ihre erste Bestellung.

Die Standard-URL https://mcp.heyatli.com funktioniert ebenfalls für Käufe, ordnet sie aber keinem Partner zu. Verwende immer deine vollständige Empfehlungs-URL, damit qualifizierte Verkäufe erfasst werden.

ChatGPT, Claude und Gemini verbinden

Die Menüs zur Einrichtung können sich ändern, wenn die KI-Plattformen ihre Oberflächen aktualisieren. Die Menünamen stammen wie auf den Bildern aus der englischen Oberfläche der Apps. Weicht die Anleitung von dem ab, was du siehst, schau in der Dokumentation der Plattform nach eigenen MCP-Servern oder Connectors.

ChatGPT. Öffne Plugins in der Seitenleiste, wähle Add und dann Add custom MCP server. Nenne den Server Atli eSIM, lass Server URL ausgewählt, füge die Adresse ein und stell Authentication auf No authentication. Setz das Häkchen bei I understand and want to continue und wähle Create as a plugin. Installiere dann das Plugin und probier es in einem neuen Chat aus. OpenAI unterstützt eigene MCP-Server voll in den Plänen Business, Enterprise und Edu, wo Workspace-Admins entscheiden, wer sie hinzufügen darf. Im Pro-Plan erlaubt OpenAI nur Lese- und Abrufaktionen, rechne dort also damit, dass die Tarifsuche funktioniert und der Kauf nicht. Fehlt die Option im Menü, bietet dein Plan oder Workspace sie nicht an.

Atli eSIM zu ChatGPT hinzufügen: Plugins in der Seitenleiste, Add und dann Add custom MCP server. Im Formular stehen der Name Atli eSIM, die Adresse https://mcp.heyatli.com/r/YOUR_CODE und No authentication. Vor Create as a plugin ist das Kästchen zum Risiko angehakt

Claude. Öffne Customize und dann Connectors. Wähle + Add und dann Add custom connector. Nenne den Connector Atli eSIM, füge die Adresse ein und wähle Continue, dann noch einmal Continue, um an den von Claude erkannten Authentifizierungseinstellungen vorbeizukommen. Wähle unter Authentication die Option Sign in when needed, behalte den von Claude empfohlenen OAuth-Client und wähle Add. Claude fordert Nutzer erst dann zur Anmeldung bei Atli auf, wenn ein Vorgang Zugriff auf ihr Konto erfordert. In den Plänen Team und Enterprise fügt ein Owner den Connector unter Organization settings hinzu, und die Mitglieder wählen danach Connect. Im Free-Plan erlaubt Claude einen eigenen Connector.

Atli eSIM zu Claude hinzufügen: Connectors, + Add und Add custom connector, dann der Name Atli eSIM und die Adresse, danach Sign in when needed mit dem von Claude empfohlenen OAuth-Client und Add

Gemini. Öffne auf gemini.google.com Settings und dann Connected Apps. Findest du den Punkt dort nicht, schau unter Personal Intelligence. Wähle unter Custom apps die Option Add a custom app, füge die Adresse ein, wähle Next und folge den Schritten. Gemini fragt nicht nach einem Namen, und der Server von Atli stellt sich selbst als Atli eSIM vor. Für Gemini gelten zusätzliche Voraussetzungen. Benutzerdefinierte Apps brauchen ein privates Google-Konto, und History muss eingeschaltet sein. Sie funktionieren nur auf Englisch, und du musst mindestens 18 Jahre alt sein und dich in den USA aufhalten. Sobald die benutzerdefinierte App über die Weboberfläche eingerichtet ist, steht sie auch in der mobilen Gemini-App zur Verfügung.

Atli eSIM zu Gemini hinzufügen: Settings, Connected Apps, Add a custom app unter Custom apps, dann die Adresse https://mcp.heyatli.com/r/YOUR_CODE und Next

Muse. Bitte Muse mit diesen Worten: „Füge das MCP Atli eSIM von dieser Adresse hinzu: https://mcp.heyatli.com/r/YOUR_CODE“. Bestätige, falls Muse nachfragt.

Atli eSIM zu Muse hinzufügen: ein neuer Chat mit der Bitte, das MCP Atli eSIM von dieser Adresse hinzuzufügen, gefolgt von der Partneradresse, dann eine Bestätigung, falls Muse danach fragt

Claude Code. Ein einziger Befehl fügt den Server hinzu:

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

Cursor, VS Code und andere Apps. Leg einen Remote-MCP-Server an, nenne ihn Atli eSIM, falls die App nach einem Namen fragt, füge die Adresse ein und lass die Anmeldung leer. Jede App, die Remote-MCP-Server über Streamable HTTP unterstützt, funktioniert.

Dann frag so, wie Reisende fragen würden: „eSIM-Tarife für Japan für 10 Tage, in Euro“.

Was der Assistent kann

Die MCP-Referenz zeigt live alle verfügbaren Tools und ihre Eingabeparameter.

  • Einen Tarif finden. search_plans sucht nach Reiseziel, Dauer, Datenvolumen und Währung. get_plan liefert weitere Details zu einem Tarif, darunter die unterstützten Netze. list_destinations ruft die verfügbaren Reiseziele ab, und check_device_support prüft, ob Handys, Tablets und Smartwatches eSIM unterstützen.
  • Kauf. get_quote ruft den Endpreis einschließlich aller geltenden Rabatte ab. start_purchase legt eine Bestellung an und erzeugt einen Zahlungslink. get_order_status prüft den Stand der Bestellung, und cancel_order und get_receipt übernehmen Stornierungen und Belege.
  • Nach dem Kauf. get_install_instructions liefert zwei Links für die Person, die die eSIM nutzen wird. Der eine öffnet sie in der Atli-App, der andere installiert sie über den Browser und zeigt ohne Atli-Konto das verbleibende Datenvolumen. Außerdem liefert das Tool einen QR-Code, Installationslinks für iPhone und Android und eine Anleitung zur manuellen Installation. list_my_esims ruft die eSIMs der Kundschaft ab, und refresh_usage aktualisiert die Angaben zum Datenverbrauch.
  • Weitere Funktionen. Der Server unterstützt außerdem das Teilen von eSIMs, gespeicherte Zahlungsmethoden, Gutscheine, Atli-Credits, den Zugriff auf Hilfeartikel und die Verwaltung einer Atli Group.

Wie im Chat bezahlt wird

Kartendaten werden weder an den KI-Assistenten noch an seinen Anbieter weitergegeben. Kunden erhalten einen Link zur sicheren Zahlungsseite von Atli. Dort wickelt Stripe die Zahlung ab und zeigt den Gesamtbetrag vor der Bestätigung an.

Kunden mit einer gespeicherten Karte können auch direkt im Chat bezahlen. Der Server von Atli weist den Assistenten an, die Karte erst dann zu belasten, wenn die Person Preis und ausgewählte Karte geprüft und beidem ausdrücklich zugestimmt hat. Eine allgemeine Bitte, eine eSIM zu kaufen, gilt nicht als diese Zustimmung. Der Server setzt diese Vorgabe nicht selbst durch.

Kunden können eSIMs ohne Anmeldung als Gast kaufen. Der Assistent bewahrt einen Gastschlüssel auf, der an das Gespräch gebunden ist. So können Kunden in denselben Chat zurückkehren, um die Installationsanleitung aufzurufen oder ihr verbleibendes Datenvolumen zu prüfen. Die Installationslinks funktionieren auch außerhalb des Chats. Sie öffnen die eSIM in der Atli-App oder auf heyatli.com, wo das verbleibende Datenvolumen auch ohne Konto zu sehen ist.

Kunden, die sich bei Atli anmelden, erreichen die eSIMs ihres Kontos aus allen unterstützten Chats. Die Anmeldung findet auf heyatli.com statt, sodass Passwörter und Bestätigungscodes nicht über den Chat übermittelt werden.

Einen eigenen Agenten bauen

Eigene Agenten können sich über Streamable HTTP mit dem MCP-Server von Atli verbinden. Das folgende Beispiel nutzt das offizielle TypeScript-SDK:

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

Der erste Tool-Aufruf, der mit einem Kauf zu tun hat, legt ein Gastkonto an und gibt einen guest_key zurück. Speichere diesen Schlüssel sicher in der Gesprächssitzung des Nutzers und sende ihn bei allen folgenden Anfragen mit.

Der guest_key identifiziert das Gastkonto und gibt Zugriff auf die zugehörigen eSIMs.

Zum Testen verbindest du dich mit dem Sandbox-Server unter https://staging.public.mcp.heyatli.com/r/YOUR_CODE. Die Sandbox unterstützt Testzahlungen mit der Testkartennummer 4242 4242 4242 4242 von Stripe. Sandbox-eSIMs stammen von einem Testnetzbetreiber, lassen sich also nicht auf einem Handy installieren, und für Verkäufe in der Sandbox gibt es nie Provision.

Ist die MCP-Referenz auf die Sandbox umgeschaltet, bietet sie außerdem einen Button Testen, mit dem du einzelne Tools ausprobierst.

Wie dir MCP-Verkäufe gutgeschrieben werden

Neue Gastkunden, die über deine MCP-URL kaufen, werden deinem Partnercode zugeordnet.

Kunden, die sich mit einem bestehenden Atli-Konto anmelden, werden erst zugeordnet, wenn Atli das gesondert freischaltet. Ist ein Kunde deinem Partnerkonto zugeordnet, fließen seine künftigen qualifizierten Käufe auf allen Atli-Kanälen in deinen Verdienst ein.

Details zu Provisionen und Auszahlungen findest du im Ratgeber zum Atli-Partnerprogramm. Der Ratgeber zur Atli-API behandelt Anwendungen, die eine eigene Oberfläche brauchen.

FAQ

Braucht der MCP-Server von Atli einen API-Key?
Nein. Der MCP-Server ist öffentlich zugänglich. Tarife lassen sich ohne Konto ansehen, und für Käufe wird bei Bedarf automatisch ein Gastkonto angelegt. Die Anmeldung bei Atli ist optional.
Kann der Assistent ohne Nachfrage Geld ausgeben?
Ein Zahlungslink wird erst bezahlt, wenn die Person die Zahlung auf der Zahlungsseite von Atli abschließt. Bei einer gespeicherten Karte oder der Karte einer Atli Group weist Atli den Assistenten an, vor der Belastung die Zustimmung der Person zum Preis und zur Karte oder Gruppe einzuholen. Der Server setzt diese Vorgabe nicht selbst durch.
Welche KI-Assistenten funktionieren damit?
Alle, die Remote-MCP-Server über Streamable HTTP unterstützen. Dazu gehören Plugins in ChatGPT, eigene Connectors in Claude, benutzerdefinierte Apps in Gemini, Muse, Claude Code, Cursor und VS Code.
Wo findet die Person ihre eSIM später?
Über die Installationslinks, die der Assistent nach der Zahlung schickt. Der eine öffnet die eSIM in der Atli-App, der andere öffnet sie auf heyatli.com, wo sie sich installieren lässt und das verbleibende Datenvolumen ohne Konto zu sehen ist. Wer diese Links hat, kann die eSIM installieren, deshalb sollten sie nur an die Person gehen, die die eSIM nutzen wird. Gastkunden können außerdem in das ursprüngliche Gespräch zurückkehren. Wer beim Kauf angemeldet war, erreicht seine eSIMs über das Atli-Konto auch in anderen unterstützten Chats.
Kostet es etwas, den Server zu verbinden?
Nein. Atli zu einem Assistenten hinzuzufügen ist kostenlos, und die Leute zahlen nur für die eSIM, die sie wählen. Der Plan des Assistenten kann einschränken, welche Connectors sich hinzufügen lassen.