FA
API & MCPمستندات

پلتفرم عامل‌ها و API Road User Tools

اتصال به یک کلاینت هوش مصنوعی

سرور MCP ‏Road User Tools را به یک دستیار هوش مصنوعی متصل کنید و با حساب خود به آن مجوز دهید. به تجربهٔ قبلی MCP نیازی نیست.

عامل شما چه چیزی به دست می‌آورد

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

آدرس سرورhttp
https://roaduser.tools/mcp

راه‌اندازی دستی

بیشتر کلاینت‌های هوش مصنوعی از الگوی یکسانی پیروی می‌کنند. عبارت‌ها بین محصولات متفاوت است، اما گام‌ها این‌ها هستند:

  1. تنظیمات MCP، کانکتورها یا یکپارچه‌سازی‌ها را در کلاینت هوش مصنوعی خود باز کنید.
  2. افزودن یک سرور MCP سفارشی یا راه دور را انتخاب کنید.
  3. آدرس MCP ‏Road User Tools را که در بالا نشان داده شده وارد کنید.
  4. ادامه دهید یا متصل شوید.
  5. مرورگر شما صفحهٔ مجوز Road User Tools را باز می‌کند.
  6. وارد حساب Road User Tools خود شوید یا رایگان یک حساب بسازید.
  7. مجوزهای درخواستی را بررسی کنید و اجازه دسترسی را انتخاب کنید.
  8. به کلاینت هوش مصنوعی خود برگردید.
  9. بررسی کنید که Road User Tools به‌صورت متصل نمایش داده شود.
  10. یک سوال جاده ای بپرسید، به عنوان مثال هزینه سوخت یک سفر، برای تأیید اتصال.

عیب‌یابی

صفحهٔ مجوز در مرورگر باز نشد
در کلاینت دنبال پیوند یا دکمه‌ای مانند اتصال، مجوز یا ورود بگردید و بررسی کنید که پنجرهٔ بازشو مسدود نشده باشد. حذف سرور و افزودن دوبارهٔ آن معمولاً روند را از نو آغاز می‌کند.
کلاینت گزارش می‌دهد که احراز هویت لازم است
اتصال اضافه شده اما هنوز مجوز نگرفته است. عمل ورود یا اتصال دوبارهٔ کلاینت را اجرا کنید تا صفحهٔ مجوز باز شود.
مجوز رد شد
اگر رد را انتخاب کرده باشید، کلاینت نمی‌تواند از Road User Tools استفاده کند. دوباره متصل شوید و اجازه دسترسی را انتخاب کنید تا مجوز داده شود.
دسترسی باطل شد
اگر برنامه را از صفحهٔ حساب خود حذف کرده باشید، اتصال آن از کار می‌افتد. از کلاینت دوباره متصل شوید و دوباره به آن مجوز دهید.
کلاینت از مجوزدهی خودکار پشتیبانی نمی‌کند
برخی کلاینت‌ها نمی‌توانند روند ورود در مرورگر را اجرا کنند. از راه‌اندازی دستی با کلید API در پایین استفاده کنید.
کلاینت به پیکربندی دستی نیاز دارد
کلاینت‌هایی که به‌جای صفحهٔ تنظیمات با یک فایل JSON پیکربندی می‌شوند می‌توانند از راه‌اندازی دستی زیر استفاده کنند.
متصل است، اما ابزاری دیده نمی‌شود
فهرست ابزارهای کلاینت را تازه‌سازی کنید یا کلاینت را دوباره راه‌اندازی کنید. اگر ابزارها همچنان دیده نشدند، سرور را حذف کنید و دوباره متصل شوید.

پیشرفته: راه‌اندازی دستی با کلید API

برای کلاینت‌های برنامه‌نویسی‌شده، اسکریپت‌ها یا کلاینت‌های بدون مجوزدهی مرورگری، Road User Tools روی سرور MCP کلیدهای API را هم می‌پذیرد. یک کلید در صفحهٔ حساب خود بسازید و آن را در پیکربندی کلاینت قرار دهید:

پیکربندی دستی MCPjson
{
  "mcpServers": {
    "roaduser-tools": {
      "url": "https://roaduser.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

هر دو روش ورود به همان ابزارها با همان مدل مجوزها می‌رسند.

مستندات API و MCP