تخطَّ إلى المحتوى
موارد المطورين
موارد المطورين

Hosted MCP

اربط Claude Desktop أو Cursor أو VS Code أو Windsurf أو أي عميل MCP آخر بـ RunAPI عبر OAuth.

عرض Markdown

Hosted MCP هو الطريقة الموصى بها لاستخدام أدوات RunAPI. يتصل عميل MCP مباشرةً بـ RunAPI، لذا لا تحتاج إلى تثبيت Node.js أو تشغيل عملية محلية باستمرار.

استخدم نقطة النهاية هذه:

TEXT 
https://mcp.runapi.ai/mcp

اختر عميل MCP أدناه. عندما يفتح العميل RunAPI في متصفحك، سجّل الدخول، واختر الحساب المراد استخدامه، وامنح الوصول.

Claude Desktop

  1. افتح الإعدادات > الموصّلات وأضف موصّلاً مخصصاً.
  2. سمِّه RunAPI وأدخل نقطة النهاية أعلاه.
  3. حدد اتصال وأكمل تفويض RunAPI في متصفحك.
  4. في إحدى المحادثات، افتح + > الموصّلات وفعِّل RunAPI.

إذا لم يظهر RunAPI في محادثة ما، ارجع إلى الإعدادات > الموصلات، أعد توصيله، وتأكد من تفعيله لتلك المحادثة.

المؤشر

أضف RunAPI إلى mcp.json الخاص بـ Cursor، مثل ملف المشروع .cursor/mcp.json:

JSON 
{
  "mcpServers": {
    "runapi": {
      "url": "https://mcp.runapi.ai/mcp"
    }
  }
}

افتح Customize في الشريط الجانبي لـ Cursor، وابحث عن RunAPI، وفعّله، ثم أكمل التفويض في متصفحك.

يجب أن يظهر RunAPI متصلاً ويعرض أدواته. في حالة أخطاء الاتصال أو المصادقة، افتح لوحة الإخراج وحدد سجلات MCP.

VS Code

  1. افتح لوحة الأوامر ونفِّذ MCP: Add Server.
  2. اختر HTTP، وأدخل نقطة النهاية أعلاه، وسمِّ الخادم RunAPI.
  3. ابدأ تشغيل الخادم، وثق به عند الطلب، وأكمل التفويض في متصفحك.

يجب أن تظهر أدوات RunAPI في Chat. في حالة الأخطاء، شغِّل MCP: List Servers، وحدد RunAPI، واختر Show Output.

Windsurf

تنطبق هذه الخطوات على عامل Cascade. يستخدم Devin Local تهيئة Devin CLI.

  1. افتح إعدادات Devin > Cascade > خوادم MCP وعدِّل ملف ~/.codeium/windsurf/mcp_config.json مباشرةً.
  2. أضف RunAPI كخادم HTTP بعيد:
JSON 
{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}
  1. احفظ الملف، وأعد تحميل خوادم MCP، وفعِّل RunAPI، وأكمل التفويض في متصفحك.

إذا لم تظهر الأدوات، افتح إعدادات MCP، تأكد من تفعيل RunAPI، وأعد توصيله.

عملاء MCP آخرون

أضف نقطة النهاية أعلاه كخادم Streamable HTTP. يجب أن يدعم العميل Remote MCP والتفويض عبر المتصفح. أكمل التفويض عند الطلب، ثم فعِّل أدوات RunAPI في العميل.

التحقق من الاتصال

اسأل عميلك:

ما نماذج الصور المتاحة في RunAPI؟

ينبغي أن يستدعي العميل list_models ويُعيد نماذج الصور المتاحة. يُؤكد ذلك أن الاتصال وإيفاد الأدوات يعملان بشكل صحيح.

استخدم مفتاح API عوضًا عن ذلك

OAuth هو المسار الموصى به. استخدم مفتاح API قياسيًا مخصصًا فقط لعميل غير مراقَب أو عند عدم توفر OAuth؛ اتبع دليل المصادقة لإنشاء مفتاح. لا تضع المفتاح في عنوان URL لنقطة النهاية أو تُلزمه في مستودع.

  • Claude Desktop: إذا كانت رؤوس الطلبات متاحة للموصلات المخصصة، أضف رأس Authorization بالقيمة Bearer YOUR_API_KEY.
  • Cursor: عيّن RUNAPI_API_KEY في البيئة المرئية لتطبيق Cursor، ثم استخدم Authorization: Bearer ${env:RUNAPI_API_KEY} في headers الخادم. لا تقرأ الخوادم البعيدة إعدادات envFile الخاصة بـ Cursor.
  • VS Code: استرجع ${input:...} من نوع كلمة المرور من رأس Authorization للخادم كي يطلب VS Code المفتاح ويخزّنه بدلاً من كتابته في mcp.json.
  • Windsurf: استرجع ${env:RUNAPI_API_KEY} أو ${file:...} من رأس Authorization في ~/.codeium/windsurf/mcp_config.json.

أَلغِ المفتاح من صفحة مفاتيح API عند إيقاف العميل أو إذا كان المفتاح قد يكون قد تعرَّض للكشف.

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

  • لم تكتمل عملية التفويض: أعد ربط RunAPI من العميل وأكمل تدفق المتصفح من جديد.
  • RunAPI متصل لكن أدواته مفقودة: تأكد من تفعيل الخادم، ثم احذف نقطة النهاية المحددة وأضفها مجدداً، ثم ابدأ محادثة جديدة.
  • فشل سؤال التحقق: راجع سجل العميل الموضح في قسمه أعلاه، ثم أعد ربط RunAPI قبل المحاولة مرة أخرى.

هل تحتاج إلى عميل لتشغيل RunAPI على جهازك؟ إعداد Local MCP.