🤖 توثيق Wawp الجاهز للذكاء الاصطناعي (MCP)

في Wawp، نؤمن بأن التوثيق يجب أن يكون ذكياً بقدر الكود الذي يصفه. لهذا السبب، قمنا بتنفيذ بروتوكول Model Context Protocol (MCP)، الذي يتيح لك ربط توثيقنا الكامل مباشرة بأدوات تطوير البرمجيات المدعومة بالذكاء الاصطناعي.

🚀 ما هو MCP؟

بروتوكول سياق النموذج (MCP) هو معيار مفتوح يتيح لنماذج الذكاء الاصطناعي (مثل Claude أو GPT-4 أو تلك الموجودة داخل Cursor) الوصول بشكل آمن وموثوق إلى مصادر البيانات الخارجية. بدلاً من نسخ ولصق التوثيق، يمكن للذكاء الاصطناعي "سؤال" خادمنا عن المعلومات الدقيقة التي يحتاجها.

🛠️ كيفية استخدام سيرفر Wawp MCP

يمكنك تشغيل سيرفر Wawp MCP محلياً لمنح الذكاء الاصطناعي الخاص بك السياق الكامل لـ WhatsApp API الخاص بنا.

1. المتطلبات الأساسية

• Node.js (نسخة LTS): ضروري لتشغيل السيرفر. يمكنك تحميله من nodejs.org.
• برنامج يدعم MCP: (مثل Cursor أو Windsurf أو Claude Desktop).

[!IMPORTANT] إذا واجهت خطأ مثل executable file not found in %path% فهذا يعني أن Node.js غير مثبت، أو أنك بحاجة لإعادة تشغيل البرنامج بعد التثبيت.

2. ربط سيرفر Wawp بأدواتك المفضلة

اتبع هذه الخطوات البسيطة حسب البرنامج الذي تستخدمه:

🖱️ تطبيق Cursor

انتقل إلى Settings > Cursor Settings > Models > MCP وأضف أداة جديدة:

• الاسم: wawp-api
• النوع: command
• الأمر:

npx -y @wawp/mcp-server@latest

🌊 تطبيق Windsurf

انتقل إلى Windsurf Settings (Cmd+,) > MCP > Add Server:

• الاسم: wawp-api
• النوع: command
• الأمر:

npx -y @wawp/mcp-server@latest

🤖 تطبيق Claude Desktop

افتح ملف claude_desktop_config.json وأضف الكود التالي:

{
  "mcpServers": {
    "wawp": {
      "command": "npx",
      "args": ["-y", "@wawp/mcp-server@latest"]
    }
  }
}

🚀 وكلاء الذكاء الاصطناعي (Antigravity / Cortex / إلخ)

إذا كنت تستخدم وكيلاً يعمل عبر سطر الأوامر أو نظام AI مخصص، استخدم هذا الأمر لتشغيل السيرفر:

npx -y @wawp/mcp-server@latest

⚡ تعزيز قدرات الذكاء الاصطناعي (وكيل API)

امنح ذكاءك الاصطناعي معرفة متعمقة بـ Wawp WhatsApp API عبر تثبيت قواعد الوكيل و مهارة التكامل مع الـ API مباشرةً في مشروعك. فقط قل للذكاء الاصطناعي:

"استخدم أداة install_agent_config لتجهيز مشروعي وفق معايير Wawp."

سيقوم هذا الإجراء بإنشاء:

1. .cursorrules: قواعد صارمة لإدارة الاعتمادات بأمان، تنسيق chatId الصحيح، معالجة الأخطاء، ومنع الرسائل المزعجة.
2. .agent/skills/wawp-api-integration: دليل تقني شامل يغطي جميع نقاط النهاية، معالجة Webhooks، الرسائل التفاعلية، وأمثلة كود Node.js.

🔍 الأدوات المتاحة

بمجرد الاتصال، سيكون لدى الذكاء الاصطناعي إمكانية الوصول إلى:

1. search_docs: البحث عن نقاط النهاية لمهام محددة (مثل "كيف أرسل ملف PDF؟").
2. list_endpoints: رؤية كافة التصنيفات والإجراءات المتاحة.
3. get_endpoint_details: الحصول على مسودات JSON الدقيقة، والبارامترات المطلوبة، وأمثلة الاستجابة لأي نقطة نهاية.
4. set_config: تهيئة رقم المثيل (instance_id)، ورمز الوصول، ورقم الاختبار للجلسة الحالية.
5. execute_request: تنفيذ طلبات برمجية حقيقية مباشرة من محادثة الذكاء الاصطناعي (يتم تسجيلها في السجل باسم MCP).
6. get_session_health: فحص حالة اتصال مثيل واتساب الخاص بك فورياً.
7. send_local_file: إرسال ملف (صورة، PDF، إلخ) مباشرة من جهاز الكمبيوتر المحلي الخاص بك.
8. generate_starter_code: الحصول على كود برمجي جاهز للعمل لأي مهمة تطلبها.
9. install_agent_config: تثبيت إعدادات Wawp الاحترافية في مشروعك بضغطة واحدة.

🔑 كيفية إدخال بيانات الاعتماد الخاصة بك

لتمكين الذكاء الاصطناعي من تنفيذ طلبات حقيقية، يجب عليك تزويده بتفاصيل الـ API الخاصة بك. يمكنك القيام بذلك ببساطة عن طريق إخبار الذكاء الاصطناعي:

"قم بإعداد تهيئة Wawp الخاصة بي: رمز الوصول هو YOUR_TOKEN، ومعرف المثيل هو YOUR_INSTANCE، ورقم الاختبار هو YOUR_NUMBER."

سيرفع الذكاء الاصطناعي هذه البيانات باستخدام أداة set_config ليحفظها طوال مدة المحادثة. يمكنك العثور على رمز الوصول ومعرف المثيل في لوحة تحكم Wawp.

📄 الإعداد التلقائي (ملف .env)

يمكنك أيضاً إنشاء ملف .env في مجلد مشروعك لتحميل بيانات الاعتماد تلقائياً:

WAWP_ACCESS_TOKEN=your_token_here
WAWP_INSTANCE_ID=your_instance_id
WAWP_TEST_NUMBER=recipient_number

🗺️ مهمتك الأولى باستخدام الذكاء الاصطناعي

إذا لم تكن قد كتبت كوداً من قبل، فلا تقلق. إليك كيف تبدأ:

1. ربط الـ MCP: اتبع الخطوات الموضحة في القسم الثاني.
2. أعطِ السياق: قل للذكاء الاصطناعي: "أريد إرسال رسالة ترحيب لعملائي. استخدم بيانات Wawp الخاصة بي."
3. توليد الكود: قل للذكاء الاصطناعي: "استخدم أداة generate_starter_code لكتابة كود Node.js يرسل كلمة 'أهلاً' لرقم الاختبار الخاص بي."
4. التنفيذ: سيعطيك الذكاء الاصطناعي الكود كاملاً. فقط قم بنسخه وتشغيله!

💡 لماذا تستخدم هذا؟

• بدون تخمين: سيستخدم الذكاء الاصطناعي دائماً البارامترات والأنواع الصحيحة.
• توفير الوقت: لا داعي للتنقل بين محرر الكود وموقع التوثيق.
• القيادة الذاتية: استفد من مهارات نظام التصميم لبناء واجهات تطابق Wawp تماماً.

💾 التصدير والتحميل

هل تحتاج إلى مواصفات الـ API الكاملة لأدواتك الخاصة؟ قم بزيارة صفحة تصدير البيانات لتحميل Wawp API بتنسيقات OpenAPI أو Markdown أو HTML.