Jak połączyć asystenta AI z MCP ROOTE?

Aby połączyć asystenta AI z MCP ROOTE, dodaj zdalny serwer https://mcp.roote.ai/mcp w aplikacji kompatybilnej z MCP Streamable HTTP. Serwer oferuje narzędzia do odczytu adresów, mobilności i usług w pobliżu.

Ten samouczek opiera się na konfiguracji opublikowanej przez ROOTE oraz weryfikacji połączenia z serwerem. Nazwy menu mogą się różnić w zależności od klienta; elementy do sprawdzenia to URL, transport i schemat narzędzi. Lista tools/list serwera może się zmieniać przed dokumentacją – korzystaj z faktycznie ogłaszanych możliwości.

Sprawdzenie kompatybilności klienta

Twoja aplikacja musi obsługiwać zdalny serwer MCP przez Streamable HTTP. Klient ograniczony do serwerów lokalnych stdio nie może użyć tego URL jako wykonywalnej komendy. Sprawdź również, czy Twoje konto umożliwia dodawanie serwerów niestandardowych.

Jeśli aplikacja oferuje formularz, wpisz ROOTE jako nazwę i URL serwera jako adres. Jeśli akceptuje plik w formacie mcpServers, dokumentacja ROOTE proponuje minimalną konfigurację:

{
  "mcpServers": {
    "roote": { "url": "https://mcp.roote.ai/mcp" }
  }
}

Oficjalna konfiguracja połączenia ROOTE

Wybór dostępu anonimowego lub uwierzytelnionego

Dokumentacja przewiduje dostęp anonimowy bez nagłówka Authorization, podlegający projekcji Free i aktywnym limitom API. Dla dostępu uwierzytelnionego użyj bezpiecznego mechanizmu klienta do przesłania tokena w nagłówku Bearer.

Authorization: Bearer YOUR_API_TOKEN

YOUR_API_TOKEN to miejsce do podmiany w bezpiecznej konfiguracji klienta. Nie wklejaj tokena w rozmowie, publicznym URL ani artykule. Nieważny lub unieważniony token nie jest automatycznie zastępowany dostępem anonimowym.

Potwierdzenie dostępności narzędzi

Po połączeniu otwórz listę narzędzi serwera w swoim kliencie. Dokumentacja ROOTE opisuje sekwencję initialize, tools/list, a potem tools/call; kompatybilni klienci wykonują te wymiany automatycznie. Użyj wersji i funkcji deklarowanych przez serwer.

Serwer udostępnia geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions oraz services_nearby. Brak tych narzędzi oznacza problem z połączeniem, odkrywaniem lub zmianę usługi. Zawsze sprawdzaj listę ogłaszaną przez serwer. Journey i Departures nie są jeszcze tam udostępniane.

Wykonanie pierwszego powtarzalnego wyszukiwania

Zacznij od dokładnego adresu: „Użyj ROOTE, by wyszukać 10 rue de Rivoli, Paryż, Francja. Podaj znalezionych kandydatów i ich współrzędne.” Sprawdź wynik narzędzia, nie tylko odpowiedź wygenerowaną przez model.

{
  "name": "geocode",
  "arguments": {
    "q": "10 rue de Rivoli, Paris",
    "language": "fr",
    "country": "FR"
  }
}

Ten blok ilustruje nazwę i argumenty wywołania; to nie jest pełne zapytanie HTTP. Twój klient enkapsuluje wywołanie MCP. Jeśli zwróconych jest kilku prawdopodobnych kandydatów, wybierz właściwego przed wyszukiwaniem wokół punktu.

Następnie możesz przetestować transport wokół punktu odniesienia w Bordeaux. Podane współrzędne są do testu i nie pochodzą z poprzedniego adresu w Paryżu.

{
  "name": "transit_nearby",
  "arguments": {
    "lat": 44.8416106,
    "lon": -0.5810938,
    "radius": 600,
    "modes": ["bus", "tram"],
    "limit": 10
  }
}

Odczytuj wynik przed podsumowaniem

Sprawdź status, zwrócone obiekty, pokrycie, ostrzeżenia oraz nałożone limity. Częściowa odpowiedź może zawierać przydatne informacje. Puste wyszukiwanie nie oznacza braku transportu w mieście.

Oczekiwany wynik testu to strukturalna odpowiedź lub wyraźny błąd, nie określona liczba przystanków. Źródła i pokrycie mogą się zmieniać. Wyszukiwanie przystanków nie zwraca ich nadchodzących odjazdów.

Rozwiązywanie błędów połączenia

Rozróżnianie pustego wyniku od błędu API

Tworzenie pełnego asystenta na podstawie adresu

Zrozumienie roli serwera MCP

Nadchodzi: nadchodzące odjazdy i planowanie trasy

ROOTE planuje rozszerzyć swój MCP o nadchodzące odjazdy oraz wyznaczanie tras. Funkcjonalności te są planowane i nie są jeszcze częścią narzędzi aktualnie udostępnianych przez serwer MCP. Po ich udostępnieniu sprawdź ogłoszone narzędzia, ich argumenty oraz faktycznie zwracane informacje przed zapowiedzią przejazdu lub podróży.

Najczęściej zadawane pytania

Czy token jest konieczny?

Dokumentacja przewiduje dostęp anonimowy Free. Limity i możliwości Twojego dostępu są takie, jak ustalone przez serwis.

Dlaczego mój asystent podaje rozkład po wyszukaniu przystanku?

Wyszukiwanie transit_nearby nie dostarcza nadchodzących odjazdów. Poproś asystenta o podanie faktycznie zwróconych danych i wskazanie tego braku.

Czy można testować bez tworzenia aplikacji?

Tak, korzystając z kompatybilnego klienta, który pozwala dodać zdalny serwer i wykonywać jego narzędzia.