# Cara Menghubungkan Asisten IA ke MCP ROOTE?

> Hubungkan asisten ke MCP ROOTE: URL server, konfigurasi HTTP, pencarian pertama, membaca hasil, dan pemecahan masalah error.

Source: https://www.roote.ai/id/guides/cara-menghubungkan-asisten-ia-ke-mcp-roote/
Language: id
Author: ROOTE

Untuk menghubungkan asisten IA ke MCP ROOTE, tambahkan server jarak jauh https://mcp.roote.ai/mcp di aplikasi yang kompatibel dengan MCP Streamable HTTP. Server ini menyediakan alat baca untuk alamat, mobilitas, dan layanan terdekat.

Tutorial ini mengikuti konfigurasi yang dipublikasikan oleh ROOTE dan verifikasi koneksi ke server. Nama menu dapat berubah tergantung klien; yang perlu diperiksa adalah URL, transportasi, dan skema alat. Daftar tools/list pada server dapat berubah sebelum dokumentasi: gunakan kemampuan yang benar-benar diumumkan.

## Periksa kompatibilitas klien

Aplikasi Anda harus menerima server MCP jarak jauh melalui Streamable HTTP. Klien yang terbatas pada server lokal stdio tidak dapat menggunakan URL ini sebagai perintah yang dapat dijalankan. Pastikan juga akun Anda mengizinkan penambahan server kustom.

Jika aplikasi menyediakan formulir, isi ROOTE sebagai nama dan URL server sebagai alamat. Jika mendukung file format mcpServers, dokumentasi ROOTE menyediakan konfigurasi minimal ini:

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

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

## Pilih akses anonim atau autentikasi

Dokumentasi menyediakan akses anonim tanpa header Authorization, yang tunduk pada proyek Free dan batas aktif API. Untuk akses autentikasi, gunakan mekanisme aman di klien untuk mengirim token Anda dalam header Bearer.

```
Authorization: Bearer YOUR_API_TOKEN
```

YOUR_API_TOKEN adalah placeholder yang harus diganti dalam konfigurasi klien yang aman. Jangan menempelkan token di percakapan, URL publik, atau artikel. Token yang tidak valid atau dicabut tidak otomatis digantikan dengan akses anonim.

## Pastikan alat tersedia

Setelah terhubung, buka daftar alat server di klien Anda. Dokumentasi ROOTE menjelaskan tahap initialize, tools/list lalu tools/call; klien kompatibel biasanya melakukan pertukaran ini otomatis. Gunakan versi dan kemampuan yang diumumkan server.

Server menyediakan alat geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions, dan services_nearby. Ketidakadaan alat ini menunjukkan masalah koneksi, penemuan, atau perubahan layanan. Selalu periksa daftar yang diumumkan oleh server. Journey dan Departures belum tersedia di sana.

## Lakukan pencarian pertama yang bisa direproduksi

Mulailah dengan alamat yang jelas: “Gunakan ROOTE untuk mencari 10 rue de Rivoli, Paris, Prancis. Tampilkan kandidat yang ditemukan dan koordinatnya.” Periksa hasil alat, bukan hanya jawaban yang dibuat oleh model.

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

Blok ini menunjukkan nama dan argumen panggilan; ini bukan permintaan HTTP lengkap. Klien Anda membungkus panggilan MCP. Jika ada beberapa kandidat yang valid, pilih yang benar sebelum mencari di sekitar titik tersebut.

Anda bisa menguji transportasi sekitar titik referensi di Bordeaux. Koordinat di bawah ini hanya untuk uji coba dan tidak mewakili alamat Paris sebelumnya.

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

## Baca hasil sebelum menyimpulkan

Periksa status, entitas yang dikembalikan, cakupan, peringatan, dan batas yang diterapkan. Hasil sebagian bisa berisi informasi berguna. Pencarian kosong bukan berarti transportasi benar-benar tidak ada di kota.

Hasil tes yang diharapkan adalah respon terstruktur atau error yang jelas, bukan jumlah pemberhentian tertentu. Sumber dan cakupan bisa berubah. Pencarian pemberhentian tidak mengembalikan keberangkatan berikutnya.

## Mengatasi kesalahan koneksi

| Gejala | Pemeriksaan berguna |
| --- | --- |
| Tidak ada alat yang ditemukan | URL yang tepat, transportasi jarak jauh, dan izin klien |
| Kesalahan argumen | Jenis, nilai yang diizinkan, dan bidang skema yang diumumkan |
| Kesalahan autentikasi | Validitas Bearer dan konfigurasi header |
| Batas tercapai | Batas aktif, waktu tunggu, dan frekuensi panggilan |
| Hasil kosong atau sebagian | Koordinat, filter, radius, cakupan, dan peringatan |

[Membedakan hasil kosong dengan error API](https://www.roote.ai/id/guides/hasil-kosong-atau-error-api-bagaimana-membedakannya/)

[Membuat asisten lengkap dari sebuah alamat](https://www.roote.ai/id/guides/cara-membuat-asisten-mobilitas-di-sekitar-alamat/)

[Memahami peran server MCP](https://www.roote.ai/id/guides/apa-itu-server-mcp-dan-untuk-apa/)

## Yang akan datang: keberangkatan berikutnya dan perhitungan rute

ROOTE berencana memperluas MCP-nya untuk Departures dan perhitungan rute. Fitur-fitur ini sedang dikembangkan dan belum termasuk dalam alat yang saat ini tersedia di server MCP. Saat tersedia, pastikan untuk memeriksa alat yang diumumkan oleh server, argumen mereka, dan informasi yang benar-benar dikembalikan sebelum mengumumkan keberangkatan atau perjalanan.

## Pertanyaan yang sering diajukan

### Apakah token wajib?

Dokumentasi menyediakan akses anonim Free. Batas dan kapasitas akses Anda tetap sesuai dengan yang diterapkan layanan.

### Mengapa asisten saya mengumumkan jadwal setelah pencarian pemberhentian?

Pencarian transit_nearby tidak menyediakan keberangkatan berikutnya. Minta asisten menyatakan data yang benar-benar dikembalikan dan memberitahu jika data tersebut tidak tersedia.

### Bisakah diuji tanpa membuat aplikasi?

Ya, dengan klien yang kompatibel yang memungkinkan menambahkan server jarak jauh dan menjalankan alatnya.