ربط كلود بقاعدة بيانات PostgreSQL عبر MCP — دليل عملي

تخيّل أنك تفتح كلود وتكتب: "كم عميل اشترى منتج X هذا الشهر؟" — وكلود يذهب لقاعدة بياناتك، يكتب الاستعلام، يُنفّذه، ويُجيبك بأرقام حقيقية من بياناتك الفعلية. هذا بالضبط ما يُتيحه PostgreSQL MCP.

MCP أو Model Context Protocol هو البروتوكول الذي طوّرته Anthropic ليُتيح لكلود التواصل مع أدوات وخدمات خارجية بشكل مباشر وآمن. وخادم PostgreSQL MCP هو أحد أكثر هذه الخوادم استخداماً وطلباً، لأن قواعد البيانات موجودة في كل شركة وكل مشروع.

ما هو MCP وكيف يعمل؟

MCP هو بروتوكول اتصال قياسي — مثل USB تماماً لكن للـ AI. بدلاً من بناء تكامل خاص لكل أداة، MCP يُحدد طريقة موحدة لأي أداة أو خدمة للتواصل مع نماذج الذكاء الاصطناعي مثل كلود.

الفكرة بسيطة: هناك خادم MCP يعمل على جهازك، هذا الخادم يعرف كيف يتحدث مع PostgreSQL. كلود يتواصل مع هذا الخادم، والخادم يُنفّذ الاستعلامات ويُرجع النتائج لكلود. أنت تكتب بالعربية الطبيعية — كلود يتولى الباقي.

لماذا PostgreSQL تحديداً؟ لأنه قاعدة البيانات الأكثر استخداماً في التطبيقات الحديثة. Laravel وDjango وRails وNext.js — كلها تعمل مع PostgreSQL بشكل ممتاز. وخادم MCP الخاص به من أكثر الخوادم استقراراً واختباراً في النظام البيئي كله.

المتطلبات قبل البدء

تثبيت خادم PostgreSQL MCP

الخادم يُشغَّل تلقائياً عبر npx — لا تثبيت دائم مطلوب:

# تحقق أن npx يعمل
npx --version

# اختبر الخادم مباشرة (اختياري)
npx -y @modelcontextprotocol/server-postgres postgresql://user:password@localhost/dbname

إعداد ملف claude_desktop_config.json

هذا الملف هو قلب الإعداد كله. افتحه من مسار:

على Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

على Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "postgresql": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://your_user:your_password@localhost:5432/your_database"
      ]
    }
  }
}

استبدل البيانات بمعلومات قاعدة بياناتك الفعلية، ثم أغلق Claude Desktop وأعد تشغيله.

التحقق من الربط

بعد إعادة تشغيل Claude Desktop، افتح محادثة جديدة. في أسفل نافذة الإدخال ستجد أيقونة المقبس أو قائمة الأدوات — انقر عليها ستجد postgresql مُدرجاً.

اكتب لكلود: "اعرض لي قائمة الجداول الموجودة في قاعدة البيانات". إذا أجابك بقائمة الجداول الفعلية، الربط نجح.

الاستعلام بالعربية الطبيعية

هذا هو الجزء الممتع. لا تحتاج أن تعرف SQL. فقط اكتب ما تريده:

أمثلة استعلامات حقيقية:

"كم طلب استلمناه هذا الأسبوع؟"
"من هم أكثر 10 عملاء شراءً هذا الشهر؟"
"ما متوسط قيمة الطلب خلال آخر 30 يوم؟"
"أعطني قائمة المنتجات التي مخزونها أقل من 10 قطع"
"قارن مبيعات هذا الشهر بنفس الشهر من العام الماضي"
"ما نسبة الطلبات المُلغاة إلى الإجمالي؟"

كلود سيكتب استعلام SQL المناسب، يُنفّذه، ويُقدّم لك النتائج مع تحليل إذا طلبت.

استكشاف بنية قاعدة البيانات

واحدة من أقوى مزايا PostgreSQL MCP هي قدرة كلود على فهم بنية قاعدة بياناتك كاملة:

الأوامر المفيدة لاستكشاف البنية:

"اعرض لي بنية جدول orders بالتفصيل"
"ما العلاقات بين جدول users وجدول orders؟"
"اشرح لي بنية قاعدة البيانات هذه — ما الغرض من كل جدول؟"
"هل هناك indexes على هذا الجدول؟"
"ما الأعمدة المطلوبة وغير المطلوبة في جدول products؟"

كلود يستخدم معلومات schema لكتابة استعلامات أكثر دقة وتجنب الأخطاء.

تحليل البيانات المتقدم

لا تتوقف عند الاستعلامات البسيطة. كلود يستطيع إجراء تحليلات معقدة:

تحليلات متقدمة مع كلود:

"حلّل اتجاهات المبيعات خلال آخر 6 أشهر وأخبرني بالأنماط"
"ما المنتجات التي ارتفعت مبيعاتها ومن انخفضت خلال الربع الأخير؟"
"اعمل cohort analysis للعملاء الذين اشتركوا في يناير"
"ما العملاء المعرّضون للإلغاء بناءً على نمط استخدامهم؟"
"أعطني funnel analysis من التسجيل لأول شراء"

أفضل ممارسات الأمان

قبل أي شيء: لا تُعطِ كلود وصولاً كاملاً لقاعدة البيانات الإنتاجية. إليك الطريقة الصحيحة:

-- أنشئ مستخدماً بصلاحيات قراءة فقط
CREATE USER claude_readonly WITH PASSWORD 'strong_password_here';

-- امنحه قراءة الجداول التي تريد فقط
GRANT CONNECT ON DATABASE your_database TO claude_readonly;
GRANT USAGE ON SCHEMA public TO claude_readonly;
GRANT SELECT ON TABLE orders, products, customers TO claude_readonly;

-- لا تمنحه: INSERT, UPDATE, DELETE, DROP, CREATE

ثم استخدم بيانات هذا المستخدم في ملف الإعداد:

{
  "mcpServers": {
    "postgresql": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://claude_readonly:strong_password_here@localhost:5432/your_database"
      ]
    }
  }
}

حالة استخدام حقيقية: ربط كلود بقاعدة بيانات عميل

سيناريو واقعي: شركة تجارة إلكترونية متوسطة، قاعدة بياناتهم PostgreSQL على سيرفر Amazon RDS.

المشكلة: المدير التنفيذي يحتاج تقارير يومية لكنه لا يعرف SQL، ولا يوجد مطور متاح لكل سؤال.

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

# connection string للسيرفر البعيد
postgresql://claude_readonly:password@your-rds.amazonaws.com:5432/production_db

# أسئلة المدير اليومية بالعربية:
"كم مبيعات اليوم مقارنة بالأمس؟"
"ما المنتجات الأكثر مبيعاً هذا الأسبوع؟"
"هل هناك طلبات متأخرة لم تُشحن؟"
"أرسل لي ملخص المبيعات الأسبوعي بصيغة جدول"

النتيجة: المدير أصبح مستقلاً في الحصول على البيانات، وفّر ساعات أسبوعياً من وقت فريق التقنية.

ربط قاعدة بيانات محلية للتطوير

للمطورين: ربط قاعدة البيانات المحلية لمشاريع Laravel أو Django:

# Laravel مثلاً — بيانات من ملف .env
postgresql://postgres:password@127.0.0.1:5432/laravel_app

# Django
postgresql://django_user:password@localhost:5432/myapp_dev

# نصيحة: استخدم قاعدة البيانات التجريبية دائماً للتطوير
# وليس الإنتاج

استكشاف الأخطاء الشائعة

الخطأ الأول: "لا أستطيع الاتصال بقاعدة البيانات" — تحقق من أن PostgreSQL يعمل، وأن اسم المستخدم وكلمة المرور صحيحة، وأن الـ port صحيح (5432 افتراضياً).

الخطأ الثاني: خادم MCP لا يظهر في كلود — أعد تشغيل Claude Desktop بالكامل بعد تعديل ملف الإعداد. أحياناً يحتاج إغلاقاً كاملاً ثم فتحاً.

الخطأ الثالث: "npx غير موجود" — تأكد من تثبيت Node.js وإضافته لمسار النظام. جرّب which npx في Terminal.

الجواهر الخمسة — أفكار استخدام متقدمة

الأسئلة الشائعة