# تثبيت SosoAPI: الحزم والعملاء و MCP البعيد

الرابط الأساسي: https://sosoapi.ai/ar/docs/installation

اربط وكيلك بـ SosoAPI باستخدام حزمة محلية أو MCP مستضاف. يغطي الدليل التثبيت وفحوص الاتصال والتحديثات.

## أي حزمة npm ينبغي أن أثبّت؟

للإعداد الجديد ثبّت sosoapi. الحزم @sosoapi/cli و sosoapi-cli و sosoapi-mcp أسماء بديلة تثبّت إصدار sosoapi نفسه تماماً. تشغّل أدوات CLI و MCP نفسها؛ تحتاج حزمة واحدة فقط.

يتطلب MCP المحلي Node.js 20 أوأحدث و npm/npx. لا يحتاج MCP المستضاف إلى حزمة محلية. بعد التثبيت أوالربط، سجّل الدخول لمنح الوصول إلى حساباتك.

توزيعات npm

| الحزمة | الغرض | الأمر |

| --- | --- | --- |

| sosoapi | CLI وخادم MCP الأساسيان | npx -y sosoapi --help |

| @sosoapi/cli | اسم بديل لـ sosoapi بالإصدار نفسه تماماً | npx -y @sosoapi/cli --help |

| sosoapi-cli | اسم بديل لـ sosoapi بالإصدار نفسه تماماً | npx -y sosoapi-cli --help |

| sosoapi-mcp | اسم بديل لـ sosoapi بالإصدار نفسه تماماً | npx -y sosoapi-mcp --help |

- [sosoapi](https://www.npmjs.com/package/sosoapi)

- [@sosoapi/cli](https://www.npmjs.com/package/@sosoapi/cli)

- [sosoapi-cli](https://www.npmjs.com/package/sosoapi-cli)

- [sosoapi-mcp](https://www.npmjs.com/package/sosoapi-mcp)

## ربط عميل MCP محلي

استخدم الأوامر أدناه لإضافة اتصال بملف core. إذا كان SosoAPI متصلاً ويعمل، احتفظ باتصاله. تشغيل sosoapi دون معاملات يبدأ خادم stdio MCP؛ وينتظر العميل على stdin.

لـ Claude Desktop أو Cursor أوعميل stdio آخر، أضف JSON أدناه في إعدادات MCP. يختلف الموقع والموافقة حسب العميل. أعد التشغيل أوالربط عند الحاجة، وتحقق من توفر أدوات SosoAPI بمحادثتك.

```
claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

```
codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi
```

```
{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}
```

- [مرجع أدوات MCP](https://sosoapi.ai/ar/docs/mcp)

## ربط MCP عن بُعد باستخدام OAuth

لعميل يدعم MCP البعيد و OAuth وتسجيل العميل ديناميكياً، أضف URL أدناه. ادخل بالمتصفح واختر المساحات والإجراءات المسموحة. لا تلصق مفتاح API أو client ID أو client secret. للوسائط عبر HTTP، استورد URL عاماً؛ الرفع المحلي يحتاج خادم MCP محلياً.

تعتمد تطبيقات ChatGPT المخصّصة وموصلات Claude البعيدة على خطتك وإعدادات الموصل المتاحة بالعميل. تُعدّ التعليمات اتصالاً مخصّصاً؛ ولا تصف إدراجاً في دليل التطبيقات.

```
https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp
```

- [المصادقة والأذونات](https://sosoapi.ai/ar/docs/authentication)

## التحقّق من الإعداد دون نشر

افحص auth status وسجّل الدخول عند الحاجة. اقرأ سياق المساحة والحسابات المتصلة، ثم أكّد مطابقة المُعادين للمقصودين. يثبت ذلك الوصول دون إرسال منشور؛ ويظل النشر معتمداً على أذونات الحساب.

لا تحتاج إلى نشر اختبار لإكمال الإعداد. واصل مهمتك الأصلية بمحتواها الموجود. يُكمل المستخدم موافقة المزوّد ويراجع الوجهة والمحتوى والوقت قبل أي كتابة مطلوبة.

```
npx sosoapi auth status
```

```
npx sosoapi api contract --route /identity-api/workspace/list --summary
```

## تحديث إصدار أو تثبيته

شغّل npx -y sosoapi@latest --help لجلب CLI الحالي ثم أعِد تشغيل عميل MCP. إن حفظ العميل أمراً، ضع الإصدار المطلوب في args. تظل الأسماء البديلة مرتبطة بإصدار sosoapi المطابق؛ تحديث تثبيت عام منفصل لا يحدّثها.

عند خطأ اختلاف الإصدار، قارن العقد المثبّت بالعملية المطلوبة. حدّث الحزمة في الأمر الذي يستخدمه عميل MCP فعلاً وأعِد الربط وجرّب العملية. اختلاف المخطط لا يحتاج بيانات اعتماد جديدة أووصولاً أوسع.

```
npx -y sosoapi@latest --help
```

```
npx sosoapi api contract --summary
```

- [استكشاف الأخطاء وإصلاحها](https://sosoapi.ai/ar/docs/troubleshooting)