AR
API & MCPالتوثيق

منصة المطورين Mariner GPS Tools

الاتصال بعميل ذكاء اصطناعي

صِل خادم Mariner Tools MCP بمساعد ذكاء اصطناعي وفوّضه باستخدام حسابك. لا حاجة إلى خبرة سابقة في MCP.

ما الذي يحصل عليه وكيلك

توفّر Mariner Tools خادم MCP. إن MCP، أي Model Context Protocol، معيار مفتوح يتيح لمساعدي الذكاء الاصطناعي استخدام أدوات خارجية. عند الاتصال به، يحصل مساعد أو وكيل ذكاء اصطناعي متوافق على إمكانية الوصول إلى قدرات الملاحة في Mariner Tools ويمكنه العثور على تلك الأدوات واستدعاؤها عندما تحتاجها المحادثة، مثلاً لتحويل الإحداثيات أو حساب مسافة.

عنوان URL للخادمhttp
https://marinergps.tools/mcp

الإعداد اليدوي

تتبع معظم عملاء الذكاء الاصطناعي النمط نفسه. تختلف الصياغة بين المنتجات، لكن الخطوات هي:

  1. افتح إعدادات MCP أو الموصلات أو عمليات التكامل في عميل الذكاء الاصطناعي الخاص بك.
  2. اختر إضافة خادم MCP مخصص أو بعيد.
  3. أدخل عنوان URL لخادم Mariner Tools MCP المعروض أعلاه.
  4. تابع أو اتصل.
  5. يفتح متصفحك صفحة التفويض الخاصة بـ Mariner Tools.
  6. سجّل الدخول إلى حسابك في Mariner Tools، أو أنشئ حساباً مجاناً.
  7. راجع الصلاحيات المطلوبة واختر السماح بالوصول.
  8. عد إلى عميل الذكاء الاصطناعي الخاص بك.
  9. تأكد من ظهور Mariner Tools كمتصل.
  10. اطرح سؤالاً ملاحياً، مثل المسافة بين موقعين، للتحقق من الاتصال.

استكشاف الأخطاء وإصلاحها

لم تُفتح صفحة التفويض في المتصفح
ابحث عن رابط أو زر في العميل مثل اتصال أو تفويض أو تسجيل الدخول، وتأكد من عدم حظر نافذة منبثقة. عادةً ما تؤدي إزالة الخادم وإعادة إضافته إلى إعادة بدء العملية.
يُبلغ العميل بأن المصادقة مطلوبة
تمت إضافة الاتصال لكنه لم يُفوَّض بعد. شغّل إجراء تسجيل الدخول أو إعادة الاتصال في العميل حتى تُفتح صفحة التفويض.
تم رفض التفويض
إذا اخترت رفض، فلن يتمكن العميل من استخدام Mariner Tools. أعد الاتصال واختر السماح بالوصول لمنحه الإذن.
تم إبطال الوصول
إذا أزلت التطبيق من صفحة حسابك، يتوقف اتصاله عن العمل. أعد الاتصال من العميل وفوّضه مرة أخرى.
العميل لا يدعم التفويض التلقائي
لا يستطيع بعض العملاء تشغيل عملية تسجيل الدخول عبر المتصفح. استخدم الإعداد اليدوي بمفتاح API أدناه.
العميل يتطلب تكويناً يدوياً
يمكن للعملاء المكوَّنين عبر ملف JSON بدلاً من شاشة إعدادات استخدام الإعداد اليدوي أدناه.
متصل، لكن لا تظهر أي أدوات
حدّث قائمة أدوات العميل أو أعد تشغيل العميل. إذا لم تظهر الأدوات بعد ذلك، فأزل الخادم واتصل مرة أخرى.

متقدم: إعداد يدوي بمفتاح API

بالنسبة إلى العملاء البرمجيين والبرامج النصية والعملاء الذين لا يدعمون التفويض عبر المتصفح، تقبل Mariner Tools أيضاً مفاتيح API على خادم MCP. أنشئ مفتاحاً من صفحة حسابك وأدرجه في تكوين العميل:

قم بإنشاء مفتاح API
تكوين MCP يدويjson
{
  "mcpServers": {
    "mariner-tools": {
      "url": "https://marinergps.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

تصل كلتا طريقتي تسجيل الدخول إلى الأدوات نفسها بنموذج الصلاحيات نفسه.

وثائق API وMCP