MODEL CONTEXT PROTOCOL & AI AGENT ECOSYSTEM

AI Ajanları İçin
Geçici E-posta ve Doğrulama Testi

İnsanlar ve AI ajanları, yetkili geliştirme ve QA akışlarında kısa ömürlü e-posta kutusu oluşturup gelen iletileri ve doğrulama kodlarını erişim tokenıyla okuyabilir. Hizmet ücretsizdir; üçüncü taraf doğrulamalarını aşmaz ve dış göndericilerden teslimatı garanti etmez.

AI AJANLARI İÇİN BAĞLANTI NOKTALARIÜCRETSİZ HİZMET
Test akışında kontrol edilmesi gerekenler
  • •Kutu adresini uygulamaya verin; erişim tokenunu paylaşmayın veya loglamayın.
  • •Teslim edilen mesajı test koşusuyla eşleştirin; boş sonucu başarı saymayın.
  • •Bekleme için son süre belirleyin; hata ve zaman aşımını ayrı değerlendirin.
✅ gecici.email Agent-Native Mimarisi
  • MCP ve REST ile token korumalı geçici test kutuları.
  • Mesaj geldiyse OTP ve doğrulama bağlantılarını kurallarla ayıklar.
  • Python, TypeScript ve MCP istemcileri için entegrasyon örnekleri vardır.

Model Context Protocol (MCP) Kurulumu

Uzak MCP destekleyen istemciler için canlı sunucu adresi

Claude’da özel bağlayıcı olarak https://gecici.email/mcp adresini ekleyin. Diğer istemcilerde uzak Streamable HTTP MCP sunucusu olarak aynı URL’yi kullanın; kaynak kodu veya npm paketi gerekmez.

MCP URL: https://gecici.email/mcp
REST API: https://gecici.email/api/v1
Akış: kutu oluştur → adresi kullan → token ile iletileri/OTP'yi oku
Kullanım: yalnızca kendi yetkili test ve geliştirme akışlarınızda

Ajanınızın Çağırabileceği Hazır MCP Araçları:

gecici_create_inbox()

Adres, erişim tokenu ve bitiş zamanı döner.

gecici_wait_for_otp()

Desteklenen biçimde kod bulunmasını sınırlı süre bekler; zaman aşımı dönebilir.

gecici_wait_for_magic_link()

Sınırlı süre bağlantı bekler; bulunan URL’yi döner, bağlantıyı açmaz.

gecici_get_ai_summary()

Son mesajın kurallarla çıkarılmış özet alanlarını döner; LLM üretimi değildir.

TEST EDİLEN REHBER ·

browser-use ile geçici e-posta ve doğrulama kodu testi

Kendi uygulamanızdaki e-posta doğrulamasını test eden bir ajan, önce kutu oluşturmalı, sonra gelen kodu okumalı ve işi bitince kutuyu silmeli. Bu örnekte üç işlem browser-use araçları olarak kaydedilir. Kutu erişim tokenı Python yardımcısında kalır; ajana yalnızca formda kullanacağı adres ve okunan kod döner.

Aşağıdaki kontrol gerçek araç çağrılarını canlı API üzerinde çalıştırır. Örnek mesaj simülasyon uç noktasından eklenir. Tarayıcı, dil modeli veya dış posta göndericisi çalıştırılmaz; sonuç bir web sitesindeki üyeliğin tamamlandığı anlamına gelmez.

1. Test edilen sürümü kurun

Python 3.11 veya üzeri gerekir. Bu komutları yeni bir klasörde çalıştırın. Kontrol için model anahtarı ve ayrı bir gecici-email Python paketi gerekmez.

git clone https://github.com/codeonthetable/gecici-email.git
cd gecici-email
git checkout 4951b8f041b8ebe9b98282dacbc4c2d262b711b5
python3 -m venv .venv
source .venv/bin/activate
python -m pip install 'browser-use==0.13.11'
python -m unittest discover -s tests -v
python examples/browser_use_inbox.py --qa-run

Windows’ta ortamı .venv\Scripts\activate ile açın. Sabitlenen Git sürümü, aşağıdaki sonuçları aldığımız kodu indirir. Çalıştırmadan önce örnek kodu inceleyin.

2. Başarılı kontrol neyi gösterir?

Python 3.12.14 ve browser-use 0.13.11 ile 16 yerel test geçti; ayrı ve isteğe bağlı canlı MCP testi atlandı. Canlı API kontrolünde aşağıdaki alanlar doğru döndü. Çıktıda adres, token, mesaj veya kod yazdırılmaz.

create_action_passed: true
Araç çağrısı yeni bir geçici kutu oluşturdu.
token_not_returned: true
Erişim tokenı oluşturma aracının yanıtına eklenmedi.
otp_action_matched: true
Okunan kod, eklediğimiz temsili test mesajıyla eşleşti.
cleanup: true
Test sonunda geçici kutu silindi.

İstekler qa-test olarak işaretlenir. Bu deneme normal kullanıcı veya başarılı AI kullanımı sayılmaz. Boş kutu ve süre aşımı da başarılı doğrulama değildir.

3. Kendi uygulamanızın akışına bağlayın

  1. Her test koşusu için yeni bir InboxTools(qa=True) oluşturun ve register(Tools()) ile araçları mevcut ajanınıza ekleyin.
  2. Ajanınız gecici_create_inbox aracından aldığı adresi sizin test formunuza girsin. Erişim tokenını forma göndermeyin.
  3. Uygulamanız mesajı gönderdikten sonra gecici_wait_for_otp ile 1–45 saniye bekleyin. Kod geldiğinde formu doldurun ve uygulamanın açık başarı durumunu kontrol edin.
  4. gecici_delete_inbox ile kutuyu silin; hata durumları için çalıştırıcınızın finally bölümünde de await inbox.close() kullanın.

Bu uyarlama için kendi test uygulamanızın gerçek adresi, tarayıcı kurulumu ve yapılandırılmış modeliniz gerekir. Model ve form içeren uçtan uca akış bu rehberde test edilmedi. Adres ve kod model tarafından görülebileceği için temsili test verisi kullanın ve ajan geçmişi ayarlarınızı gözden geçirin.

Ajanınıza ekleme kodu ve test ayrıntıları →

Gerçek bir tarayıcı formunda e-posta doğrulama testi: çalıştırılabilir Python uygulaması →

Kod gelmezse hangi adımı kontrol etmelisiniz?

SonuçSonraki kontrol
Süre dolduUygulamanızın gönderim sonucunu ve teslim gecikmesini kontrol edin. Kod gelmeden form doğrulamasını başarılı saymayın.
Kutu işlemi başarısızBağlantıyı, kutunun süresini ve parametreleri kontrol edin. Yeni koşu için yeni yardımcı oluşturun.
Silme başarısızAynı yardımcıyla await inbox.close() işlemini tekrar deneyin; başarısız silmede token tekrar denemek için bellekte tutulur.

Araç tanımları browser-use özel araç API’sini kullanır. Bu örnek gecici.email deposunda yayımlanmıştır; browser-use projesinin resmî entegrasyonu veya kabul edilmiş katkısı olarak sunulmaz.

REST ve MCP API rehberi · English tutorial

Kendi Ajanınızdan REST ile Kullanım

Uzak MCP desteklemeyen istemciler standart HTTPS API’sini kullanabilir. Kutu oluşturma yanıtındaki tokenı saklayın; yalnızca adresi yetkili uygulamaya verin. Kod veya bağlantı henüz gelmediyse başarı varsaymayın.

curl -sS -X POST https://gecici.email/api/v1/inbox/generate
# Yanıttaki address ve token değerlerini güvenli şekilde saklayın.
curl -sS -H 'Authorization: Bearer <token>' \
  'https://gecici.email/api/v1/inbox/<address>/messages'

İstek/yanıt biçimleri ve saklama sınırları: API kılavuzu ve gizlilik sayfası.