MCP (Model Context Protocol), bir yapay zekâ asistanının bir hizmetin bilgisini standart bir yolla çağırmasını sağlar. MBD Travel MCP sunucusu, sitemizdeki herkese açık tur, otel, deneyim ve vize bilgisini asistanlara okutur. Asistanınız bir tur ararken ya da bir otelin fiyatını sorarken bu sunucuyu çağırır ve yanıtı size anlatır.
Sunucu yalnız okur. Rezervasyon yapmaz, oda tutmaz, ödeme almaz ve hesabınıza erişmez. Satın almak istediğinizde asistan sizi sitemizdeki ilgili sayfaya yönlendirir.
1. Bağlantı adresi
Herkese açık adres: https://mbdtravel.com/api/v1/mcp/public
Oturum açmak, jeton ya da API anahtarı kullanmak gerekmez. Taşıma biçimi Streamable HTTP; istekler POST ile gönderilir ve yanıt tek bir JSON gövdesidir. Olay akışı (SSE) sunulmaz.
ChatGPT ve Claude gibi istemcilerde bağlayıcı eklerken kimlik doğrulama olarak "yok" (No authentication / No sign in) seçin.
2. Araçlar
Sunucu on iki araç sunar. Hepsi salt okunurdur ve veri değiştirmez.
- search: kataloğun tamamında (tur, otel, deneyim, vize) serbest metinle arama.
- fetch: search sonucundaki bir kaydın ayrıntısı.
- search_tours: tur arama; ülke, şehir, azami fiyat ve tarih aralığı süzgeçleriyle.
- get_tour: bir turun programı, dahil ve hariç hizmetleri, iptal koşulu.
- get_departures: bir turun kalkış tarihleri ve fiyatları.
- compare_tours: birkaç turu yan yana karşılaştırma.
- find_last_minute_tours: yakın tarihli kalkışı olan turlar.
- browse_destinations: ülke ve şehirlere göz atma.
- list_hotels: otel listesi; ülke, şehir ve ada göre süzülür.
- quote_hotel_stay: tarih, kişi sayısı ve uyruk verilen bir konaklama için canlı otel fiyatı.
- search_transfers: özel araçlı transferler (Dubai ve İstanbul), araç başı sabit fiyatla; İstanbul için havalimanı ve otelin ilçesi ya da yakası.
- quote_transfer: bir transferin yolcu sayısına göre araç sayısı ve toplamı.
3. Örnek istekler
Asistana doğal dille yazarsınız; asistan uygun aracı kendisi seçer. Aşağıdaki örnekler işe yarar:
- "Mayıs ayında Japonya'da 10 güne kadar bir tur öner."
- "Dubai'de plaja yakın otelleri listele."
- "Şu iki turu yan yana karşılaştır."
- "Önümüzdeki iki hafta içinde kalkan turlar var mı?"
- "1-5 Kasım, iki yetişkin, Türkiye uyruklu için bu otelin fiyatı nedir?"
4. Doğrudan çağırmak isteyen geliştiriciler için
Araç listesini almak için:
curl -s -X POST ADRES -H "Content-Type: application/json" -H "Accept: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Bir araç çağırmak için:
curl -s -X POST ADRES -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_tours","arguments":{"query":"japonya"}}}'
ADRES yerine yukarıdaki bağlantı adresini yazın. Desteklenen protokol sürümleri 2025-11-25, 2025-06-18 ve 2025-03-26.
5. Sınırlar
Sunucu bilerek dardır. Şunlar bu uçtan yapılamaz ya da verilmez:
- Rezervasyon, oda tutma, ödeme, iptal ve değişiklik. Bunlar yalnız sitemizde yapılır.
- Kişisel veri. Sunucu ad, telefon, e-posta ya da pasaport bilgisi istemez ve almaz; hesabınıza ya da siparişlerinize erişmez.
- Kataloğun tamamı değil, yayındaki bir bölümü sunulur. Aktivite için araç yoktur; asistan sizi ilgili sayfaya yönlendirir. Bir ürünü bulamamak, ürünün olmadığı anlamına gelmez.
- Fiyatlar bilgilendirme amaçlıdır. Her fiyatın hangi koşulda geçerli olduğu yanında yazar. Kesin fiyat ve müsaitlik, satın alma sayfasında teyit edilir.
- Canlı otel fiyatı tedarikçiden anlık sorulur; tarih, kişi sayısı ve uyruk verilmeden fiyat dönmez.
6. Kullanım sınırı
Adil kullanım için sınırlar vardır: her IP adresi için dakikada 60 istek, canlı otel fiyatı için dakikada 4 istek; ayrıca bütün kullanıcılar için ortak bir genel sınır ve günlük canlı fiyat üst sınırı. Sınır aşılırsa sunucu 429 yanıtı ve Retry-After başlığıyla kaç saniye beklemeniz gerektiğini bildirir.
Otomatik toplu veri çekimi (kataloğun kopyalanması) bu ucun amacı değildir ve engellenebilir.
7. Gizlilik
Sunucu, asistanın gönderdiği arama metnini, tarihleri, kişi sayısını ve uyruk bilgisini yanıt üretmek için kullanır. Sunucu günlüğüne yalnız hangi aracın çağrıldığı, hangi alanların gönderildiği (alan adları; değerler değil), sonucun durumu ve süresi yazılır. Hız sınırı için IP adresiniz bellekte sayılır; web sunucusunun erişim kayıtlarında, sitemizin tamamında olduğu gibi, IP adresi bulunur.
Asistanınıza yazdıklarınız, kullandığınız asistanın (ChatGPT, Claude vb.) sağlayıcısına aittir ve onun gizlilik politikasına tabidir. Asistana kişisel veri yazmanız gerekmez.
MBD Travel gizlilik politikası: https://mbdtravel.com/tr/gizlilik
8. İletişim ve hata bildirimi
Soru, hata ve öneriler için iletişim sayfamızı kullanın: https://mbdtravel.com/tr/destek
E-posta: [email protected]
Güvenlik açığı bildirimi için /.well-known/security.txt dosyasındaki adreslere yazın.