Как подключить ИИ-ассистента к MCP ROOTE?

Чтобы подключить ИИ-ассистента к 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_TOKEN

YOUR_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
  }
}

Проверка результата перед выводами

Проверьте статус, возвращённые сущности, покрытие, предупреждения и применённые лимиты. Частичный ответ может содержать полезную информацию. Пустой поиск не доказывает отсутствия транспорта в городе.

Ожидаемый результат теста — структурированный ответ или явная ошибка, а не предустановленное количество остановок. Источники и покрытие могут меняться. Поиск остановок не возвращает их ближайшие отправления.

Устранение ошибок подключения

Отличие пустого результата от ошибки API

Создание полного ассистента на основе адреса

Понимание роли MCP сервера

В будущем: ближайшие отправления и расчёт маршрутов

ROOTE планирует расширить свой MCP, добавив функции предстоящих отправлений и расчёта маршрутов. Эти функции скоро появятся и ещё не входят в состав текущих инструментов, предоставляемых сервером MCP. При их доступности проверяйте инструменты, объявленные сервером, их аргументы и фактически возвращаемую информацию перед публикацией данных о проходах или поездках.

Часто задаваемые вопросы

Обязательно ли иметь токен?

Документация предусматривает анонимный доступ Free. Лимиты и возможности вашего доступа остаются в рамках сервиса.

Почему мой ассистент сообщает расписание после поиска остановки?

Поиск transit_nearby не предоставляет будущие отправления. Попросите ассистента указать реально возвращённые данные и отметить отсутствие информации.

Можно ли тестировать без создания приложения?

Да, с совместимым клиентом, который позволяет добавлять удалённый сервер и использовать его инструменты.