# Jinsi ya Kuunganisha Msaidizi wa AI na MCP ROOTE?

> Unganisha msaidizi na MCP ROOTE: URL ya seva, usanidi wa HTTP, utafutaji wa kwanza, kusoma matokeo na kutatua makosa.

Source: https://www.roote.ai/sw/guides/jinsi-ya-kuunganisha-msaidizi-ya-ai-na-mcp-roote/
Language: sw
Author: ROOTE

Ili kuunganisha msaidizi wa AI na MCP ROOTE, ongeza seva ya mbali https://mcp.roote.ai/mcp katika programu inayooana na MCP Streamable HTTP. Seva inatoa zana za kusoma anwani, usafiri na huduma za karibu.

Mafunzo haya yanafuata usanidi uliotangazwa na ROOTE pamoja na uthibiti wa muunganisho na seva. Majina ya menyu hubadilika kulingana na mteja; URL, njia ya usafirishaji na mpangilio wa zana ndio mambo ya kuangalia. Orodha ya tools/list ya seva inaweza kubadilika kabla ya hati rasmi: tumia uwezo uliotangazwa kwa hakika.

## Hakiki uendeshaji wa mteja

Programu yako inapaswa kuruhusu seva ya MCP ya mbali kwa Streamable HTTP. Mteja aliyezungukwa kwa seva za ndani stdio hawezi kutumia URL hii kama amri ya kutekeleza. Hakikisha pia akaunti yako inaruhusu kuongeza seva maalum.

Ikiwa programu ina fomu, jaza ROOTE kama jina na URL ya seva kama anwani. Ikiwa inakubali faili ya muundo mcpServers, nyaraka za ROOTE zinapendekeza usanidi huu wa chini kabisa:

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

[Usanidi Rasmi wa Muunganisho wa ROOTE](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## Chagua upatikanaji wa ajenti au uthibitishaji

Nyaraka zinawazia upatikanaji wa ajenti bila kichwa cha Authorization, ukitumia toleo la Free na mipaka ya API inayotumika. Kwa upatikanaji uliothibitishwa, tumia mbinu salama ya mteja kupeleka tokeni yako kupitia kichwa cha Bearer.

```
Authorization: Bearer YOUR_API_TOKEN
```

YOUR_API_TOKEN ni sehemu ya kubadilishwa katika usanidi salama wa mteja. Usikate tokeni katika mazungumzo, URL za umma au makala. Tokeni batili au iliyokataliwa haitabadilishwa moja kwa moja kwa upatikanaji wa ajenti.

## Thibitisha kuwa zana zinapatikana

Baada ya kuunganishwa, fungua orodha ya zana za seva katika mteja wako. Nyaraka za ROOTE zinaelezea mfululizo initialize, tools/list kisha tools/call; wateja wanaoendana kawaida hufanya mchakato huu kwa niaba yako. Tumia toleo na uwezo ulioelezwa na seva.

Seva inaonyesha zana za geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions na services_nearby. Kutokuwepo kwa zana hizi kunaweza kuwa ni tatizo la muunganisho, kugundua, au mabadiliko ya huduma. Daima hakiki orodha inayotangazwa na seva. Journey na Departures bado hazijaonyeshwa.

## Fanya utafutaji wa kwanza unaorudiwa

Anza kwa anwani iliyo wazi: “Tumie ROOTE kutafuta 10 rue de Rivoli, Paris, Ufaransa. Onyesha wagombea waliopatikana na kuratibu zao.” Angalia matokeo ya zana, si tu jibu lililoandikwa na mfano.

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

Sehemu hii inaonyesha jina na hoja za wito; si ombi kamili la HTTP. Mteja wako hufunga wito la MCP. Ikiwa wagombea wengi wenye uwezekano wanarudi, chagua sahihi kabla ya kutafuta karibu na sehemu hiyo.

Baadaye unaweza kujaribu usafirishaji karibu na sehemu ya marejeleo Bordeaux. Kuratibu zilizotolewa hapa hutumika kwa majaribio na hazidai kutoka kwa anwani ya Paris iliyotangulia.

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

## Soma matokeo kabla ya kutoa hitimisho

Kagua hali, vitu vilivyorudiwa, mwonekano, onyo na mipaka iliyowekwa. Jibu la sehemu linaweza kuwa na taarifa muhimu. Utafutaji usio na matokeo hauthibitishi kukosekana kwa usafiri mjiule.

Matokeo yanayotarajiwa ya jaribio ni jibu lililopangwa au kosa wazi, si idadi maalum ya vituo. Vyanzo na mwonekano vinaweza kubadilika. Utafutaji wa vituo hauirudishi kuondoka kwavituo vijavyo.

## Tatuu Makosa ya Muunganisho

| Dalili | Uhakiki Muhimu |
| --- | --- |
| Hakuna zana zilizogunduliwa | URL sahihi, usafirishaji wa mbali na ruhusa ya mteja |
| Hitilafu za hoja | Aina, thamani zinazokubaliwa na sehemu za muundo ulioelezwa |
| Hitilafu za uthibitishaji | Uhalali wa Bearer na usanidi wa vichwa |
| Kufikia kikomo | Mipaka inayotumika, muda wa kusitishwa na mzunguko wa wito |
| Matokeo tupu au sehemu | Kuratibu, vichujio, mduara, mwonekano na onyo |

[Tofautisha kati ya jibu tupu na kosa la API](https://www.roote.ai/sw/guides/hakuna-matokeo-au-kosa-la-api-jinsi-ya-kujitofautisha/)

[Tengeneza msaidizi kamili kutoka kwa anwani](https://www.roote.ai/sw/guides/kujenga-msaidizi-wa-kipata-usalama-wa-mobility-katika-anwani/)

[Elewa jukumu la seva ya MCP](https://www.roote.ai/sw/guides/server-mcp-na-madhumuni-ya-mtandao-na-matumizi/)

## Inakuja: kuondoka vijavyo na hesabu za njia

ROOTE inapanga kupanua MCP yao kwa kuonyesha Departure zijazo na kuhesabu njia (itinéraire). Hizi ni huduma zinazokuja na bado hazijajumuishwa katika zana zinazotolewa na seva ya MCP kwa sasa. Ukizipata, hakiki zana zinazotangazwa na seva, vigezo vyake na taarifa zinazorejeshwa kabla ya kutangaza kuondoka au safari.

## Maswali ya Mara kwa Mara

### Je, tokeni ni lazima?

Nyaraka zinakubali upatikanaji wa ajenti Free. Mipaka na uwezo wa upatikanaji wako ni ile inayotekelezwa na huduma.

### Kwa nini msaidizi wangu anatangaza ratiba baada ya utafutaji wa kituo?

Utafutaji transit_nearby hauirudishi kuondoka vijavyo vijavyo. Muombe msaidizi akueleze data halisi iliyorejeshwa na kutaja ukosefu huo.

### Je, niwezi kujaribu bila kutengeneza programu?

Ndiyo, kwa mteja unaoendana unaowezesha kuongeza seva ya mbali na kuendesha zana zake.