MCP ROOTE’ye bir IA asistanı bağlamak için, MCP Streamable HTTP ile uyumlu bir uygulamada uzak sunucu olarak https://mcp.roote.ai/mcp adresini ekleyin. Sunucu, adresler, hareketlilikler ve yakın hizmetler için okuma araçları sunar.
Bu eğitim, ROOTE tarafından yayınlanan yapılandırmayı ve sunucu bağlantısının doğrulanmasını takip eder. Menü başlıkları müşteriye göre değişir; URL, taşıma yöntemi ve araç şemaları kontrol edilecek unsurlardır. Sunucunun tools/list listesi dokümantasyondan önce değişebilir: gerçek duyurulan kapasiteyi kullanın.
İstemci uyumluluğunu doğrulayın
Uygulamanız, uzak bir MCP sunucusunu Streamable HTTP olarak kabul etmelidir. Sadece yerel stdio sunucularına izin veren bir istemci, bu URL’yi çalıştırılabilir komut olarak kullanamaz. Ayrıca hesabınızın özel sunucu eklemeye izin verip vermediğini kontrol edin.
Uygulama bir form sunuyorsa, ROOTE’yi isim ve sunucu URL’sini adres olarak girin. mcpServers formatında dosya kabul ediyorsa, ROOTE dokümantasyonu şu asgari yapılandırmayı önerir:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}ROOTE bağlantısı için resmi yapılandırma
Anonim veya doğrulanmış erişim seçimi
Dokümantasyon, Authorization başlıksız anonim erişim öngörür; Free projeksiyonu ve API aktif sınırlarına tabidir. Doğrulanmış erişim için, istemcinin güvenli mekanizmasını kullanarak Bearer başlığında jetonunuzu iletin.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN, istemcinin güvenli yapılandırmasında değiştirilecek yere işaret eder. Jetonu bir konuşmaya, genel URL'ye veya makaleye yapıştırmayın. Geçersiz veya iptal edilmiş jeton anonim erişimle otomatik değiştirilmeyecektir.
Araçların kullanılabilirliğini doğrulayın
Bağlandıktan sonra istemcinizde sunucu araç listesini açın. ROOTE dokümantasyonu initialize, tools/list ve tools/call dizisini açıklar; uyumlu istemciler bu trafiği otomatik yapar. Sunucu tarafından bildirilen sürüm ve yetenekleri kullanın.
Sunucu geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions ve services_nearby araçlarını sunar. Bu araçların olmaması bağlantı, keşif sorunu veya hizmet evrimi anlamına gelir. Her zaman sunucunun duyurduğu listeyi kontrol edin. Journey ve Departures henüz sunulmamaktadır.
Tekrarlanabilir ilk arama yapın
Öncelikle açık bir adres belirtin: “ROOTE kullanarak 10 rue de Rivoli, Paris, Fransa adresini ara. Bulunan adayları ve koordinatlarını belirt.” Modelin sunduğu yanıt değil, aracın sonucunu inceleyin.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Bu blok çağrı adı ve argümanlarını gösterir; tam bir HTTP isteği değildir. İstemciniz MCP çağrısını kapsüller. Birden çok olası aday gelirse, nokta etrafı aramadan önce doğruyu seçin.
Sonra Bordeaux referans noktası etrafında taşıma işlevini test edebilirsiniz. Aşağıdaki koordinatlar test içindir ve önceki Paris adresinden geldiği iddia edilmez.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Sonuca ulaşmadan önce sonucu okuyun
Durumu, dönen varlıkları, kapsama alanını, uyarıları ve uygulanan sınırları kontrol edin. Kısmi yanıt faydalı bilgiler içerebilir. Boş arama, şehirde fiziksel taşıma olmadığı anlamına gelmez.
Testin beklenen sonucu yapılandırılmış yanıt ya da açık hata, önceden belirlenmiş durak sayısı değildir. Kaynaklar ve kapsama değişebilir. Durak araması sonraki kalkışları vermez.
Bağlantı hatalarını giderme
| Belirti | Yapılması gereken kontrol |
|---|---|
| Araç bulunamadı | Tam URL, uzak taşıma ve istemci yetkisi |
| Argüman hatası | İzin verilen türler, değerler ve şema alanları |
| Kimlik doğrulama hatası | Bearer geçerliliği ve başlık yapılandırması |
| Limit aşımı | Aktif sınırlar, yeniden deneme süresi ve çağrı frekansı |
| Boş veya kısmi sonuç | Koordinatlar, filtreler, yarıçap, kapsama ve uyarılar |
Boş sonucu API hatasından ayırma
Bir adresten eksiksiz asistan oluşturma
Bir MCP sunucusunun rolünü anlama
Yakında: sonraki kalkışlar ve yolculuk hesaplama
ROOTE, MCP’sini yaklaşan Departures ve yolculuk planlama ile genişletmeyi planlıyor. Bu özellikler henüz mevcut değil ve MCP sunucusunun şu anda sunduğu araçların parçası değil. 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
Jeton zorunlu mu?
Dokümantasyon anonim Free erişim sağlar. Erişim sınırları ve yetenekleri hizmet tarafından uygulanır.
Neden asistana durak araması sonrası saat bildiri yapıyor?
transit_nearby araması sonraki kalkışları vermez. Asistandan dönen gerçek verileri göstermesini ve bu eksikliği belirtmesini isteyin.
Uygulama oluşturmadan test yapılabilir mi?
Evet, uzak sunucu ekleyip araçları çalıştırabilen uyumlu istemcilerle.