# Как да свържете ИИ асистент към MCP ROOTE?

> Свържете асистент към MCP ROOTE: URL на сървъра, HTTP конфигурация, първа заявка, четене на резултатите и отстраняване на грешки.

Source: https://www.roote.ai/bg/guides/kak-da-svyazhem-ia-asistent-s-mcp-roote/
Language: bg
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/bg/guides/prazni-rezultati-ili-greshka-api-kak-da-otlichim/)

[Създаване на изчерпателен асистент от адрес](https://www.roote.ai/bg/guides/kak-da-sazdaem-asistent-za-mobilnost-okolo-adres/)

[Разбиране на ролята на MCP сървър](https://www.roote.ai/bg/guides/kakvo-e-mcp-server-i-za-kakvo-sluzhi/)

## Предстоящо: следващи заминавания и изчисляване на маршрут

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

## Често задавани въпроси

### Необходимо ли е задължително token?

Документацията предвижда анонимен Free достъп. Лимитите и възможностите на вашия достъп остават тези, прилагани от услугата.

### Защо асистентът ми обявява разписание след търсене на спирка?

Търсене transit_nearby не предоставя следващи заминавания. Помолете асистента да цитира реално върнатите данни и да посочи това отсъствие.

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

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