---
title: Local MCP | RunAPI
description: شغِّل RunAPI MCP Server محلياً مع Claude Code أو Cursor أو VS Code أو
  Windsurf أو عميل stdio آخر.
url: https://runapi.ai/ar/docs/resources/mcp/local.md
canonical: https://runapi.ai/ar/docs/resources/mcp/local
locale: ar
---

> نسخة HTML: https://runapi.ai/ar/docs/resources/mcp/local
> فهرس الموقع للوكلاء: https://runapi.ai/llms.txt

# Local MCP

يتيح 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](https://runapi.ai/ar/docs/resources/cli.md) وشغّل:

```shell
runapi login
```

للعملاء بلا واجهة أو عملاء CI، اتبع [دليل
المصادقة](https://runapi.ai/ar/docs/guides/authentication.md) لإنشاء مفتاح 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](https://runapi.ai/ar/docs/resources/mcp/hosted.md).

---

## المزيد من RunAPI

- [الرئيسية](https://runapi.ai/ar/.md)
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models)
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [فهرس الموقع للوكلاء](https://runapi.ai/llms.txt)

التواصل: contact@runapi.ai

## البيانات المنظمة

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "TechArticle",
    "headline": "Local MCP",
    "description": "شغِّل RunAPI MCP Server محلياً مع Claude Code أو Cursor أو VS Code أو Windsurf أو عميل stdio آخر.",
    "url": "https://runapi.ai/ar/docs/resources/mcp/local",
    "mainEntityOfPage": "https://runapi.ai/ar/docs/resources/mcp/local"
  }
]
```