چگونه دستیار هوش مصنوعی را به MCP 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

انتخاب دسترسی ناشناس یا احراز هویت شده

مستندات دسترسی ناشناس بدون سربرگ 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
  }
}

خواندن نتیجه پیش از نتیجه‌گیری

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

نتیجه مورد انتظار برای آزمون یک پاسخ ساختاریافته یا خطای صریح است، نه تعداد از پیش تعیین شده ایستگاه‌ها. منابع و پوشش ممکن است تغییر کنند. جستجوی ایستگاه‌ها، حرکت‌های آینده آنها را برنمی‌گرداند.

رفع خطاهای اتصال

تمایز پاسخ خالی از خطای API

ساخت یک دستیار کامل از طریق آدرس

درک نقش سرور MCP

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

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

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

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

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

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

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

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

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