Uygulamanızın kodunuzla belirlenen sorguları başlatması gereken durumlarda API seçin. Uyumlu bir asistanın bir konuşmada araçları keşfedip kullanmasını istediğinizde MCP seçin. Mobilite verileri için her iki yaklaşım aynı ürün içinde bir arada bulunabilir.
Karar, hizmete erişim şekli üzerinedir; güvenilir veriler ile yaklaşık veriler arasında bir karşıtlık değildir. Bir API ve bir MCP sunucusu aynı kaynaklara dayanabilir; sözleşmelerini, yeteneklerini ve gerçek sınırlarını karşılaştırmak gerekir.
API: Çağrılar sizin kodunuz tarafından belirlenir
Bir HTTP API'si, sunucunuzun rotayı, parametreleri, arama zamanlarını ve yanıtların işlenmesini seçmesine olanak verir. Bu, durak listesi, harita filtresi veya öngörülebilir davranış gerektiren planlı bir görev gibi durumlar için uygun bir yaklaşımdır.
Uygulamanız doğrulama, önbellek, zaman aşımı, hata gösterimi ve gizli bilgilerin yönetimini üstlenir. API, bir asistana engel değildir: ayrıca bu rotalar model tarafından kullanılan fonksiyonlara bağlanabilir.
ROOTE API ile yakınlık araması örneği
MCP: Konuşma içinde erişilebilir araçlar
Bir MCP sunucusu araçları ve bunların argüman şemalarını yayımlar. AI uygulaması bunları keşfeder ve doğal dilde gelen isteğe cevap için kullanabilir. Bu, her müşteri için ayrı bir entegrasyon yapmadan uyumlu müşterilere kolay bağlantı sağlar.
Model parametre icadı yapmaya ya da hatayı boş sonuç olarak yorumlamaya yetkili değildir. İstemci ve uygulamanız hizmet kısıtlamalarını korumalıdır. Keşfedilen yetenekler referans olarak kalır.
Elde etmek istediğiniz sonuca göre seçim yapın
| Proje | Başlangıç tercihi | Neden |
|---|---|---|
| Bir sitede durak listesi | API | Kod filtreleri, çağrıları ve sunumu kontrol eder |
| Adres etrafında arama yapan uyumlu asistan | MCP | Araçlar konuşmadan erişilebilir |
| Dönemsel dışa aktarım veya iş süreci | API | Senaryo konuşmaya bağlı yorumlama gerektirmez |
| Geliştirilecek arayüzü olmayan harita | ROOTE embed (gömme) | Iframe doğrudan harita deneyimi sağlar |
| Harita ve asistanı birleştiren ürün | API ve MCP | Her arayüz farklı bir etkileşim türüne yanıt verir |
Sadece arayüzleri değil, kapasiteyi karşılaştırın
MCP ROOTE’nun Veri araçları geokodlama, yakın arama ve transit_disruptions ile kesintileri kapsar. Journey ve Departures henüz sunulmamaktadır, REST sözleşmesi ilgili yolları belgelemekte olsa da. transit_nearby ulaşım yerlerini keşfeder; onların yakındaki kalkışlarını duyurmaz. Sunucunun gerçek duyurulan araçları ile karşılaştırma yapın.
Filtre isimleri, tipler ve sınırlar da değişkenlik gösterebilir. Mesela MCP transit modları bir dizi string iken; harita URL'sindeki modlar parametre içinde kodlanır. Arayüzler arasında bir konfigürasyonu kopyalarken şemasını kontrol edin.
Entegrasyon yükünü değerlendirmek
API için yanıt doğrulama, hata yönetimi ve sunum iş yükünü tahmin edin. MCP için istemci uyumluluğu, araç keşfi, asistan davranışı ve uyarıların korunma şekli kontrol edin. Hızlı bir bağlantı yolak testinin yerini tutmaz.
Her iki durumda da gerçek yapılmış çağrıları ölçün ve hizmetin aktif limitlerini uygulayın. Araştırmalar, yeniden denemeler ve hesap hakları gözlemlenmeden sabit bir maliyetten bahsetmeyin.
Bir örnek: bir otel ziyaretçilerine hareket kolaylığı sağlıyor
Otel yakınındaki bisiklet ve durak haritasını göstermek için embed yeterli olabilir. Arayüzünde listeyi kişiselleştirmek için site sunucu tarafında API çağırabilir. "Adresim civarında tuvalet ve tramvay nerede?" sorusuna uyumlu asistan MCP'yi kullanarak cevap verebilir.
Bu yolaklar birbirini gizlememeli: harita mevcut bilgileri gösterir, liste filtrelerini açar, asistan ise gerçekte bulduğu şeyleri açıklar. Bilinmeyen bir hizmet, alanı eksik diye yok olmaz.
Asistanınızı ROOTE MCP'ye bağlamak
Yakında: sonraki kalkışlar ve rota hesaplama
ROOTE, MCP’sini yaklaşan Departures ve yolculuk planlama ile genişletmeyi planlıyor. Bu özellikler henüz mevcut değildir ve MCP sunucusunun şu anda sunduğu araçların parçası değildir. Kullanıma açıldığında, geçiş veya yolculuk duyurmadan önce sunucunun açıkladığı araçları, argümanlarını ve döndürülen bilgileri kontrol edin.
Sıkça Sorulan Sorular
MCP, REST’in yerine geçer mi?
Hayır. MCP arka planda bir REST API kullanabilir ve uygulama REST entegrasyonunu paralel tutabilir.
Otomasyon MCP üzerinden mi yapılmalı?
Zorunlu değil. Tanımlı ve tekrarlanabilir çağrı dizileri için genellikle API yeterlidir. Ancak otomasyon ortamınız zaten MCP kullanıyorsa veya bir asistan araç seçiyorsa MCP faydalı olur.
Tüm işlevler her yerde mevcut mu?
Her arayüzün envanterini kontrol edin. REST, MCP ve harita yetenekleri otomatik olarak aynı değildir.