Aracılı (agent) ticaretin en zor yanı, çoğu ürünün hiçbir zaman agent'lar için tasarlanmamış olmasıdır. Kayıtlı kart akışları, bir insanın fatura ekranına gözlerini kısarak baktığını varsayar. eSIM uygulamaları, QR kodu taramaya hazır kameralı bir telefon varsayar. Stripe ise bir oturum çerezine bağlı bir ödeme sayfası varsayar; bunu da bir MCP sunucusu sağlayamaz.
Roamzy, bu varsayımları ortadan kaldırmak için API katmanından aşağıya doğru yeniden inşa edildi. Sonuç, Claude Desktop'ın USDT ile küresel bir eSIM'i sorgulamasına, tahmin etmesine ve (sizin açık onayınızla) satın almasına olanak tanıyan beş dakikalık bir kurulum — ve sızdırılan bir token'ın yaratacağı zararın yarıçapını sınırlandıran açık bir güvenlik modeli.
Sonunda elinizde ne olacak
Bu eğitimin ardından:
- Sekiz Roamzy aracının kayıtlı olduğu Claude Desktop (katalog, ülke ayrıntısı, tahmin, durum; ayrıca kendi eSIM'leriniz ve siparişleriniz için kimlik doğrulamalı salt-okunur araçlar)
- Claude yapılandırmanızda, agent'ın sizin adınıza hareket etmesini sağlayan, varsayılan olarak salt-okunur kapsamla sınırlanmış bir API token'ı
- Hazır olduğunuzda tek bir env değişkenini değiştirerek satın almaları etkinleştirme imkânı
Toplam süre: yaklaşık 60 saniye kurulum ve Claude'a ilginç şeyler yaptırmak için 4 dakika.
1. Adım: Roamzy panelinde bir API token'ı oluşturun
Google veya Telegram ile roamzy.io/dashboard üzerinden oturum açın. Settings → API & Agents'ı açın. Create new token'a tıklayın.
Token'ın düz metni yalnızca bir kez görünür — onu hemen bir parola yöneticisine kopyalayın. Sunucu, bu ekran kapandıktan sonra düz metni asla saklamaz; doğrulama için bir SHA-256 özeti ve görüntüleme için 12 karakterlik bir önek ipucu (rk_live_abc1…) tutar.
İlk kurulumunuzda Allow purchases kutucuğunu işaretsiz bırakın. Salt-okunur token'lar USDT harcayamaz — yalnızca katalogları sorgulayabilir ve durumu kontrol edebilirler. Doğru varsayılan budur. İsterseniz daha sonra satın alma kapsamı etkin ikinci bir token oluşturabilirsiniz.
2. Adım: Claude Desktop yapılandırma dosyanızı bulun
macOS'te: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows'ta: %APPDATA%\Claude\claude_desktop_config.json
Dosya henüz yoksa oluşturun. Düz bir JSON dosyasıdır.
3. Adım: Roamzy MCP sunucusunu ekleyin
{
"mcpServers": {
"roamzy": {
"command": "npx",
"args": ["-y", "https://roamzy.io/mcp/roamzy-mcp-latest.tgz"],
"env": {
"ROAMZY_API_TOKEN": "rk_live_xxx",
"ROAMZY_ENABLE_PURCHASE": "false"
}
}
}
}
rk_live_xxx yerine gerçek token'ınızı yazın. npx komutu, tarball'ı doğrudan alan adımızdan indirir — GitHub veya NPM kimlik bilgilerine gerek yoktur.
Halihazırda başka MCP sunucularınız yapılandırılmışsa, tüm dosyayı değiştirmek yerine roamzy anahtarını mevcut mcpServers nesnenize ekleyin.
4. Adım: Claude Desktop'ı yeniden başlatın
Claude Desktop'tan tamamen çıkın (Mac'te yalnızca pencereyi kapatmak değil, Cmd-Q) ve yeniden açın. Açılışta Claude, yapılandırma dosyasını bir kez okur ve her MCP sunucusunu bir alt süreç olarak başlatır.
Roamzy araçlarının araçlar menüsünde (giriş alanının sağ alt köşesindeki küçük simge) belirdiğini görmelisiniz. On saniye içinde belirmezlerse, hatalar için Claude Desktop'ın günlüğünü kontrol edin — bu genellikle JSON yapılandırmasındaki bir yazım hatası ya da yanlış bir token'dır.
5. Adım: Claude'a ilginç bir şey sorun
Şu istemi deneyin:
Önümüzdeki hafta 10 günlük bir gezi için Tokyo'ya uçuyorum. Toplamda yaklaşık 2 GB kullanmayı beklersem, Roamzy üzerinden bir eSIM bana ne kadara mal olur?
Claude'un perde arkasında yaptıkları:
- Japonya'nın kapsamda olduğunu doğrulamak ve güncel MB başı ücreti almak için
roamzy_country_detail(country_slug="esim-japan")çağrısını yapar. - USDT maliyetini öngörmek için
roamzy_estimate(country_slug="esim-japan", mb_estimated=2048)çağrısını yapar. - Öngörülen maliyet ve asgari yükleme tutarıyla birlikte özlü bir yanıt döndürür.
Japonya'da, güncel MB başı $0.0033 ücretimizle 2 GB için öngörülen maliyet yaklaşık $7 USDT'dir. Roamzy'de asgari yükleme tutarı $20 olduğundan, Claude size güvende olmak için en az $20 yüklemenizi söyleyecektir.
Satın almaları etkinleştirme (hazır olduğunuzda)
Claude'un bir eSIM'i yalnızca tahmin etmesi yerine gerçekten satın alabilmesi için iki koşulun sağlanması gerekir:
- Token'ın satın alma kapsamı etkin olmalıdır. Token'ı panelde düzenleyin ya da iptal edip Allow purchases kutucuğu işaretli yeni bir tane oluşturun.
- MCP sunucusu yapılandırmasında
ROAMZY_ENABLE_PURCHASE: "true"bulunmalıdır. Bu, token kapsamından ayrı bir bayraktır — satın alma etkin bir token'la bile, bu env değişkeni ayarlanmadıkça MCP sunucusu satın alma araçlarını açığa çıkarmaz. Yapılandırma yazım hatalarına karşı derinlemesine savunma.
Her ikisi de sağlandığında Claude Desktop'ı yeniden başlatın ve şunu deneyin:
Tokyo gezisi için bana $20 yüklemeli bir Roamzy eSIM satın al.
Claude, token'ın günlük bütçesinden (varsayılan $50) harcama yapan roamzy_create_order çağrısını yapacaktır. API bir USDT ödeme URL'si döndürür — Claude bunu sizinle paylaşır, siz cüzdanınızdan ödersiniz, webhook onaylar ve ardından Claude, sohbette göstermek için QR görüntü URL'sini getirebilir. Telefon kameranızla tarayın, eSIM kurulur.
Tek paragrafta güvenlik modeli
Beş katman sizi başıboş bir agent'tan korur. Token başına günlük ve aylık harcama sınırları (varsayılan $50/gün, $500/ay; $1000/$10000'a kadar yapılandırılabilir). Her yeni token için, yükseltilemeyen, toplam $50 harcamalık 7 günlük bir bekleme süresi. Büyük işlem onayı: $200 USDT üzerindeki her şey API düzeyinde engellenir ve panelden onaylamanızı gerektirir. Satın alma kapsamı, token başına tercihe bağlıdır. Ve üç bağımsız acil durdurma düğmesi vardır: token başına iptal, kullanıcı başına agent engelleme ve genel agent duraklatma; durum /api/v1/status adresinde görünür.
Daha ayrıntılı bilgi için /llms-full.txt sayfasına bakın — özellikle AI agent'ları ve motorları için yayımladığımız uzun biçimli rehber.
Diğer AI istemcileri ne olacak?
Cursor, Continue, Cline, Windsurf ve diğer tüm MCP uyumlu istemciler aynı yapılandırma bloğunu kullanır — yalnızca onu ilgili yapılandırma dosyasına koyun. MCP olmayan istemciler için (LangChain, OpenAI function calling, n8n, özel Python betikleri), REST API'yi doğrudan /api/v1/docs adresinden çağırın. Aynı token, aynı güvenlik modeli.
Eğitimin tamamı bu kadar. Takılırsanız, Roamzy Telegram destek botu @roamzy_support_bot adresindedir.