Panduan

Hubungkan asisten AI ke server MCP Atli eSIM

Hubungkan ChatGPT, Claude, Gemini, atau agen AI Anda ke server MCP Atli untuk mencari paket eSIM, memproses pembelian, dan memberikan petunjuk pemasangan.

Chat AI tempat Atli menawarkan paket Jepang dan tautan pembayaran yang aman, di samping maskot biru Atli bersayap yang keluar dari ponsel

Atli menyediakan server MCP publik yang memungkinkan asisten AI menjual eSIM perjalanan. Melalui integrasi ini, asisten dapat mencari paket, memeriksa kompatibilitas perangkat, memproses pesanan, dan memberikan petunjuk pemasangan eSIM.

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan asisten AI berinteraksi dengan tool dan layanan eksternal. Server MCP Atli memberikan akses ke katalog eSIM terkini, sehingga informasi paket dan harga diambil langsung dari Atli dan tidak bergantung pada pengetahuan yang sudah dimiliki asisten AI.

Kode mitra Anda disertakan dalam alamat server MCP. Pelanggan baru yang membeli sebagai tamu lewat asisten yang terhubung ke alamat itu tercatat di akun mitra Anda. Ketentuan ini berlaku baik untuk asisten AI yang Anda kembangkan sendiri maupun untuk asisten pihak ketiga yang didukung dan sudah diatur dengan alamat MCP Anda.

Alamat MCP Anda

Masuk di partners.heyatli.com lalu buka Server MCP. Alamat di sana sudah memuat kode mitra Anda dan punya tombol salin.

Kotak Alamat Anda di halaman Server MCP partners.heyatli.com, berisi alamat server, tombol salin, dan tombol Tambahkan kode referral

Untuk menyusun alamatnya sendiri, tambahkan kode mitra Anda setelah /r/:

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

Pelanggan tamu baru yang membeli lewat alamat MCP Anda terhubung ke kode mitra Anda. Jika kode Anda memiliki diskon, diskon itu berlaku untuk pesanan pertama mereka.

Alamat standar https://mcp.heyatli.com juga bisa dipakai untuk membeli, tetapi tidak mencatat penjualan atas nama mitra. Selalu gunakan alamat referral lengkap Anda agar penjualan yang memenuhi syarat tercatat untuk Anda.

Menghubungkan ChatGPT, Claude, dan Gemini

Menu penyiapan bisa berubah saat platform AI memperbarui antarmukanya. Nama menu ditulis persis seperti di antarmuka berbahasa Inggris setiap aplikasi, dan gambar-gambarnya juga memperlihatkan antarmuka tersebut. Jika petunjuk ini berbeda dengan yang Anda lihat, periksa dokumentasi platform tersebut tentang server MCP kustom atau konektor.

ChatGPT. Buka Plugins di sidebar, pilih Add, lalu Add custom MCP server. Beri nama Atli eSIM, biarkan Server URL tetap terpilih, tempelkan alamatnya, lalu atur Authentication ke No authentication. Centang I understand and want to continue dan pilih Create as a plugin, lalu pasang plugin-nya dan coba di chat baru. OpenAI memberikan dukungan penuh untuk server MCP kustom di paket langganan Business, Enterprise, dan Edu, dan di sana admin workspace yang menentukan siapa yang boleh menambahkannya. Di paket Pro, OpenAI hanya mengizinkan aksi untuk membaca dan mengambil data, jadi perkirakan pencarian paket eSIM akan berjalan di sana, sedangkan pembelian tidak. Jika opsinya tidak ada di menu, paket langganan atau workspace Anda tidak menyediakannya.

Menambahkan Atli eSIM ke ChatGPT: Plugins di sidebar, Add, lalu Add custom MCP server. Formulirnya berisi nama Atli eSIM, alamat https://mcp.heyatli.com/r/YOUR_CODE, dan No authentication. Kotak peringatan risiko dicentang sebelum Create as a plugin

Claude. Buka Customize, lalu Connectors. Pilih + Add, lalu Add custom connector. Beri nama Atli eSIM, tempelkan alamatnya, lalu pilih Continue, kemudian pilih Continue sekali lagi untuk melewati pengaturan autentikasi yang dideteksi Claude. Di bagian Authentication, pilih Sign in when needed, biarkan klien OAuth yang direkomendasikan Claude tetap terpilih, lalu pilih Add. Claude baru meminta pengguna masuk ke Atli saat suatu operasi memerlukan akses ke akun. Di paket Team dan Enterprise, pemilik menambahkan konektornya di Organization settings, lalu anggota memilih Connect. Di paket Free, Claude hanya mengizinkan satu konektor kustom.

Menambahkan Atli eSIM ke Claude: Connectors, + Add dan Add custom connector, lalu nama Atli eSIM dan alamatnya, disusul Sign in when needed dengan klien OAuth yang direkomendasikan Claude, lalu Add

Gemini. Di gemini.google.com, buka Settings, lalu Connected Apps. Jika tidak ada di sana, cari di bawah Personal Intelligence. Di bagian Custom apps, pilih Add a custom app, tempelkan alamatnya, pilih Next, lalu ikuti langkah-langkahnya. Gemini tidak meminta nama, dan server Atli memperkenalkan dirinya sebagai Atli eSIM. Gemini memiliki syarat kelayakan tambahan. Aplikasi kustom memerlukan akun Google pribadi dan History dalam keadaan aktif. Fitur ini hanya berfungsi dalam bahasa Inggris, dan Anda harus berusia 18 tahun ke atas serta berada di Amerika Serikat. Setelah diatur lewat antarmuka web, aplikasi kustom ini juga tersedia di aplikasi seluler Gemini.

Menambahkan Atli eSIM ke Gemini: Settings, Connected Apps, Add a custom app di bawah Custom apps, lalu alamat https://mcp.heyatli.com/r/YOUR_CODE dan Next

Muse. Minta Muse dengan kalimat ini: “Tambahkan MCP Atli eSIM dari alamat ini: https://mcp.heyatli.com/r/YOUR_CODE”. Konfirmasikan jika Muse memintanya.

Menambahkan Atli eSIM ke Muse: chat baru berisi pesan Tambahkan MCP Atli eSIM dari alamat ini, diikuti alamat mitra, lalu konfirmasi jika Muse memintanya

Claude Code. Satu perintah sudah cukup untuk menambahkan server:

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

Cursor, VS Code, dan aplikasi lain. Tambahkan server MCP jarak jauh, beri nama Atli eSIM jika aplikasinya meminta, tempelkan alamatnya, dan biarkan pengaturan login kosong. Aplikasi apa pun yang mendukung server MCP jarak jauh lewat Streamable HTTP bisa dipakai.

Lalu tanyakan hal yang biasa ditanyakan pelancong: “paket eSIM untuk Jepang selama 10 hari, dalam euro”.

Yang bisa dilakukan asisten

Referensi MCP menyediakan daftar terkini tool yang tersedia beserta parameter input-nya.

  • Mencari paket. search_plans mencari paket berdasarkan destinasi, durasi, kuota data, dan mata uang. get_plan memberikan detail tambahan sebuah paket, termasuk jaringan yang didukung. list_destinations mengambil daftar destinasi yang tersedia, sedangkan check_device_support memeriksa kompatibilitas eSIM untuk ponsel, tablet, dan jam tangan.
  • Membeli. get_quote mengambil harga akhir, termasuk diskon yang berlaku. start_purchase membuat pesanan dan menghasilkan tautan pembayaran. get_order_status memeriksa perkembangan pesanan, sedangkan cancel_order dan get_receipt menangani pembatalan dan tanda terima.
  • Setelah membeli. get_install_instructions memberikan dua tautan untuk orang yang akan memakai eSIM. Satu membukanya di aplikasi Atli, dan yang lain memasangnya dari browser serta menampilkan sisa kuota tanpa akun Atli. Tool ini juga memberikan kode QR, tautan pemasangan untuk iPhone dan Android, serta petunjuk pemasangan manual. list_my_esims mengambil daftar eSIM pelanggan, sedangkan refresh_usage memperbarui informasi pemakaian data.
  • Fitur lainnya. Server ini juga mendukung berbagi eSIM, metode pembayaran tersimpan, voucher, kredit Atli, akses ke artikel bantuan, dan pengelolaan Atli Group.

Cara pembayaran di dalam chat

Detail kartu pembayaran tidak dibagikan kepada asisten AI maupun penyedianya. Pelanggan menerima tautan ke halaman pembayaran Atli yang aman. Di sana Stripe memproses pembayaran dan menampilkan totalnya sebelum pelanggan mengonfirmasi.

Pelanggan yang sudah menyimpan kartu juga bisa membayar di dalam chat. Server Atli menginstruksikan asisten untuk menagih kartu itu hanya setelah pelanggan memeriksa harga dan kartu yang dipilih, lalu menyetujui keduanya secara eksplisit. Permintaan umum untuk membeli eSIM tidak dihitung sebagai persetujuan tersebut. Persyaratan ini tidak ditegakkan secara mandiri oleh server.

Pelanggan dapat membeli eSIM sebagai tamu tanpa masuk ke akun. Asisten menyimpan kunci tamu yang terkait dengan percakapan, sehingga pelanggan bisa kembali ke chat yang sama untuk membuka petunjuk pemasangan atau memeriksa sisa kuota. Tautan pemasangan juga berfungsi di luar chat. Tautan itu membuka eSIM di aplikasi Atli atau di heyatli.com, yang menampilkan sisa kuota tanpa akun.

Pelanggan yang masuk ke Atli dapat membuka eSIM yang terkait dengan akunnya dari berbagai percakapan yang didukung. Autentikasi berlangsung di heyatli.com, jadi kata sandi dan kode verifikasi tidak dibagikan lewat chat.

Membangun agen sendiri

Agen kustom dapat terhubung ke server MCP Atli lewat Streamable HTTP. Contoh berikut memakai SDK TypeScript resmi:

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

Panggilan tool pertama yang berkaitan dengan pembelian akan membuat akun tamu dan mengembalikan guest_key. Simpan kunci ini dengan aman di sesi percakapan pengguna dan sertakan dalam permintaan berikutnya.

guest_key mengidentifikasi akun tamu dan memberikan akses ke eSIM yang terkait dengannya.

Untuk pengujian, hubungkan ke server Sandbox di https://staging.public.mcp.heyatli.com/r/YOUR_CODE. Sandbox mendukung pembayaran uji dengan nomor kartu uji Stripe 4242 4242 4242 4242. eSIM Sandbox berasal dari operator uji, jadi tidak bisa dipasang di ponsel, dan penjualan di Sandbox tidak pernah menghasilkan komisi.

Jika referensi MCP dialihkan ke Sandbox, referensi itu juga menyediakan tombol Coba untuk menguji tool satu per satu.

Cara penjualan lewat MCP dicatat atas nama Anda

Pelanggan tamu baru yang membeli lewat alamat MCP Anda terhubung ke kode mitra Anda.

Pelanggan yang masuk ke akun Atli yang sudah ada baru bisa terhubung ke Anda setelah Atli mengaktifkannya secara khusus. Setelah pelanggan berhasil terhubung ke akun mitra Anda, pembelian berikutnya yang memenuhi syarat di semua kanal Atli dihitung dalam penghasilan referral Anda.

Detail komisi dan pembayaran dibahas di panduan program afiliasi Atli. Panduan API Atli membahas aplikasi yang memerlukan antarmuka sendiri.

FAQ

Apakah server MCP Atli memerlukan API key?
Tidak. Server MCP ini dapat diakses publik. Pelanggan bisa melihat paket tanpa akun, dan akun tamu dibuat otomatis saat diperlukan untuk pembelian. Masuk ke Atli bersifat opsional.
Bisakah asisten membelanjakan uang tanpa bertanya?
Pembayaran lewat tautan hanya terjadi jika pelanggan menyelesaikannya sendiri di halaman pembayaran Atli. Untuk kartu tersimpan atau kartu Atli Group, Atli menginstruksikan asisten untuk meminta persetujuan pelanggan atas harga serta kartu atau grup yang dipakai sebelum menagihnya. Persyaratan ini tidak ditegakkan secara mandiri oleh server.
Asisten AI mana saja yang bisa dipakai?
Semua asisten yang mendukung server MCP jarak jauh lewat Streamable HTTP bisa dipakai. Plugin ChatGPT, konektor kustom Claude, aplikasi kustom Gemini, Muse, Claude Code, Cursor, dan VS Code termasuk di antaranya.
Di mana orang itu menemukan eSIM-nya setelah membeli?
Lewat tautan pemasangan yang diberikan asisten setelah pembayaran. Satu tautan membuka eSIM di aplikasi Atli, dan yang lain membukanya di heyatli.com, tempat eSIM bisa dipasang dan sisa kuotanya terlihat tanpa akun. Siapa pun yang memegang tautan itu bisa memasang eSIM-nya, jadi tautan itu sebaiknya hanya diberikan kepada orang yang akan memakainya. Pelanggan tamu juga bisa kembali ke percakapan awal, dan pelanggan yang membeli setelah masuk ke akun bisa membuka eSIM-nya lewat akun Atli di percakapan lain yang didukung.
Apakah menghubungkan server ini dikenai biaya?
Tidak. Menambahkan Atli ke asisten itu gratis, dan orang hanya membayar eSIM yang mereka pilih. Paket langganan asisten itu sendiri mungkin membatasi konektor apa saja yang bisa ditambahkan.