AI ajanınıza beş dakikada küresel bir eSIM verin

"AI sizin için bir şey satın alır" demolarının çoğu dumandan ibaret. Ajan bir form doldurur, ya da sizi bir ödeme sayfasına devreder, ya da sessizce bir insanın bir kod taramak için hazır beklediğini varsayar. Bağlantı, tüm döngünün gerçekten sohbetin içinde kapandığı nadir kategorilerden biridir — ve bu, sizi oraya götüren eğitimdir.

Sonunda, "Japonya'da veri bana ne tutar?" sorusunu yanıtlayabilen ve siz istediğinizde — Roamzy hesabı oluşturmanıza hiç gerek kalmadan — size gerçek bir eSIM üretip bir QR kodu ve bir ödeme bağlantısı uzatan bir ajana sahip olacaksınız. İki kurulum yolu izliyor. Birini seçin; ikisi de aynı yere varıyor.

Bir şey bağlamadan önce otuz saniyelik bağlam

Neye bağlandığınızı bilmek faydalı, çünkü daha önce kullanmış olabileceğiniz eSIM ürünleri gibi şekillenmiyor:

• Bir katalog değil, tek bir ürün. 193 ülkenin tamamında çalışan tek bir evrensel eSIM. Seçilecek ülke başına paketler yok ve boyut ya da süre seçecek hiçbir şey yok.
• Megabayt başına, son kullanma yok. Bir bakiyeyi stablecoin ile fonlarsınız; veri, cihaz nerede olursa olsun yerel MB başına tarifeyle bakiyeden düşer; kullanılmayan bakiye sonsuza dek devrolur. Model, MB başına açıklandı yazısında derinlemesine ele alınıyor.
• Varsayılan olarak anonim. Ajanın başlamak için bir hesaba ya da token'a ihtiyacı yok. İlk kimlik doğrulamalı çağrı, otomatik olarak anonim bir Roamzy hesabı üretir. Kimlik, sonradan, isteğe bağlıdır.
• On iki araç. Okuma araçları (durum, katalog, ülke detayı, maliyet tahmini, eSIM'leriniz ve siparişleriniz) açıktır; satın alma aracı, parayı hareket ettiren tek araçtır ve aşağıda göreceğiniz harcama tavanlarıyla sınırlandırılmıştır.

Bağlantıdan çok "bağlantı neden bir ajanın satın alacağı doğal ilk şeydir" şeklindeki daha geniş argümanın peşindeyseniz, ajan tabanlı ticaret ve bağlantı ile başlayın, sonra buraya dönün.

Yol A — Uzak uç nokta, sıfır kurulum (yaklaşık 2 dakika)

Bu en hızlı yoldur ve hiçbir şey kurmayı gerektirmez. Claude.ai ile ve uzak (Streamable HTTP) MCP konuşan herhangi bir istemciyle çalışır.

1. İstemcinizin bağlayıcı ayarlarını açın. Claude.ai'de bu Settings → Connectors → Add custom connector'dır.
2. Uç nokta URL'sini yapıştırın: https://roamzy.io/mcp
3. Kaydedin. On iki Roamzy aracı görünür. Bağlandınız.

Kurulumun tamamı bu. Yapıştırılacak bir token ve indirilecek bir paket yok. Uç nokta, tasarım gereği anonim-önce'dir — asla bir 401 döndürmez, dolayısıyla bir istemci bir OAuth dansı olmadan bağlanır ve yepyeni bir anonim hesaba karşı hareket eder. (İsimli giriş isteyen istemciler için bir OAuth kimlik katmanı vardır, ama başlamak için ona ihtiyacınız yok.) Aşağıdaki beş dakikalık ödüle geçin.

Yol B — npm üzerinden yerel kurulum (yaklaşık 5 dakika)

Bunu masaüstü ve editör istemcileri için kullanın: Claude Desktop, Cursor, Continue, Cline, Windsurf, Zed ya da stdio üzerinden yerel bir MCP sunucusu çalıştıran başka herhangi bir şey.

İstemcinizin MCP yapılandırma dosyasına tek bir blok ekleyin — macOS'ta Claude Desktop için bu ~/Library/Application Support/Claude/claude_desktop_config.json'dır:

{
  "mcpServers": {
    "roamzy": {
      "command": "npx",
      "args": ["-y", "@roamzy/mcp-server"]
    }
  }
}

Bir ortam bloğu gerekmez — ROAMZY_API_TOKEN'ı ayarlanmamış bırakmak, sunucuyu anonim moda sokan şeydir. Zaten başka MCP sunucuları çalıştırıyorsanız, dosyanın üzerine yazmak yerine roamzy anahtarını mevcut mcpServers nesnenizle birleştirin. Ardından istemciyi tamamen yeniden başlatın (Claude Desktop'ta yalnızca pencereyi değil, Cmd-Q ile çıkın). İlk kimlik doğrulamalı araç çağrısı anonim hesabınızı üretir.

Anonim akış için hiçbiri gerekli olmayan üç isteğe bağlı ortam değişkeni vardır:

• ROAMZY_API_TOKEN — anonim bir hesap yerine isimli bir hesap olarak hareket etmek için bunu panonuzdaki bir token'a ayarlayın.
• ROAMZY_ENABLE_PURCHASE — isimli bir token için varsayılan olarak false'tur (siz katılana kadar salt-okunur), ancak anonim modda otomatik olarak açıktır. İsimli bir token ile, bunu true'ya ayarlayana kadar satın alma aracı gizli kalır — bir yapılandırma yazım hatasının para harcamasına karşı derinlemesine savunma.
• ROAMZY_API_BASE — staging ya da kendi barındırdığınız arka uçlar için API tabanını geçersiz kılın.

Beş dakikalık ödül: ona satın almasını söyleyin

Örnek konuşmadan önce, insanların ayağını kaydıran bir zihinsel model. Roamzy megabayt başına faturalandırılan tek bir küresel eSIM olduğu için, ajana söylememeniz gereken iki şey var ve iyi davranan bir ajan bunları sizden istemeyecek:

• Bir ülke değil. eSIM her yerde çalışır; "bir Japonya eSIM'i" satın almazsınız.
• Bir veri miktarı değil. Boyutlandırılacak bir paket yok. Gigabayt satın almıyorsunuz; bir bakiye fonluyorsunuz.

Ajanın sizden gerçekten ihtiyaç duyduğu şey bir yükleme tutarı (minimum 20 $ USDT) ve hangi stablecoin ve ağ ile ödemek istediğinizdir. İşte akış baştan sona:

Siz: Önümüzdeki hafta Tayland'a gidiyorum — beni veriyle ayarla.

Ajan: Roamzy, 193 ülkede çalışan, yerel tarifeyle MB başına faturalandırılan tek bir evrensel eSIM'dir — paket yok, son kullanma yok. Ne kadar yüklemek istersiniz? Minimum 20 $ USDT. Ve hangi stablecoin ve ağ ile ödemek istersiniz — örneğin TRON, BSC ya da TON üzerinde USDT, veya Solana üzerinde USDC?

Siz: 20 $, Solana üzerinde USDC.

Ajan: Tamam. eSIM numaranız 2040XXXXXX. Buradan ödeyin: [ödeme bağlantısı]. Bu eSIM'e başka bir sohbetten ulaşabilmek için bu kurtarma bağlantısını saklayın: [talep bağlantısı]. Ödeme onaylanır onaylanmaz QR'ınızı getireceğim.

Kapakların altında, araç araç ne oldu:

1. roamzy_status — hızlı bir canlılık ve politika kontrolü (hizmet ayakta mı, satın almalar etkin mi).
2. roamzy_estimate(country_slug, mb_estimated) — isteğe bağlı, yalnızca "X ne tutar" diye sorduysanız. Bu bir referans hesaplamasıdır, bir satın alma girdisi değil; hiçbir şeyi taahhüt etmez.
3. roamzy_payment_options — stablecoin'lerin ve ağların canlı listesini çeker, böylece ajan tahmin etmek yerine size gerçek seçenekler sunar. Bu adım bir satın alımdan önce zorunludur: sizin yerinize bir ağ seçmek, ödemeyi tutmuyor olabileceğiniz bir zincire kilitlerdi.
4. roamzy_create_order(amount_usdt, pay_currency, country_slug) — eSIM'i ve faturayı üretir. Buradaki country_slug yalnızca bir fatura etiketidir (düşük tarifeli bir referansa varsayılan olur); eSIM'in nerede çalıştığını kısıtlamaz. Telefon numaranızı (MSISDN), bir ödeme URL'sini ve — anonim modda — bir talep URL'sini döndürür.
5. roamzy_order_status(order_id) — USDT ödemesi onaylanana kadar yoklanır, ağa bağlı olarak tipik olarak bir ile on beş dakika arası.
6. roamzy_get_esim(esim_id) — ödeme yapıldığında etkinleştirme yüzeylerini döndürür: sohbette render edilecek bir QR görüntüsü, ham QR yükü ve ajan ile telefon aynı cihaz olduğunda işe yarayan tek dokunuşluk bir kurulum bağlantısı.

Hiçbir şey yapılandırmadan elde ettiğiniz güvenlik sınırları

Otonomi yalnızca sınırlıysa makuldür, dolayısıyla sınırlar varsayılan olarak açıktır. Her ajan token'ı — sizin için oluşturulan anonim olan dahil — şunları taşır:

• Harcama tavanları. Bir anonim oturum günde 30 $, ayda 100 $, yepyeni bir token'da 30 $'lık bir bekleme süresi tavanı, tek aktif eSIM ve 50 $'ı aşan her işlemin insan onayı için geri gönderilmesiyle tutulur. İsimli (talep edilmiş) bir hesap günde 50 $, ayda 500 $, 50 $ bekleme süresi, 200 $'lık bir büyük işlem kapısı ve beşe kadar eSIM alır.
• Ajanın görebildiği bir bütçe. Kalan limitler her çağrıda geri gelir, böylece ajan bir tavana çarparak keşfetmek yerine elinde ne kaldığı üzerinde akıl yürütür.
• Kill switch'ler. Üç bağımsız tane — tek bir token'ı iptal et, tek bir hesabın ajan erişimini engelle, ya da tüm ajan satın almasını küresel olarak duraklat — mevcut durumu roamzy_status'ta okunabilir.

Bunların hiçbirini açmazsınız. Varsayılan budur ve daha derin tasarım gerekçesi geliştirici kılavuzundadır.

Anonimden isimli bir hesaba yükseltme

Anonim bir eSIM tam olarak çalışır — yüklenebilir ve süresiz olarak kullanılabilir. Onu gerçek bir kimliğe bağlamak istediğinizde (tavanları yükseltmek, bir tarayıcıda yönetmek ya da yalnızca kaydedilmiş bir bağlantıya bağımlı olmamak için), onu talep edin. Talep bağlantısını açın, Google ya da Telegram ile giriş yapın ve tek seferlik kodu girin; eSIM ve bakiyesi isimli hesabınıza taşınır. Bu tamamen isteğe bağlıdır ve satın alımdan sonra gerçekleşir, asla ondan önce değil. USDT ya da USDC ile ödenen bakiye, onu hangi hesabın tuttuğunu umursamaz.

Bir şey çalışmadığında

• Hiçbir Roamzy aracı görünmüyor. Neredeyse her zaman yapılandırmadaki bir JSON yazım hatası ya da eksik bir yeniden başlatma. JSON'ı doğrulayın ve Claude Desktop'ta pencereyi kapatmak yerine Cmd-Q ile tamamen çıkın.
• Ajan okuyabiliyor ama satın alamıyor. Anonim mod satın alma aracını otomatik olarak açığa çıkarır. İsimli bir token ile hem token üzerinde satın alma kapsamına hem de true'ya ayarlanmış ROAMZY_ENABLE_PURCHASE'a ihtiyacınız vardır.
• Ajan "hangi ülke?" diye soruyor. Bu, daha önce bahsedilen anti-pattern'dir — eSIM küreseldir. Doğru bir ajan yalnızca bir yükleme tutarı ve bir ödeme yöntemi ister. Sizinki bir ülkede ısrar ediyorsa, burada geçerli olmayan bir paket modelinden akıl yürütüyordur.
• Ödeme takılmış gibi görünüyor. USDT ve USDC onayları ağa bağlı olarak kabaca bir ile on beş dakika arası sürer; ajan başarısızlık varsaymak yerine roamzy_order_status'u yoklamalıdır.

Sonra nereye

Artık bağlantı satın alabilen bir ajanınız var. MCP sunucusunun arkasındaki mimari ve API tasarım tercihleri için geliştirici kılavuzunu okuyun. Bunun yerleşik tüketici pazaryeriyle nasıl kıyaslandığı için, Roamzy vs Airalo karşılaştırması her birinin nerede kazandığı konusunda açık sözlüdür. Tüm ajan yüzeyinin tek sayfalık genel bakışı agents.html'de yaşar, REST API /api/v1/docs'ta belgelenmiştir ve motorlar için yazılmış uzun biçimli rehberlik /llms-full.txt'tedir. Takılırsanız, destek botu @roamzy_support_bot'tur.