# Bagaimana untuk menyambungkan Pembantu IA ke MCP ROOTE?

> Sambungkan pembantu ke MCP ROOTE: URL pelayan, konfigurasi HTTP, carian pertama, bacaan hasil dan penyelesaian masalah ralat.

Source: https://www.roote.ai/ms/guides/cara-sambungkan-pembantu-ia-ke-mcp-roote/
Language: ms
Author: ROOTE

Untuk menyambungkan pembantu IA ke MCP ROOTE, tambahkan pelayan jauh https://mcp.roote.ai/mcp dalam aplikasi yang serasi dengan MCP Streamable HTTP. Pelayan ini menyediakan alat bacaan untuk alamat, mobiliti dan perkhidmatan berdekatan.

Tutorial ini mengikuti konfigurasi yang diterbitkan oleh ROOTE dan pemeriksaan sambungan ke pelayan. Tajuk menu berubah mengikut klien; URL, kaedah penghantaran dan skema alat adalah elemen yang perlu diperiksa. Senarai tools/list dari pelayan boleh berubah sebelum dokumentasi: gunakan keupayaan yang benar-benar diumumkan.

## Periksa keserasian klien

Aplikasi anda harus menerima pelayan MCP jauh melalui Streamable HTTP. Klien yang terhad kepada pelayan tempatan stdio tidak dapat menggunakan URL ini sebagai perintah boleh-laksana. Juga pastikan akaun anda membenarkan penambahan pelayan khusus.

Jika aplikasi menyediakan borang, isi ROOTE sebagai nama dan URL pelayan sebagai alamat. Jika ia menerima fail dalam format mcpServers, dokumentasi ROOTE menyediakan konfigurasi minimum berikut:

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

[Konfigurasi sambungan rasmi ROOTE](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## Pilih akses tanpa nama atau diautentikasi

Dokumentasi menyediakan akses tanpa nama tanpa header Authorization, yang tertakluk kepada pelan Free dan had API yang aktif. Untuk akses diautentikasi, gunakan mekanisme selamat klien untuk menghantar token anda dalam header Bearer.

```
Authorization: Bearer YOUR_API_TOKEN
```

YOUR_API_TOKEN adalah ruang yang perlu digantikan dalam konfigurasi selamat klien. Jangan tampal token dalam perbualan, URL awam atau artikel. Token yang tidak sah atau dibatalkan tidak akan secara automatik digantikan dengan akses tanpa nama.

## Sahkan alat tersedia

Selepas sambungan, buka senarai alat pelayan dalam klien anda. Dokumentasi ROOTE menerangkan urutan initialize, tools/list kemudian tools/call; klien serasi biasanya mengendalikan pertukaran ini untuk anda. Gunakan versi dan keupayaan yang diumumkan oleh pelayan.

Pelayan menyediakan geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions dan services_nearby. Ketiadaan alat-alat ini menunjukkan masalah sambungan, penemuan atau perubahan perkhidmatan. Sentiasa periksa senarai yang diumumkan oleh pelayan. Journey dan Departures belum lagi disediakan di situ.

## Buat carian pertama yang boleh diulang

Mulakan dengan alamat yang jelas: "Gunakan ROOTE untuk mencari 10 rue de Rivoli, Paris, Perancis. Nyatakan calon yang ditemui dan koordinat mereka." Teliti hasil alat, bukan hanya jawapan yang ditulis model.

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

Blok ini menggambarkan nama dan argumen panggilan; ini bukan permintaan HTTP lengkap. Klien anda membungkus panggilan MCP. Jika terdapat beberapa calon berkemungkinan, pilih yang betul sebelum membuat carian sekitar titik itu.

Anda kemudian boleh menguji pengangkutan sekitar titik rujukan di Bordeaux. Koordinat di bawah adalah untuk ujian dan tidak bertujuan berasal dari alamat Paris sebelumnya.

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

## Baca hasil sebelum membuat kesimpulan

Periksa status, entiti yang dikembalikan, liputan, amaran dan had yang dikenakan. Jawapan separa mungkin mengandungi maklumat berguna. Carian kosong tidak menunjukkan ketiadaan pengangkutan fizikal dalam bandar.

Hasil yang dijangkakan dari ujian adalah jawapan berstruktur atau ralat jelas, bukan bilangan hentian yang telah ditetapkan. Sumber dan liputan boleh berubah. Carian hentian tidak mengembalikan waktu bertolak akan datang.

## Selesaikan ralat sambungan

| Gejala | Pemeriksaan berguna |
| --- | --- |
| Tiada alat ditemui | URL tepat, pengangkutan jauh dan kebenaran klien |
| Ralat argumen | Jenis, nilai dibenarkan dan medan skema yang diumumkan |
| Ralat pengesahan | Kesahan Bearer dan konfigurasi header |
| Had dicapai | Had aktif, masa pemulihan dan kekerapan panggilan |
| Hasil kosong atau separa | Koordinat, penapis, radius, liputan dan amaran |

[Bezakan hasil kosong daripada ralat API](https://www.roote.ai/ms/guides/tiada-keputusan-atau-ralat-api-bagaimana-membuat-perbezaan/)

[Bina pembantu lengkap dari alamat](https://www.roote.ai/ms/guides/cara-cipta-pembantu-mobiliti-sekitar-alamat/)

[Fahami peranan pelayan MCP](https://www.roote.ai/ms/guides/apa-itu-pelayan-mcp-dan-fungsinya/)

## Akan Datang: waktu bertolak akan datang dan pengiraan laluan

ROOTE merancang untuk mengembangkan MCPnya kepada keberangkatan akan datang dan pengiraan laluan. Fungsi-fungsi ini masih akan datang dan belum lagi menjadi sebahagian daripada alat yang disediakan oleh pelayan MCP pada masa ini. Apabila tersedia, periksa alat yang diumumkan oleh pelayan, argumen mereka dan maklumat yang benar-benar dipulangkan sebelum mengumumkan satu perjalanan atau laluan.

## Soalan lazim

### Adakah token wajib?

Dokumentasi menyediakan akses bebas nama Free. Had dan keupayaan akses anda kekal seperti yang dikenakan oleh perkhidmatan.

### Mengapa pembantu saya mengumumkan jadual selepas carian hentian?

Carian transit_nearby tidak memberikan waktu bertolak akan datang. Minta pembantu menyenaraikan data sebenar yang dikembalikan dan tunjukkan ketiadaan ini.

### Boleh ujian tanpa buat aplikasi?

Ya, dengan klien serasi yang membenarkan penambahan pelayan jauh dan menjalankan alatnya.