دليل إعداد 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/mcpAuthorization: Bearer ewasl_YOUR_API_KEY4. واجهة 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"أمثلة أوامر سريعة
أمثلة على ما يمكنك طلبه من مساعدك الذكي بعد الاتصال.
انشر "رسالتك" على تويتر ولينكد إن.
ينشئ وينشر فوراً.
جدوِل منشوراً لغداً الساعة 9 صباحاً على جميع حسابي.
ينشئ منشوراً مجدولاً.
أظهر لي جميع حساباتي الاجتماعية المتصلة.
يعرض جميع الاتصالات مع الحالة.
ما المنشورات التي نشرتها الأسبوع الماضي؟
يعرض المنشورات الأخيرة مع الفلاتر.
أظهر لي تحليليات آخر 30 يوماً.
يرجع بيانات الأداء.
احذف المنشور المجدول للغد.
يحذف منشوراً مجدولاً.
مرجع الأدوات (11 أداة)
جميع الأدوات المتاحة من خلال تكامل MCP.
المنشورات
| الأداة | الطريقة | نقطة النهاية | الوصف |
|---|---|---|---|
create_post | POST | /api/v1/posts | إنشاء أو جدولة أو نشر منشور على الحسابات المتصلة. |
list_posts | GET | /api/v1/posts | عرض المنشورات مع التصفح. فلترة حسب الحالة أو المنصة. |
schedule_post | POST | /api/v1/posts/schedule | جدولة منشور للنشر المستقبلي مع توزيع متداخل. |
get_post | GET | /api/v1/posts/:id | الحصول على منشور واحد بالمعرف. يشمل الحالة والمنصات والوسائط. |
update_post | PATCH | /api/v1/posts/:id | تحديث منشور مجدول — التعليق أو الوقت أو المنصات. |
delete_post | DELETE | /api/v1/posts/:id | حذف منشور مجدول أو مسودة. لا يمكن حذف المنشورات المنشورة. |
publish_post | POST | /api/v1/posts/:id/publish | انشر منشوراً مسودة فوراً. ينشر على جميع الحسابات المرتبطة بالمنشور. |
الاتصالات
| الأداة | الطريقة | نقطة النهاية | الوصف |
|---|---|---|---|
list_connections | GET | /api/v1/connections | عرض جميع الحسابات الاجتماعية المتصلة مع الحالة ومعلومات المنصة. |
التحليلات
| الأداة | الطريقة | نقطة النهاية | الوصف |
|---|---|---|---|
get_analytics | GET | /api/v1/analytics | الحصول على أداء المنشور: المشاهدات، الإعجابات، التعليقات، المشاركات عبر المنصات. |
sync_analytics | POST | /api/v1/analytics/sync | تشغيل مزامنة يدوية للتحليلات من المنصات. محدود لمرة كل 5 دقائق. |
الوسائط
| الأداة | الطريقة | نقطة النهاية | الوصف |
|---|---|---|---|
list_media | GET | /api/v1/media | عرض ملفات الوسائط المحملة في مكتبتك. |
معلمات create_post
contentstringمطلوبaccountIdsstring[]مطلوبpublishNowbooleanisDraftbooleanscheduledAtstringmediaUrlsstring[]platformCaptionsobjecttiktokSettingsobjectyoutubeTitlestringأكواد الأخطاء
كيفية التعامل مع استجابات الأخطاء من API.
جسم طلب غير صالح أو معلمات خاطئة. تحقق من صيغة JSON والحقول المطلوبة.
مفتاح API غير صالح أو مفقود. تأكد من تضمين "Authorization: Bearer ewasl_YOUR_KEY".
خطتك لا تشمل وصول API/MCP. يتطلب المهنية ($49/شهر) أو المؤسسات ($99/شهر).
المورد غير موجود. تحقق من معرف المنشور أو معرف الاتصال.
تم تجاوز حد الاستخدام. انتظر وأعد المحاولة. تحقق من رأس Retry-After.
خطأ في الخادم. يرجى المحاولة مرة أخرى. إذا استمرت المشكلة، تواصل مع الدعم.
صلاحيات مفتاح 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 للتحقق.
للتوثيق الكامل لنقاط النهاية وأنماط الطلب والاستجابة: