Pipedrive MCP: الاستعلام عن CRM وتغييره حسب مستوى الأمان

لمن يناسب

إن أردت الاستعلام عن بيانات CRM Pipedrive أو إنشاءها أو تحديثها مباشرة في Claude Code أو Claude Desktop، فهذه الخدمة تناسبك. هو خادم MCP للاستخدام المحلي أو المستضاف ذاتياً، والمصادقة بمفتاح Pipedrive API.

يناسب من لديه حساب Pipedrive ومفتاح API بالفعل، ويستطيع عميله تشغيل MCP عبر STDIO. النص الرسمي يقول إن النقل حالياً STDIO فقط بلا OAuth مستضاف. إن احتجت وصول HTTP بعيد أو تسجيل دخول OAuth، فلا يوجد في هذه الصفحة مسار صالح.

يجب أن يكون اسم الحزمة ذا النطاق @ckalima/pipedrive-mcp-server. النص الرسمي صريح: إن اقتبس مقطع قديم pipedrive-mcp-server بلا نطاق، فتلك حزمة أخرى بلا صلة؛ لا تثبّتها بالخطأ.

إنهاء المحاولة الأولى في 3 دقائق

المسار الرسمي الموصى به هو تثبيت موجَّه. المتطلبات المسبقة: جهّز مفتاح Pipedrive API، واختر العميل Claude Code أو Claude Desktop، والنقل STDIO فقط.

في الطرفية نفّذ:

npx -y @ckalima/pipedrive-mcp-server init

اتبع الإرشاد لكتابة الخادم في إعداد العميل. إن وجب تعديل الإعداد يدوياً، فالأمر npx والوسائط -y و@ckalima/pipedrive-mcp-server، وضَع PIPEDRIVE_API_KEY في البيئة. لا تكتب أي سلسلة مفتاح مثال ولا تستخدم اسم الحزمة بلا نطاق.

في المحاولة الأولى اضبط PIPEDRIVE_MODE على read-only. النص الرسمي يعرّف هذا المستوى بأنه قراءة فقط؛ المستوى الافتراضي safe-write يتضمن بالفعل كتابات غير مدمّرة ولا يناسب المرة الأولى.

ثم نفّذ استدعاء منخفض المخاطر مرة واحدة: استعلم عن بيانات CRM. النص الرسمي يقول إنه يمكن من المساعد Query, create, and update CRM data؛ المحاولة الأولى تقتصر على Query. النص الرسمي لا يعطي اسم أداة محدد ولا نوع كائن. استخدم فقط أدوات الاستعلام التي يسردها العميل لهذا الخادم. لا تختلق أسماء أدوات لم تظهر، ولا تنشئ سجلات ولا تحدّثها.

إشارة النجاح: تعود نتيجة استعلام لسجلات موجودة في Pipedrive بلا كتابة. إن اختفت أدوات الكتابة في المستوى الحالي فذلك يوافق النص الرسمي: الأدوات خارج المستوى تُخفى والاستدعاء المباشر يُرفض.

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

الحالة الأولى: استعلام CRM للقراءة فقط. اضبط PIPEDRIVE_MODE على read-only ثم استعلم عن بيانات موجودة. النص الرسمي يصل فقط إلى Query CRM data بلا كائنات أو عوامل تصفية أو صفحات. عند النجاح يجب أن ترى سجلات موجودة؛ لا تعامل استعلاماً واحداً كتصدير بيانات كامل.

الحالة الثانية: إنشاء سجلات أو تحديثها في المستوى الافتراضي safe-write. النص الرسمي يقول إن المستوى الافتراضي قراءة مع كتابات غير مدمّرة، ويقابل create وupdate. هذا يغيّر CRM؛ قبل الاستدعاء أكّد أي بيان عمل ستغيّره. النص الرسمي لا يعطي قائمة حقول ولا حمولة مثال. استخدم فقط قدرة الإنشاء أو التحديث التي يعرضها العميل، وأعد صياغة ما سيُكتب قبل التنفيذ. Deletes وconversions وغيرها من irreversible writes ليست في هذا المستوى؛ النص الرسمي يطلب مستوى full لفتحها.

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

لـ PIPEDRIVE_MODE مستويات read-only وsafe-write (افتراضي) وfull. الأدوات خارج المستوى لا تظهر في قائمة الأدوات والاستدعاء المباشر يُرفض. Deletes وconversions وغيرها من irreversible writes تحتاج full؛ لا تفتح هذا المستوى في المحاولة الأولى.

النقل حالياً STDIO فقط؛ Streamable HTTP مجرد علامة مخططة ولا يمكن اعتباره مقدَّماً في هذه الصفحة. المصادقة مفتاح Pipedrive API بلا OAuth مستضاف. المفتاح في متغير بيئة محلي؛ الاستعلام والكتابة يخرجان إلى الشبكة نحو Pipedrive.

النص الرسمي لا يكتب حدود معدل ولا سحباً. إن نجحت كتابة فعليك إرجاعها بنفسك في Pipedrive. استخدام اسم الحزمة بلا نطاق pipedrive-mcp-server هو، حسب النص الرسمي، حزمة أخرى بلا صلة.