Yapay Zekâ Ajanları için Kipra
Claude, ChatGPT veya MCP konuşan herhangi bir ajan, Kipra Rent A Car’ın canlı müsaitlik, fiyat ve şirket bilgilerine doğrudan erişebilir — insanların rezervasyon akışında gördüğü aynı veri, aynı kurallar, aynı fiyat motoru.
Kısaca
Kipra Rent A Car (Gazimağusa / Mağusa, Kuzey Kıbrıs) yapay zekâ ajanları için herkese açık, salt okunur bir MCP sunucusu çalıştırır: mcp.kiprarent.com. Ajanlar canlı araç müsaitliğini, sigorta ve KDV dahil toplam fiyatları ve şirket kurallarını sorgular; rezervasyonun kendisi her zaman web sitesinde bir insan tarafından tamamlanır. Sunucu resmî MCP Registry’de kayıtlıdır ve anonim bir A2A uç noktası da sunar.
Bağlanma
MCP uç noktası Streamable HTTP konuşur ve tek adreste yaşar:
https://mcp.kiprarent.com/mcp- Claude’a eklemek için: Settings → Connectors → "Add custom connector" adımında adres olarak MCP uç noktasını girin. Yetkilendirme OAuth 2.1 ile çalışır (RFC 7591 dinamik istemci kaydı — elle kayıt yok); onay tek insan tıklamasıdır.
- MCP konuşmayan ajanlar için aşağıdaki düz HTTP uç noktaları aynı veriyi döner.
Sunucu resmî MCP Registry’de kayıtlıdır: com.kiprarent/kipra-rent-a-car (alan adı sahipliği DNS ile doğrulanmış). registry.modelcontextprotocol.io
A2A protokolü 1.0 konuşan ajanlar için anonim bir uç nokta da vardır: https://mcp.kiprarent.com/a2a (JSON-RPC SendMessage; aynı altı yetenek, kimlik doğrulama gerekmez).
Altı araç
Hepsi salt okunur — hiçbir araç rezervasyon oluşturamaz, değiştiremez veya iptal edemez. Ajan veriyi alır; insan rezervasyonu yapar.
| Araç | Ne yapar |
|---|---|
check_car_availability | Verilen alış/iade aralığında gerçekten müsait araçları, sigorta ve KDV dahil toplam fiyatlarla ve önceden doldurulmuş bir rezervasyon bağlantısıyla döner. Veri rezervasyon motorundan canlıdır — asla önbellekten veya tahminden gelmez. |
list_prices | Tarih gerektirmeyen güncel fiyat listesi: kategori ve kiralama süresi kademesine göre günlük fiyatlar (1 gün / 2 gün / 3–29 gün / 30+ gün), ek hizmetler ve tek seferlik lokasyon ücretleri. |
next_available | İstenen gün sayısı için bir aracın boş olduğu en yakın kiralama penceresini bulur (duration_days zorunludur — ajan sormadan tahmin etmez). |
company_info | Şirket bilgi tabanı: çalışma saatleri, depozito, sürücü yaşı kuralları, sınır geçiş kuralı, transferler, ödeme. Ajanlar yalnızca dönen metinden yanıt verir. |
get_fx_rates | Rezervasyon motorunun kullandığı EUR bazlı güncel döviz kurları (TRY, USD, GBP). Ajanlar kuru kendileri çevirmez — siteyle aynı kur kullanılır. |
get_booking_link | Tarih, dil ve para birimiyle önceden doldurulmuş bir rezervasyon adresi üretir; ajan bunu insana verir, insan tek tıkla devam eder. |
Veri kuralları
- Tarih-saatler Kıbrıs yerel saatidir (Europe/Nicosia), biçim YYYY-MM-DDTHH:mm.
- Fiyatlar tam euro döner; istenirse *_quoted alanlarında TRY/USD/GBP karşılıkları, kur ve kur tarihi eklenir.
- Olumsuz iş yanıtları ("o hafta boş araç yok") veridir, hata değildir.
- Sonuç etiketleri language parametresiyle Türkçe veya İngilizce istenebilir.
Düz HTTP uç noktaları
MCP araçlarının arkasındaki herkese açık, kimlik doğrulamasız GET uç noktaları — MCP konuşmayan ajanlar bunları doğrudan kullanabilir:
GET https://app.kiprarent.com/api/public/availability— Müsaitlik + fiyat teklifi (dikkat: tutarlar kuruş/cent cinsindendir)GET https://app.kiprarent.com/api/public/prices— Fiyat listesi (tam euro)GET https://app.kiprarent.com/api/public/next-available— En yakın boş pencere (tam euro)GET https://app.kiprarent.com/api/public/company-info— Şirket bilgi tabanı
- Kural retleri HTTP 200 {ok:false, error:<kod>} döner; yalnızca bozuk istekler 400 alır.
- Hız sınırı: prices / next-available / company-info için IP başına dakikada 60 istek (ortak havuz).
- robots.txt /api/public/ yolunu açıkça izinler — tarama bilinçli olarak serbesttir.
Keşif dosyaları
Ajan araç setleri ve tarayıcılar için yayınlanan makine okunur yüzeyin tamamı:
- llms.txt — kompakt site indeksi
- llms-full.txt — tam içerik dökümü
- MCP server card — sunucu tanımı (SEP-1649)
- A2A agent card — desteklenen arayüzler ve yetenekler
- auth.md — OAuth 2.1 kayıt ve yetkilendirme rehberi
- API catalog — RFC 9727 linkset
- Agent skills — Agent Skills Discovery indeksi
Güven modeli
- Salt okunur: hiçbir araç veri yazamaz, rezervasyon oluşturamaz veya iptal edemez.
- Canlı veri: fiyatlar asla önbellekten dönmez; insanların gördüğü fiyatın aynısıdır.
- Rezervasyonu insan tamamlar: ajan yalnızca önceden doldurulmuş bir bağlantı verir. Kredi kartı ve depozito gerekmez.
- Ajanlar hiçbir ödeme verisine dokunmaz — üründe çevrim içi ödeme yoktur (ödeme ofiste nakit veya kartla yapılır).
- Sayfaların .md aynaları ve Accept: text/markdown içerik pazarlığı sayesinde ajanlar HTML yerine temiz Markdown alır.
Müşteriler için: Kipra Asistan
İnsan müşteriler için aynı verinin üzerinde çalışan bir yapay zekâ asistanı da var: rezervasyon akışındaki "Kipra"ya sorun (app.kiprarent.com/book/assistant) veya Telegram’da @kiprarent_bot ile yazılı ya da sesli konuşun. Asistan fiyatları EUR/TRY/USD/GBP olarak verir ve tarihleri asla tahmin etmez — bilmediğinde sorar.
Sık sorulanlar
Bir yapay zekâ ajanı rezervasyonu tamamlayabilir mi?
Hayır — tasarım gereği. Ajanlar müsaitliği ve fiyatları sorgular, sonra önceden doldurulmuş bir rezervasyon bağlantısı verir. Rezervasyonu web sitesinde insan tamamlar; kredi kartı ve depozito gerekmez.
Veri gerçekten canlı mı?
Evet. Her yanıt, insanların kullandığı rezervasyon motorundan gerçek zamanlı gelir — aynı fiyat motoru, aynı kurallar. Hiçbir fiyat önbellekten veya modelin belleğinden dönmez.
Kipra’yı Claude’a nasıl eklerim?
Settings → Connectors → "Add custom connector" adımında https://mcp.kiprarent.com/mcp adresini girin. Yetkilendirme OAuth ile otomatik ilerler; onay tek tıktır.
Hangi diller ve para birimleri destekleniyor?
Sonuç etiketleri Türkçe veya İngilizce istenebilir. Fiyatlar tam euro döner; TRY, USD ve GBP karşılıkları sitenin kullandığı kurla birlikte verilir.