Щоб підключити ІІ асистента до MCP ROOTE, додайте віддалений сервер https://mcp.roote.ai/mcp у застосунок, сумісний з MCP Streamable HTTP. Сервер надає інструменти для читання адрес, мобільності та послуг поблизу.
Цей посібник відповідає конфігурації, опублікованій ROOTE, і перевірці з’єднання з сервером. Назви меню можуть відрізнятися залежно від клієнта; URL, транспорт і схема інструментів є основними для перевірки. Список tools/list сервера може змінюватися раніше за документацію: користуйтеся фактично заявленими можливостями.
Перевірка сумісності клієнта
Ваш застосунок повинен підтримувати віддалений MCP сервер через Streamable HTTP. Клієнт, обмежений локальними серверами stdio, не може використати цей URL як виконувану команду. Також переконайтесь, що ваш обліковий запис дозволяє додавати кастомні сервери.
Якщо застосунок має форму, введіть ROOTE як назву та URL сервера як адресу. Якщо він підтримує файл формату mcpServers, документація ROOTE пропонує таку мінімальну конфігурацію:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Офіційна конфігурація підключення ROOTE
Вибір анонімного чи автентифікованого доступу
Документація передбачає анонімний доступ без заголовка Authorization, обмежений проєкцією Free та діючими лімітами API. Для автентифікованого доступу використовуйте захищений механізм клієнта для передачі токена у заголовку Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN – місце для заміни у конфігурації захищеного клієнта. Не вставляйте токен у розмову, публічний URL чи статтю. Недійсний або відкликаний токен не замінюється автоматично анонімним доступом.
Підтвердження доступності інструментів
Після підключення відкрийте список інструментів сервера у клієнті. Документація ROOTE описує послідовність initialize, tools/list, а потім tools/call; сумісні клієнти зазвичай виконують це автоматично. Використовуйте версію та можливості, оголошені сервером.
Сервер надає інструменти geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions та services_nearby. Відсутність цих інструментів свідчить про проблеми з підключенням, визначенням або про зміну сервісу. Завжди перевіряйте список, оголошений сервером. Journey та Departures там поки що не представлені.
Виконання першого відтворюваного пошуку
Почніть з чіткої адреси: «Використай ROOTE для пошуку 10 rue de Rivoli, Paris, France. Вкажи знайдені кандидатури та їх координати.» Перегляньте результат інструмента, не лише текстову відповідь моделі.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Цей блок ілюструє ім’я та аргументи виклику; це не повний HTTP-запит. Ваш клієнт інкапсулює виклик MCP. Якщо повертається кілька потенційних кандидатів, оберіть правильного перед пошуком довкола точки.
Після цього можете протестувати пошук поблизу еталонної точки в Бордо. Вказані координати призначені для тесту й не претендують на походження з попередньої адреси в Парижі.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Перевірка результату перед висновком
Перевірте статус, повернені сутності, охоплення, попередження та застосовані обмеження. Часткова відповідь може містити корисну інформацію. Порожній результат не означає відсутність транспортних засобів у місті.
Очікуваний результат тесту – структурована відповідь або явна помилка, а не заздалегідь визначена кількість зупинок. Джерела та охоплення можуть змінюватися. Пошук зупинок не повертає їхні наступні відправлення.
Вирішення помилок підключення
| Симптом | Корисна перевірка |
|---|---|
| Інструменти не виявлені | Точний URL, віддалений транспорт і дозвіл клієнта |
| Помилка аргументів | Типи, дозволені значення та поля оголошеної схеми |
| Помилка автентифікації | Дійсність Bearer та налаштування заголовків |
| Досягнуто ліміт | Діючі обмеження, час відновлення та частота викликів |
| Порожній або частковий результат | Координати, фільтри, радіус, покриття та попередження |
Відрізнити порожній результат від помилки API
Створення повного асистента на основі адреси
В майбутньому: наступні відправлення та планування маршруту
ROOTE планує розширити свій MCP, додавши дані про найближчі відправлення та розрахунок маршрутів. Ці функції готуються і наразі не входять до інструментів, що їх надає сервер MCP. Під час їх появи перевіряйте інструменти, які оголошує сервер, їхні аргументи та фактично повернені дані перед оголошенням проходження чи маршруту.
Часті питання
Чи обов’язковий токен?
Документація передбачає анонімний безкоштовний доступ. Обмеження і можливості вашого доступу відповідають тим, що застосовує сервіс.
Чому мій асистент показує розклад після пошуку зупинки?
Пошук transit_nearby не повертає наступні відправлення. Попросіть асистента цитувати фактично повернені дані і вказувати на цю відсутність.
Чи можна тестувати без створення застосунку?
Так, за допомогою сумісного клієнта, що дозволяє додавати віддалений сервер і виконувати його інструменти.