# چگونه دستیار هوش مصنوعی را به MCP ROOTE متصل کنیم؟

> یک دستیار را به MCP ROOTE متصل کنید: آدرس سرور، پیکربندی HTTP، اولین جستجو، خواندن نتایج و رفع خطاها.

Source: https://www.roote.ai/fa/guides/%DA%86%DA%AF%D9%88%D9%86%D9%87-%D8%AF%D8%B3%D8%AA%DB%8C%D8%A7%D8%B1-%D9%87%D9%88%D8%B4-%D9%85%D8%B5%D9%86%D9%88%D8%B9%DB%8C-%D8%B1%D8%A7-%D8%A8%D9%87-mcp-roote-%D9%88%D8%B5%D9%84-%DA%A9%D9%86%DB%8C%D9%85/
Language: fa
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 برای جستجوی ۱۰ خیابان رویولی، پاریس، فرانسه استفاده کن. نامزدهای یافته شده و مختصات آنها را نشان بده.» نتیجه ابزار را بررسی کنید، نه فقط پاسخ نوشته شده توسط مدل.

```
{
  "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/fa/guides/no-result-or-api-error-how-to-differentiate/)

[ساخت یک دستیار کامل از طریق آدرس](https://www.roote.ai/fa/guides/chek-kardan-ye-dastgahi-ke-mobility-ha-ra-dar-hamkoli-ye-adress-peida-mikonad/)

[درک نقش سرور MCP](https://www.roote.ai/fa/guides/server-mcp-%DA%86%DB%8C%D8%B3%D8%AA-%D9%88-%DA%86%D9%87-%DA%A9%D8%A7%D8%B1%D8%A8%D8%B1%D8%AF%DB%8C-%D8%AF%D8%A7%D8%B1%D8%AF/)

## در راه: حرکت‌های آینده و محاسبه مسیر

ROOTE قصد دارد MCP خود را به بخش حرکت‌های آینده و محاسبه مسیر گسترش دهد. این قابلیت‌ها در دست تهیه هستند و هنوز جزو ابزارهای ارائه شده توسط سرور MCP نیستند. هنگام فعال شدن، ابزارهای اعلام شده توسط سرور، پارامترها و اطلاعات بازگشتی را بررسی کنید پیش از اعلام عبور یا سفر.

## پرسش‌های متداول

### آیا حتماً باید توکن داشته باشم؟

مستندات دسترسی ناشناس Free را پیش‌بینی می‌کند. محدودیت‌ها و قابلیت‌های دسترسی شما مطابق آنچه سرویس اعمال می‌کند باقی می‌ماند.

### چرا دستیار من پس از جستجوی ایستگاه زمان اعلام می‌کند؟

جستجوی transit_nearby حرکت‌های آینده را ارائه نمی‌دهد. از دستیار بخواهید داده‌های واقعی بازگردانده شده را بیان کند و به نبود این اطلاعات اشاره کند.

### آیا می‌توان بدون ساخت اپلیکیشن تست کرد؟

بله، با یک کلاینت سازگار که اجازه افزودن سرور راه دور و اجرای ابزارهای آن را می‌دهد.