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

> Подключите ассистента к MCP ROOTE: URL сервера, настройка HTTP, первый поиск, чтение результатов и устранение ошибок.

Source: https://www.roote.ai/ru/guides/kak-podklyuchit-ia-assistenta-k-mcp-roote/
Language: ru
Author: 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](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## Выбор анонимного или аутентифицированного доступа

В документации предусмотрен анонимный доступ без заголовка 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
  }
}
```

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

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

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

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

| Симптом | Полезная проверка |
| --- | --- |
| Инструменты не обнаружены | Точный URL, удалённый транспорт и разрешения клиента |
| Ошибка аргументов | Типы, разрешённые значения и поля объявленной схемы |
| Ошибка аутентификации | Действительность Bearer и настройка заголовков |
| Достигнут лимит | Активные лимиты, время восстановления и частота вызовов |
| Пустой или частичный результат | Координаты, фильтры, радиус, покрытие и предупреждения |

[Отличие пустого результата от ошибки API](https://www.roote.ai/ru/guides/net-resultat-ou-erreur-api-comment-faire-la-difference/)

[Создание полного ассистента на основе адреса](https://www.roote.ai/ru/guides/kak-sozdat-pomoshhnika-dlya-poiska-mobilnosti-vokrug-adresa/)

[Понимание роли MCP сервера](https://www.roote.ai/ru/guides/chto-takoe-server-mcp-i-dlya-chego-on-nuzhen/)

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

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

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

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

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

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

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

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

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