دليل إعداد MCP

اربط eWasl بمساعدك الذكي في أقل من دقيقة.

المتطلبات

  • حساب eWasl مع حساب اجتماعي واحد متصل على الأقل
  • مفتاح API من إعدادات eWasl
  • خطة المهنية أو المؤسسات (تشمل API و MCP)

1. Claude Code (CLI)

أضف هذا إلى ملف ~/.claude/settings.json:

{
  "mcpServers": {
    "ewasl": {
      "type": "http",
      "url": "https://app.ewasl.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ewasl_YOUR_API_KEY"
      }
    }
  }
}

2. Claude Desktop

يستخدم Claude Desktop نقل stdio. أضف هذا إلى ملف claude_desktop_config.json:

{
  "mcpServers": {
    "ewasl": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.ewasl.com/api/mcp",
        "--header",
        "Authorization: Bearer ewasl_YOUR_API_KEY"
      ]
    }
  }
}

يستخدم جسر mcp-remote لتحويل نقل HTTP إلى stdio. تأكد من تثبيت Node.js 18+.

3. Cursor / عملاء MCP الآخرون

أي عميل متوافق مع MCP يمكنه الاتصال باستخدام نقل HTTP:

تفاصيل الاتصال
نقطة النهايةhttps://app.ewasl.com/api/mcp
النقلHTTP with SSE (Streamable HTTP)
رأس المصادقةAuthorization: Bearer ewasl_YOUR_API_KEY

4. واجهة REST API المباشرة

يمكنك أيضاً استخدام واجهة V1 API مباشرة من أي عميل HTTP. جميع أدوات MCP تتطابق مع نقاط النهاية REST.

# Create a post
curl -X POST https://app.ewasl.com/api/v1/posts \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from eWasl API!",
    "accountIds": ["your-account-id"],
    "publishNow": true
  }'

# List your posts
curl https://app.ewasl.com/api/v1/posts?limit=10 \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

# Get analytics
curl "https://app.ewasl.com/api/v1/analytics?timeframe=30d" \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

# List connected accounts
curl https://app.ewasl.com/api/v1/connections \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

أمثلة أوامر سريعة

أمثلة على ما يمكنك طلبه من مساعدك الذكي بعد الاتصال.

Ask

انشر "رسالتك" على تويتر ولينكد إن.

Result

ينشئ وينشر فوراً.

Ask

جدوِل منشوراً لغداً الساعة 9 صباحاً على جميع حسابي.

Result

ينشئ منشوراً مجدولاً.

Ask

أظهر لي جميع حساباتي الاجتماعية المتصلة.

Result

يعرض جميع الاتصالات مع الحالة.

Ask

ما المنشورات التي نشرتها الأسبوع الماضي؟

Result

يعرض المنشورات الأخيرة مع الفلاتر.

Ask

أظهر لي تحليليات آخر 30 يوماً.

Result

يرجع بيانات الأداء.

Ask

احذف المنشور المجدول للغد.

Result

يحذف منشوراً مجدولاً.

مرجع الأدوات (11 أداة)

جميع الأدوات المتاحة من خلال تكامل MCP.

المنشورات

الأداةالطريقة
create_postPOST
list_postsGET
schedule_postPOST
get_postGET
update_postPATCH
delete_postDELETE
publish_postPOST

الاتصالات

الأداةالطريقة
list_connectionsGET

التحليلات

الأداةالطريقة
get_analyticsGET
sync_analyticsPOST

الوسائط

الأداةالطريقة
list_mediaGET

معلمات create_post

contentstringمطلوب
المحتوى النصي للمنشور (بحد أقصى 63,206 حرف).
accountIdsstring[]مطلوب
مصفوفة معرفات الحسابات الاجتماعية للنشر عليها.
publishNowboolean
إذا كان true، ينشر فوراً. الافتراضي: false.
isDraftboolean
إذا كان true، يحفظ كمسودة. الافتراضي: false.
scheduledAtstring
تاريخ ووقت ISO 8601 للنشر المجدول.
mediaUrlsstring[]
مصفوفة روابط الوسائط العامة (بحد أقصى 10).
platformCaptionsobject
تعليقات لكل منصة: { "twitter": "...", "linkedin": "..." }.
tiktokSettingsobject
إعدادات تيك توك: مستوى الخصوصية، تعطيل الدويتو، إلخ.
youtubeTitlestring
عنوان منفصل لمنشورات يوتيوب (بحد أقصى 100 حرف).

أكواد الأخطاء

كيفية التعامل مع استجابات الأخطاء من API.

400 Bad Request

جسم طلب غير صالح أو معلمات خاطئة. تحقق من صيغة JSON والحقول المطلوبة.

401 Unauthorized

مفتاح API غير صالح أو مفقود. تأكد من تضمين "Authorization: Bearer ewasl_YOUR_KEY".

403 Forbidden

خطتك لا تشمل وصول API/MCP. يتطلب المهنية ($49/شهر) أو المؤسسات ($99/شهر).

404 Not Found

المورد غير موجود. تحقق من معرف المنشور أو معرف الاتصال.

429 Too Many Requests

تم تجاوز حد الاستخدام. انتظر وأعد المحاولة. تحقق من رأس Retry-After.

500 Internal Server Error

خطأ في الخادم. يرجى المحاولة مرة أخرى. إذا استمرت المشكلة، تواصل مع الدعم.

صلاحيات مفتاح API

عند إنشاء مفتاح API، قم بتعيين الصلاحيات المطلوبة لحالة استخدامك:

الصلاحيةيسمح بـ
posts:readعرض المنشورات وتفاصيلها
posts:createإنشاء وجدولة ونشر المنشورات

حدود الاستخدام

طلبات V1 API محدودة لكل مفتاح API. عند التجاوز، ستتلقى استجابة 429 مع رأس Retry-After.

حل المشاكل

يظهر خطأ 401 Unauthorized

تأكد من نسخ مفتاح API الكامل من إعدادات eWasl. يجب أن يبدأ بـ "ewasl_".

يظهر خطأ 403 Forbidden

يتطلب وصول API/MCP خطة المهنية أو المؤسسات. قم بترقية خطتك.

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

تحقق من صحة عنوان URL في الإعدادات. يجب أن يكون: https://app.ewasl.com/api/mcp

المنشور لم ينشر

تحقق من أن حسابك الاجتماعي متصل وصلاحية الرمز. استخدم list_connections للتحقق.

للتوثيق الكامل لنقاط النهاية وأنماط الطلب والاستجابة: