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

Local MCP

شغِّل RunAPI MCP Server محلياً مع Claude Code أو Cursor أو VS Code أو Windsurf أو عميل stdio آخر.

عرض Markdown

يتيح Local MCP لعميل MCP تشغيل RunAPI MCP Server على جهازك. استخدمه عندما لا يدعم العميل Remote MCP أو عندما تحتاج صراحةً إلى عملية محلية.

قبل أن تبدأ

ثبّت Node.js وتأكد من توفر npx. يجب أن يدعم عميل MCP الخاص بك خوادم stdio المحلية.

كل عميل من العملاء أدناه يُشغّل الأمر ذاته:

SHELL 
npx -y @runapi.ai/mcp

يمكنك الاتصال واستخدام أدوات الكتالوج دون تسجيل الدخول.

Claude Code

شغِّل:

SHELL 
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

استخدم -s user لجعل RunAPI متاحًا عبر مشاريعك. أعد تشغيل Claude Code إذا كان يعمل بالفعل، ثم تأكد من أن RunAPI مُدرج كـ خادم MCP.

المؤشر

أضف الخادم ضمن mcpServers في .cursor/mcp.json أو في تكوين MCP الخاص بمستخدمك:

JSON 
{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}

افتح Customize في الشريط الجانبي لـ Cursor، وابحث عن RunAPI، وفعّله. إن لم تبدأ العملية، افتح لوحة Output وحدد MCP Logs.

VS Code

  1. افتح لوحة الأوامر ونفِّذ MCP: Add Server.
  2. اختر Command (stdio) وأدخل npx -y @runapi.ai/mcp.
  3. سمِّ الخادم RunAPI، واختر نطاق تكوينه، وابدأ تشغيله.
  4. ثق بالخادم عند الطلب. في حالة حدوث أخطاء، نفِّذ MCP: List Servers، وحدد RunAPI، ثم اختر Show Output.

يخزّن VS Code الإعدادات اليدوية تحت المفتاح الرئيسي servers ويستخدم type: "stdio".

Windsurf

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

  1. افتح إعدادات Devin > Cascade > خوادم MCP.
  2. افتح تكوين MCP الخام على المسار ~/.codeium/windsurf/mcp_config.json.
  3. أضف RunAPI باستخدام أمر npx والوسائط الموضحة في مثال Cursor أعلاه.
  4. احفظ الملف، وأعد تحميل خوادم MCP، وفعِّل RunAPI.

عملاء MCP آخرون

أضف خادم stdio محلياً باسم RunAPI. اضبط أمره على npx ووسائطه على -y و@runapi.ai/mcp. أعد تشغيل العميل أو أعد تحميله بعد حفظ التكوين.

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

اسأل عميلك:

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

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

سجِّل الدخول عند الحاجة

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

إذا كنت تفضل تسجيل الدخول من الطرفية، ثبّت RunAPI CLI وشغّل:

SHELL 
runapi login

للعملاء بلا واجهة أو عملاء CI، اتبع دليل المصادقة لإنشاء مفتاح API قياسي مخصص، ثم قدّمه بوصفه RUNAPI_API_KEY من خلال بيئة العميل أو إعداد الأسرار. يكون للمفتاح البيئي الأولوية على بيانات الاعتماد المحفوظة بواسطة Local MCP Login.

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

  • npx غير موجود: تأكد من أن node --version وnpx --version يعملان، ثم أعد تشغيل عميل MCP بالكامل لكي يستقبل البيئة المحدّثة.
  • ينتهي الخادم المحلي فوراً: شغّل npx -y @runapi.ai/mcp في طرفية، وصحّح خطأ Node.js أو الحزمة المُبلَّغ عنه، ثم أعد تشغيل العميل.
  • لا تظهر أدوات RunAPI: تأكد من تفعيل الخادم ومن أن الأمر يستخدم stdio، ثم راجع سجل العميل الموضح أعلاه.
  • فشل أداة مُصادَق عليها: اطلب من العميل استدعاء أداة login. إذا كان RUNAPI_API_KEY مضبوطاً، فحدّثه أو احذفه قبل إعادة محاولة تسجيل الدخول عبر Local MCP.

هل تفضّل اتصالاً بدون عملية Node.js محلية؟ أعدّ Hosted MCP.