
Atli mette a disposizione un server MCP pubblico che permette agli assistenti AI di vendere eSIM da viaggio. Grazie a questa integrazione, gli assistenti possono cercare piani, verificare la compatibilità dei dispositivi, gestire gli ordini e fornire le istruzioni per installare la eSIM.
Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti AI di interagire con strumenti e servizi esterni. Il server MCP di Atli dà accesso al catalogo eSIM aggiornato in tempo reale. Così le informazioni sui piani e i prezzi arrivano direttamente da Atli e non dalle conoscenze pregresse dell’assistente AI.
Il tuo codice partner è incluso nell’URL del server MCP. I nuovi clienti che acquistano come ospiti tramite un assistente collegato a quell’URL vengono associati al tuo account partner. Questo vale sia per gli assistenti AI che sviluppi tu sia per gli assistenti di terze parti compatibili configurati con il tuo indirizzo MCP.
Il tuo indirizzo MCP
Accedi a partners.heyatli.com e apri Server MCP. L’indirizzo che trovi lì contiene il tuo codice partner e ha un pulsante per copiarlo.

Per comporre l’URL direttamente, aggiungi il tuo codice partner dopo /r/:
https://mcp.heyatli.com/r/YOUR_CODEI nuovi clienti ospiti che acquistano tramite il tuo URL MCP vengono associati al tuo codice partner. Se il tuo codice prevede uno sconto, si applica al loro primo ordine.
L’URL standard https://mcp.heyatli.com permette anch’esso di acquistare, ma non attribuisce le vendite a nessun partner. Usa sempre il tuo URL referral completo per tracciare le vendite idonee.
Collegare ChatGPT, Claude e Gemini
I menu di configurazione possono cambiare quando le piattaforme di AI aggiornano le loro interfacce. Se le istruzioni non corrispondono a quello che vedi, consulta la documentazione della piattaforma sui server MCP personalizzati o sui connettori. Come nelle immagini, i nomi dei menu sono quelli dell’interfaccia in inglese delle app.
ChatGPT. Apri Plugins nella barra laterale, scegli Add e poi Add custom MCP server. Chiamalo Atli eSIM, lascia selezionato Server URL, incolla l’indirizzo e imposta Authentication su No authentication. Spunta I understand and want to continue e scegli Create as a plugin, poi installa il plugin e provalo in una nuova chat. OpenAI supporta pienamente i server MCP personalizzati nei piani Business, Enterprise ed Edu, dove sono gli amministratori del workspace a decidere chi può aggiungerli. Su Pro consente solo azioni di lettura e di recupero, quindi aspettati che la ricerca dei piani funzioni e l’acquisto no. Se l’opzione non è nel menu, il tuo piano o il tuo workspace non la offre.

Claude. Apri Customize, poi Connectors. Scegli + Add, poi Add custom connector. Chiamalo Atli eSIM, incolla l’indirizzo e scegli Continue. Scegli di nuovo Continue per superare le impostazioni di autenticazione che Claude rileva. In Authentication scegli Sign in when needed, lascia il client OAuth consigliato da Claude e scegli Add. Claude chiede all’utente di accedere ad Atli solo quando un’operazione richiede l’accesso al suo account. Nei piani Team ed Enterprise è un proprietario ad aggiungere il connettore in Organization settings, e poi i membri scelgono Connect. Il piano Free di Claude consente un solo connettore personalizzato.

Gemini. Su gemini.google.com apri Settings, poi Connected Apps. Se non c’è, guarda sotto Personal Intelligence. In Custom apps scegli Add a custom app, incolla l’indirizzo, scegli Next e segui i passaggi. Gemini non chiede un nome, e il server di Atli si presenta come Atli eSIM. Gemini prevede requisiti di idoneità aggiuntivi. Le app personalizzate richiedono un account Google personale e History attivo. Funzionano solo in inglese, e devi avere almeno 18 anni e trovarti negli Stati Uniti. Una volta configurata dall’interfaccia web, l’app personalizzata è disponibile anche nell’app mobile di Gemini.

Muse. Chiedi a Muse con queste parole: «Aggiungi l’MCP di Atli eSIM da questo indirizzo: https://mcp.heyatli.com/r/YOUR_CODE». Conferma se Muse te lo chiede.

Claude Code. Basta un comando per aggiungere il server:
claude mcp add --transport http atli-esim https://mcp.heyatli.com/r/YOUR_CODECursor, VS Code e altre app. Aggiungi un server MCP remoto, chiamalo Atli eSIM se l’app lo chiede, incolla l’indirizzo e lascia vuoti i campi di accesso. Funziona qualsiasi app che supporti server MCP remoti su Streamable HTTP.
Poi chiedi quello che chiederebbe un viaggiatore: «piani eSIM per il Giappone per 10 giorni, in euro».
Cosa può fare l’assistente
La documentazione di riferimento MCP fornisce un elenco aggiornato in tempo reale degli strumenti disponibili e dei relativi parametri di input.
- Trovare un piano.
search_planscerca per destinazione, durata, traffico dati e valuta.get_planfornisce altri dettagli sul piano e indica le reti supportate.list_destinationsrestituisce le destinazioni disponibili, mentrecheck_device_supportverifica la compatibilità eSIM di telefoni, tablet e smartwatch. - Acquistare.
get_quoterestituisce il prezzo finale con gli eventuali sconti applicabili.start_purchasecrea un ordine e genera un link di pagamento.get_order_statuscontrolla lo stato dell’ordine, mentrecancel_ordereget_receiptgestiscono annullamenti e ricevute. - Dopo l’acquisto.
get_install_instructionsfornisce due link per la persona che userà la eSIM. Uno la apre nell’app di Atli, l’altro la installa da un browser e mostra il traffico dati rimasto senza bisogno di un account Atli. Fornisce anche un codice QR, i link di installazione per iPhone e Android e le istruzioni per l’installazione manuale.list_my_esimsrestituisce le eSIM del cliente, mentrerefresh_usageaggiorna le informazioni sul consumo di dati. - Altre funzioni. Il server supporta anche la condivisione delle eSIM, i metodi di pagamento salvati, i voucher, i crediti Atli, l’accesso agli articoli di assistenza e la gestione di un Atli Group.
Come funziona il pagamento in chat
I dati della carta di pagamento non vengono condivisi con l’assistente AI né con il suo fornitore. Il cliente riceve un link alla pagina di pagamento sicura di Atli, dove Stripe elabora il pagamento e mostra il totale prima della conferma.
I clienti con una carta salvata possono anche pagare direttamente in chat. Il server di Atli dà all’assistente l’istruzione di addebitarla solo dopo che il cliente ha verificato il prezzo e la carta selezionata e li ha approvati esplicitamente entrambi. Una generica richiesta di acquistare una eSIM non vale come approvazione. Il server non verifica da solo che questo requisito venga rispettato.
I clienti possono acquistare eSIM come ospiti senza accedere. L’assistente conserva una chiave ospite associata alla conversazione, così il cliente può tornare nella stessa chat per consultare le istruzioni di installazione o controllare il traffico dati rimasto. I link di installazione funzionano anche fuori dalla chat. Aprono la eSIM nell’app di Atli o su heyatli.com, che mostra il traffico dati rimasto senza bisogno di un account.
I clienti che accedono ad Atli possono ritrovare le eSIM associate al loro account nelle conversazioni supportate. L’autenticazione avviene su heyatli.com, quindi password e codici di verifica non passano dalla chat.
Costruire il tuo agente
Gli agenti personalizzati possono collegarsi al server MCP di Atli tramite Streamable HTTP. L’esempio seguente usa l’SDK ufficiale per TypeScript:
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 prima chiamata a uno strumento di acquisto crea un account ospite e restituisce una guest_key. Conserva questa chiave in modo sicuro nella sessione di conversazione dell’utente e includila nelle richieste successive.
La guest_key identifica l’account ospite e dà accesso alle eSIM associate.
Per i test, collegati al server Sandbox su https://staging.public.mcp.heyatli.com/r/YOUR_CODE. La Sandbox supporta pagamenti di prova con il numero della carta di test di Stripe 4242 4242 4242 4242. Le eSIM della Sandbox vengono da un operatore di test, quindi non si possono installare su un telefono, e le vendite in Sandbox non generano mai commissioni.
Quando la documentazione di riferimento MCP è impostata sulla Sandbox, offre anche un pulsante Prova per testare i singoli strumenti.
Come vengono attribuite le vendite tramite MCP
I nuovi clienti ospiti che acquistano tramite il tuo URL MCP vengono associati al tuo codice partner.
L’attribuzione dei clienti che accedono con un account Atli esistente richiede un’attivazione aggiuntiva da parte di Atli. Una volta che un cliente è stato associato al tuo account partner, i suoi futuri acquisti idonei su tutti i canali Atli rientrano nei tuoi guadagni da referral.
Per i dettagli su commissioni e pagamenti, consulta la guida al programma di affiliazione Atli. La guida all’API di Atli copre le applicazioni che richiedono un’interfaccia personalizzata.



