Claude Bridge – إضافة WordPress

Claude Bridge إضافة لـ WordPress توفّر واجهة REST API آمنة تتيح لـ Claude (عبر خادم MCP محلي) قراءة ملفات القالب وتعديلها، وإدارة الإضافات والخيارات ومكتبة الوسائط وقاعدة بيانات موقعك. تسبق كلَّ عملية كتابة نسخةٌ احتياطية تلقائية وتحققٌ من صحة صياغة PHP.

الإصدار 1.0.0 · WordPress 5.6 أو أحدث · PHP 7.4 أو أحدث · رخصة GPL-2.0+ · Synaptic CRM Dev Team

المزايا

تجمع Claude Bridge وظائفها في سبع أدوات يمكنك تفعيل كل منها أو تعطيلها على حدة:

• القالب: عرض ملفات القالب النشط وقراءتها وإنشاؤها وتعديلها، بما في ذلك التعديلات الموضعية (إدراج أو استبدال أو حذف حسب السطر أو حسب نص مرجعي).
• الإضافات: عرض الإضافات والبحث عنها وتثبيتها وتفعيلها وتعطيلها وتحديثها.
• شيفرة الإضافات: قراءة الشيفرة المصدرية للإضافات المثبتة وتعديلها (Claude Bridge نفسها محمية).
• الخيارات: قراءة خيارات WordPress والبحث فيها وتعديلها.
• قاعدة البيانات: عرض الجداول وتنفيذ استعلامات للقراءة فقط. تتطلب الكتابة عبر SQL أيضًا الثابت CLAUDE_BRIDGE_ALLOW_SQL_WRITE في ملف wp-config.php.
• مكتبة الوسائط: رفع الصور (الشعارات والرسوم…) مع نص بديل وربطها بمقالة.
• النسخ الاحتياطية: عرض النسخ المنشأة تلقائيًا قبل كل تعديل واستعادتها.

تُرسَل الملفات الكبيرة على عدة أجزاء مع تحقق من سلامتها بخوارزمية SHA-256.

الأمان

• الوصول مقتصر على حسابات المديرين، مع المصادقة بكلمة مرور تطبيق مخصّصة في WordPress (وليس كلمة المرور المعتادة أبدًا).
• بروتوكول HTTPS إلزامي: يظهر تنبيه في لوحة الإدارة إذا لم يكن الموقع يستخدم SSL.
• ثلاث أدوات فقط مفعّلة افتراضيًا (القالب، الإضافات، الخيارات). الأداة المعطّلة تُرجع خطأ 403 على جميع مساراتها، حتى مع بيانات اعتماد صحيحة.
• نسخة احتياطية تلقائية قبل كل تعديل، وتحقق من صياغة PHP قبل الكتابة.
• تبقى عمليات SQL الأكثر خطورة (DROP DATABASE وGRANT وCREATE USER وحذف الجداول الأساسية لـ WordPress…) ممنوعة دائمًا.

التثبيت

الخيار أ: من ملف ZIP (الأسهل)

1. نزّل ملف ZIP بالزر أعلاه (يحتوي مسبقًا على المجلد claude-bridge، فلا تفكّ ضغطه).
2. سجّل الدخول إلى لوحة إدارة WordPress: https://your-site.tld/wp-admin.
3. في القائمة الجانبية، انقر على الإضافات ثم أضف إضافة جديدة.
4. في أعلى الصفحة، انقر على رفع إضافة.
5. انقر على اختيار ملف، وحدّد ملف ZIP الذي نزّلته، ثم انقر على التنصيب الآن.
6. بعد انتهاء التثبيت، انقر على تفعيل الإضافة.

الخيار ب: بنقل الملفات (FTP أو SFTP أو مدير الملفات)

1. فكّ ضغط الأرشيف وانسخ المجلد claude-bridge كما هو إلى wp-content/plugins/claude-bridge/.
2. في لوحة إدارة WordPress، افتح الإضافات ثم الإضافات المنصّبة.
3. ابحث عن Claude Bridge في القائمة وانقر على تفعيل أسفل اسمها.

الإعداد: اختيار الأدوات المسموح بها

افتح الإعدادات ثم Claude Bridge. لكل أداة خانة اختيار خاصة بها:

• القالب: مفعّلة افتراضيًا
• الإضافات: مفعّلة افتراضيًا
• شيفرة الإضافات: معطّلة افتراضيًا (محفوفة بالمخاطر)
• الخيارات: مفعّلة افتراضيًا
• قاعدة البيانات: معطّلة افتراضيًا (وصول مباشر عبر SQL)
• مكتبة الوسائط: معطّلة افتراضيًا
• النسخ الاحتياطية: معطّلة افتراضيًا

حدّد الأدوات التي تحتاجها فقط، ثم انقر على حفظ. يمكنك العودة إلى هذه الصفحة في أي وقت.

إنشاء كلمة مرور تطبيق

لا تعمل Claude Bridge بكلمة المرور المعتادة للحساب. يجب إنشاء كلمة مرور تطبيق مخصّصة، بحساب مدير، على موقع يستخدم HTTPS.

1. في لوحة الإدارة، انقر على اسمك أعلى الصفحة (أو على الأعضاء ثم الملف الشخصي).
2. مرّر إلى قسم كلمات مرور التطبيقات في أسفل الصفحة.
3. أدخل اسمًا يساعدك على تمييزها، مثل Claude Bridge.
4. انقر على إضافة كلمة مرور تطبيق جديدة.
5. يعرض WordPress كلمة المرور مرة واحدة فقط (4 مجموعات من 4 أحرف). انسخها فورًا إلى مدير كلمات المرور.

المعلومات التي يجب تقديمها لخادم MCP المحلي (أو للأداة التي تستدعي الواجهة البرمجية):

• عنوان الموقع: https://your-site.tld
• اسم المستخدم: اسم الدخول إلى WordPress
• كلمة المرور: كلمة مرور التطبيق المنشأة (وليست كلمة مرورك المعتادة)

اختبار الاتصال (اختياري)

curl -u "your_username:xxxx xxxx xxxx xxxx" 
     https://your-site.tld/wp-json/claude-bridge/v1/info

إذا كان كل شيء صحيحًا، يُرجع الأمر ملف JSON يتضمن إصدار الإضافة وإصدار WordPress والقالب النشط.

لإلغاء الوصول لاحقًا، عُد إلى صفحة ملفك الشخصي، قسم كلمات مرور التطبيقات، وانقر على إلغاء بجانب كلمة المرور «Claude Bridge».