لربط مساعد ذكاء اصطناعي بـ MCP ROOTE، أضف الخادم البعيد https://mcp.roote.ai/mcp في تطبيق متوافق مع MCP Streamable HTTP. الخادم يعرض أدوات قراءة للعناوين والتنقل والخدمات القريبة.
هذا الدليل يتبع إعداد نشرته ROOTE وفحص الاتصال بالخادم. عناوين القوائم تختلف حسب العميل؛ يجب التأكد من عنوان URL، ونقل البيانات، ونظام الأدوات. قد تتغير قائمة tools/list الخاصة بالخادم قبل التوثيق: استخدم القدرات المعلنة فعليًا.
تحقق من توافق العميل
يجب أن يقبل تطبيقك خادم MCP بعيد عبر Streamable HTTP. العميل المقيد للخوادم المحلية stdio لا يمكنه استخدام هذا العنوان كأمر قابل للتنفيذ. تحقق أيضًا ما إذا كان حسابك يسمح بإضافة خوادم مخصصة.
إذا قدم التطبيق نموذجًا، ادخل ROOTE كاسم وURL الخادم كعنوان. إذا كان يقبل ملف بصيغة mcpServers، تقدم وثائق ROOTE هذا التهيئة الدنيا:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}اختر الوصول المجهول أو المصدق
توفر الوثائق وصولًا مجهولًا بدون ترويسة Authorization، يخضع لخدمة Free والقيود النشطة للواجهة البرمجية. للوصول المصدق، استخدم آلية العميل المأمونة لنقل رمزك في ترويسة Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_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 للبحث عن 10 شارع دو ريفولي، باريس، فرنسا. اعرض المرشحين الذين تم إيجادهم وإحداثياتهم." فحص نتيجة الأداة، ليس فقط الرد المكتوب من النموذج.
{
"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 وتهيئة الترويسات |
| تم بلوغ الحد الأقصى | قيود نشطة، مهلة الاستئناف وتكرار الاستدعاءات |
| نتيجة فارغة أو جزئية | الإحداثيات، المرشحات، نصف القطر، التغطية والتحذيرات |
تمييز نتيجة فارغة عن خطأ واجهة برمجة التطبيقات
قريبًا: مواعيد الانطلاق وحساب المسار
يخطط ROOTE لتوسيع MCP الخاص به ليشمل المغادرات القادمة وحساب المسارات. هذه الميزات قادمة وليست جزءًا من الأدوات المتاحة حالياً على خادم MCP. عند توفرها، تحقق من الأدوات المعلنة من الخادم، وحججها والمعلومات المعادة فعليًا قبل الإعلان عن مرور أو رحلة.
الأسئلة المتكررة
هل الرمز ضروري دائمًا؟
توفر الوثائق وصولًا مجهولًا Free. تبقى حدود وقدرات وصولك كما يفرضها الخدمة.
لماذا يعرض مساعدي موعدًا بعد بحث محطة؟
بحث transit_nearby لا يوفر مواعيد الانطلاق القادمة. اطلب من المساعد ذكر البيانات الدقيقة المعادة والإشارة إلى هذا الغياب.
هل يمكن الاختبار دون إنشاء تطبيق؟
نعم، مع عميل متوافق يسمح بإضافة خادم بعيد وتنفيذ أدواته.