Poradnik

Połącz asystenta AI z serwerem MCP Atli eSIM

Połącz ChatGPT, Claude, Gemini lub własnego agenta AI z serwerem MCP Atli, by wyszukiwać pakiety eSIM, obsługiwać zakupy i podawać instrukcje instalacji.

Czat z AI, w którym Atli proponuje pakiety na Japonię i bezpieczny link do płatności, obok niebieskiej skrzydlatej maskotki Atli wychodzącej z telefonu

Atli udostępnia publiczny serwer MCP, przez który asystenci AI mogą sprzedawać eSIM na podróż. Dzięki tej integracji asystenci wyszukują pakiety, sprawdzają, czy urządzenie obsługuje eSIM, realizują zamówienia i przekazują instrukcje instalacji eSIM.

Model Context Protocol (MCP) to otwarty standard, który pozwala asystentom AI korzystać z zewnętrznych narzędzi i usług. Serwer MCP Atli daje dostęp do aktualnego katalogu eSIM, dzięki czemu informacje o pakietach i ceny pochodzą bezpośrednio od Atli, a nie z wiedzy, którą asystent AI już ma.

Twój kod partnera jest częścią adresu URL serwera MCP. Nowi klienci, którzy kupią jako goście przez asystenta połączonego z tym adresem, zostają przypisani do twojego konta partnera. Dotyczy to zarówno asystentów AI, które tworzysz, jak i obsługiwanych asystentów innych firm skonfigurowanych z twoim adresem MCP.

Twój adres MCP

Zaloguj się na partners.heyatli.com i otwórz Serwer MCP. Adres, który tam znajdziesz, zawiera twój kod partnera i ma przycisk kopiowania.

Pole Twój adres na stronie Serwer MCP w partners.heyatli.com z adresem serwera, przyciskiem kopiowania i przyciskiem Dodaj kod polecający

Aby samodzielnie złożyć adres URL, wstaw swój kod partnera po /r/:

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

Nowi klienci, którzy kupią jako goście przez twój adres URL MCP, zostają przypisani do twojego kodu partnera. Jeśli twój kod daje zniżkę, obejmuje ona ich pierwsze zamówienie.

Standardowy adres https://mcp.heyatli.com też pozwala na zakupy, ale nie przypisuje ich do partnera. Zawsze używaj pełnego adresu z kodem polecającym, żeby kwalifikująca się sprzedaż była przypisywana do ciebie.

Podłączanie ChatGPT, Claude i Gemini

Menu konfiguracji mogą się zmieniać, gdy platformy AI aktualizują swoje interfejsy. Nazwy menu i przycisków pochodzą z angielskiej wersji tych aplikacji i tak samo wyglądają na ilustracjach. Jeśli instrukcje różnią się od tego, co widzisz, sprawdź w dokumentacji platformy informacje o własnych serwerach MCP albo konektorach.

ChatGPT. Otwórz Plugins na pasku bocznym, wybierz Add, a potem Add custom MCP server. Nazwij go Atli eSIM, zostaw wybrane Server URL, wklej adres i ustaw Authentication na No authentication. Zaznacz I understand and want to continue i wybierz Create as a plugin, a potem zainstaluj plugin i wypróbuj go w nowym czacie. OpenAI w pełni obsługuje własne serwery MCP w planach Business, Enterprise i Edu, gdzie administratorzy obszaru roboczego decydują, kto może je dodawać. W planie Pro pozwala tylko na akcje odczytu i pobierania, więc licz się z tym, że wyszukiwanie pakietów zadziała, a zakup nie. Jeśli tej opcji nie ma w menu, twój plan albo obszar roboczy jej nie oferuje.

Dodawanie Atli eSIM do ChatGPT: Plugins na pasku bocznym, Add, a potem Add custom MCP server. W formularzu jest nazwa Atli eSIM, adres https://mcp.heyatli.com/r/YOUR_CODE i No authentication. Pole akceptacji ryzyka jest zaznaczone przed Create as a plugin

Claude. Otwórz Customize, a potem Connectors. Wybierz + Add, a następnie Add custom connector. Nazwij go Atli eSIM, wklej adres i wybierz Continue, a potem jeszcze raz Continue na ekranie z wykrytymi przez Claude ustawieniami uwierzytelniania. W sekcji Authentication wybierz Sign in when needed, zostaw zalecanego przez Claude klienta OAuth i wybierz Add. Claude prosi użytkowników o zalogowanie do Atli tylko wtedy, gdy dana operacja wymaga dostępu do konta. W planach Team i Enterprise konektor dodaje właściciel w Organization settings, a członkowie wybierają potem Connect. W planie Free Claude pozwala na jeden własny konektor.

Dodawanie Atli eSIM do Claude: Connectors, + Add i Add custom connector, potem nazwa Atli eSIM i adres, a na końcu Sign in when needed z zalecanym przez Claude klientem OAuth i Add

Gemini. Na gemini.google.com otwórz Settings, a potem Connected Apps. Jeśli ich tam nie ma, zajrzyj do Personal Intelligence. W sekcji Custom apps wybierz Add a custom app, wklej adres, wybierz Next i przejdź kolejne kroki. Gemini nie pyta o nazwę, a serwer Atli przedstawia się jako Atli eSIM. W Gemini obowiązują dodatkowe wymagania. Własne aplikacje wymagają osobistego konta Google i włączonej opcji History. Działają tylko po angielsku, a ty musisz mieć ukończone 18 lat i przebywać w USA. Gdy skonfigurujesz własną aplikację w przeglądarce, będzie ona dostępna również w mobilnej aplikacji Gemini.

Dodawanie Atli eSIM do Gemini: Settings, Connected Apps, Add a custom app w sekcji Custom apps, potem adres https://mcp.heyatli.com/r/YOUR_CODE i Next

Muse. Poproś Muse tymi słowami: „Dodaj MCP Atli eSIM z tego adresu: https://mcp.heyatli.com/r/YOUR_CODE”. Potwierdź, jeśli Muse zapyta.

Dodawanie Atli eSIM do Muse: w nowym czacie prośba o dodanie MCP Atli eSIM z podanego adresu, po niej adres partnera, a na końcu potwierdzenie, jeśli Muse o nie poprosi

Claude Code. Wystarczy jedno polecenie:

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

Cursor, VS Code i inne aplikacje. Dodaj zdalny serwer MCP, nazwij go Atli eSIM, jeśli aplikacja o to poprosi, wklej adres i zostaw logowanie puste. Zadziała każda aplikacja, która obsługuje zdalne serwery MCP przez Streamable HTTP.

Potem zapytaj tak, jak zapytałby podróżny: „pakiety eSIM do Japonii na 10 dni, ceny w euro”.

Co potrafi asystent

Dokumentacja MCP pokazuje na żywo listę dostępnych narzędzi i ich parametrów wejściowych.

  • Znajdowanie pakietu. search_plans wyszukuje według kierunku, czasu trwania, ilości danych i waluty. get_plan podaje dodatkowe szczegóły pakietu, w tym obsługiwane sieci. list_destinations pobiera dostępne kierunki, a check_device_support sprawdza, czy telefony, tablety i zegarki obsługują eSIM.
  • Zakup. get_quote pobiera ostateczną cenę z uwzględnieniem obowiązujących zniżek. start_purchase tworzy zamówienie i generuje link do płatności. get_order_status sprawdza stan zamówienia, a cancel_order i get_receipt obsługują anulowanie zamówień i rachunki.
  • Po zakupie. get_install_instructions zwraca dwa linki dla osoby, która będzie używać eSIM. Jeden otwiera ją w aplikacji Atli, a drugi instaluje ją z przeglądarki i pokazuje pozostałe dane bez konta Atli. Narzędzie zwraca też kod QR, linki do instalacji na iPhonie i Androidzie oraz instrukcję ręcznej instalacji. list_my_esims pobiera eSIM klienta, a refresh_usage aktualizuje informacje o zużyciu danych.
  • Dodatkowe funkcje. Serwer obsługuje też udostępnianie eSIM, zapisane metody płatności, vouchery, kredyty Atli, dostęp do artykułów pomocy i zarządzanie Atli Group.

Jak działa płatność w czacie

Dane karty płatniczej nie są przekazywane asystentowi AI ani jego dostawcy. Klienci dostają link do bezpiecznej strony płatności Atli, gdzie płatność obsługuje Stripe, a przed potwierdzeniem widać łączną kwotę.

Klienci z zapisaną kartą mogą też zapłacić w czacie. Serwer Atli instruuje asystenta, żeby obciążył kartę dopiero wtedy, gdy klient sprawdzi cenę i wybraną kartę i wyraźnie zatwierdzi jedno i drugie. Ogólna prośba o zakup eSIM nie jest takim zatwierdzeniem. Serwer nie egzekwuje tego wymogu samodzielnie.

Klienci mogą kupować eSIM jako goście bez logowania. Asystent przechowuje klucz gościa powiązany z rozmową, więc klient może wrócić do tego samego czatu, żeby otworzyć instrukcję instalacji albo sprawdzić pozostałe dane. Linki instalacyjne działają też poza czatem. Otwierają eSIM w aplikacji Atli albo na heyatli.com, gdzie pozostałe dane widać bez konta.

Klienci, którzy zalogują się do Atli, mają dostęp do eSIM przypisanych do ich konta we wszystkich obsługiwanych rozmowach. Logowanie odbywa się na heyatli.com, więc hasła i kody weryfikacyjne nie są przekazywane przez czat.

Budowanie własnego agenta

Własny agent może łączyć się z serwerem MCP Atli przez Streamable HTTP. Poniższy przykład używa oficjalnego 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);

Pierwsze wywołanie narzędzia związanego z zakupem tworzy konto gościa i zwraca guest_key. Przechowuj ten klucz bezpiecznie w sesji rozmowy użytkownika i dołączaj go do kolejnych żądań.

guest_key identyfikuje konto gościa i daje dostęp do powiązanych z nim eSIM.

Do testów połącz się z serwerem Sandbox pod https://staging.public.mcp.heyatli.com/r/YOUR_CODE. Sandbox obsługuje płatności testowe z użyciem numeru testowej karty Stripe 4242 4242 4242 4242. W Sandbox eSIM pochodzą od testowego operatora, więc nie da się ich zainstalować na telefonie, a sprzedaż w tym środowisku nigdy nie daje prowizji.

Po przełączeniu dokumentacji MCP na Sandbox pojawia się w niej też przycisk Wypróbuj do testowania poszczególnych narzędzi.

Jak przypisywana jest sprzedaż przez MCP

Nowi klienci, którzy kupią jako goście przez twój adres URL MCP, zostają przypisani do twojego kodu partnera.

Przypisanie klientów, którzy logują się na istniejące konta Atli, wymaga dodatkowego włączenia przez Atli. Gdy klient zostanie przypisany do twojego konta partnera, jego przyszłe kwalifikujące się zakupy we wszystkich kanałach Atli wliczają się do twoich zarobków z poleceń.

Szczegóły dotyczące prowizji i wypłat opisuje poradnik Jak program partnerski Atli płaci za polecenia. Poradnik o API Atli dotyczy aplikacji, które wymagają własnego interfejsu.

FAQ

Czy serwer MCP Atli wymaga klucza API?
Nie. Serwer MCP jest publicznie dostępny. Klienci mogą przeglądać pakiety bez konta, a konto gościa tworzy się automatycznie, gdy jest potrzebne do zakupu. Logowanie do Atli jest opcjonalne.
Czy asystent może wydać pieniądze bez pytania?
Link do płatności zostaje opłacony dopiero wtedy, gdy klient dokończy płatność na stronie płatności Atli. Przy zapisanej karcie lub karcie Atli Group asystent dostaje od Atli instrukcję, żeby przed obciążeniem poprosił klienta o zatwierdzenie ceny oraz karty lub grupy. Serwer nie egzekwuje tego wymogu samodzielnie.
Którzy asystenci AI z nim współpracują?
Każdy, który obsługuje zdalne serwery MCP przez Streamable HTTP. Należą do nich pluginy ChatGPT, własne konektory Claude, własne aplikacje Gemini, Muse, Claude Code, Cursor i VS Code.
Gdzie ta osoba znajdzie potem swoją eSIM?
Przez linki instalacyjne, które asystent daje po płatności. Jeden otwiera eSIM w aplikacji Atli, a drugi otwiera ją na heyatli.com, gdzie można ją zainstalować i sprawdzić pozostałe dane bez konta. Każdy, kto ma te linki, może zainstalować eSIM, więc powinny trafić tylko do osoby, która będzie jej używać. Klienci, którzy kupili jako goście, mogą też wrócić do pierwotnej rozmowy, a ci, którzy kupili po zalogowaniu, mają dostęp do swoich eSIM przez konto Atli również w innych obsługiwanych rozmowach.
Czy podłączenie serwera coś kosztuje?
Nie. Dodanie Atli do asystenta jest bezpłatne, a ludzie płacą tylko za eSIM, którą wybiorą. Plan samego asystenta może ograniczać, jakie konektory da się dodać.