Guida

Collega un assistente AI al server MCP di Atli eSIM

Collega ChatGPT, Claude, Gemini o il tuo agente AI al server MCP di Atli per cercare piani eSIM, gestire gli acquisti e guidare l'installazione.

Una chat con un assistente AI in cui Atli propone piani per il Giappone e un link di pagamento sicuro, accanto alla mascotte blu alata di Atli che esce da un telefono

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.

Il riquadro Il tuo indirizzo nella pagina Server MCP di partners.heyatli.com, con l'indirizzo del server, un pulsante per copiarlo e il pulsante Aggiungi codice referral

Per comporre l’URL direttamente, aggiungi il tuo codice partner dopo /r/:

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

I 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.

Aggiunta di Atli eSIM a ChatGPT: Plugins nella barra laterale, Add e poi Add custom MCP server. Il modulo contiene il nome Atli eSIM, l'indirizzo https://mcp.heyatli.com/r/YOUR_CODE e No authentication. La casella sul rischio è spuntata prima di Create as a plugin

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.

Aggiunta di Atli eSIM a Claude: Connectors, + Add e Add custom connector, poi il nome Atli eSIM e l'indirizzo, seguiti da Sign in when needed con il client OAuth consigliato da Claude e Add

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.

Aggiunta di Atli eSIM a Gemini: Settings, Connected Apps, Add a custom app sotto Custom apps, poi l'indirizzo https://mcp.heyatli.com/r/YOUR_CODE e Next

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.

Aggiunta di Atli eSIM a Muse: una nuova chat con il messaggio che chiede di aggiungere l'MCP di Atli eSIM da questo indirizzo, seguito dall'indirizzo partner, poi una conferma se Muse la chiede

Claude Code. Basta un comando per aggiungere il server:

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

Cursor, 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_plans cerca per destinazione, durata, traffico dati e valuta. get_plan fornisce altri dettagli sul piano e indica le reti supportate. list_destinations restituisce le destinazioni disponibili, mentre check_device_support verifica la compatibilità eSIM di telefoni, tablet e smartwatch.
  • Acquistare. get_quote restituisce il prezzo finale con gli eventuali sconti applicabili. start_purchase crea un ordine e genera un link di pagamento. get_order_status controlla lo stato dell’ordine, mentre cancel_order e get_receipt gestiscono annullamenti e ricevute.
  • Dopo l’acquisto. get_install_instructions fornisce 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_esims restituisce le eSIM del cliente, mentre refresh_usage aggiorna 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:

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 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.

Domande frequenti

Il server MCP di Atli richiede una chiave API?
No. Il server MCP è accessibile pubblicamente. I clienti possono consultare i piani senza un account, e l’account ospite viene creato automaticamente quando serve per un acquisto. L’accesso ad Atli è facoltativo.
L'assistente può spendere soldi senza chiedere?
Un link di pagamento viene saldato solo quando il cliente completa il pagamento sulla pagina di pagamento di Atli. Per una carta salvata o la carta di un Atli Group, Atli dà all’assistente l’istruzione di chiedere al cliente di approvare il prezzo e la carta o il gruppo prima dell’addebito. Il server non verifica da solo che questo requisito venga rispettato.
Con quali assistenti AI funziona?
Funziona qualsiasi assistente che supporti server MCP remoti su Streamable HTTP. Tra questi ci sono i plugin di ChatGPT, i connettori personalizzati di Claude, le app personalizzate di Gemini, Muse, Claude Code, Cursor e VS Code.
Dopo l'acquisto, dove ritrova la eSIM chi ha comprato?
Nei link di installazione che l’assistente fornisce dopo il pagamento. Uno apre la eSIM nell’app di Atli, l’altro la apre su heyatli.com, che la installa e mostra il traffico dati rimasto senza bisogno di un account. Chiunque abbia quei link può installare la eSIM, quindi vanno dati solo alla persona che la userà. I clienti ospiti possono anche tornare nella conversazione originale, e chi ha acquistato dopo aver effettuato l’accesso può ritrovare le proprie eSIM tramite l’account Atli in altre conversazioni supportate.
Collegare il server costa qualcosa?
No. Aggiungere Atli a un assistente è gratis, e le persone pagano solo la eSIM che scelgono. Il piano dell’assistente può limitare i connettori che si possono aggiungere.