تكامل خادم Salesforce MCP

ماذا يفعل خادم “Salesforce” MCP؟

يعد خادم Salesforce MCP تطبيقًا لبروتوكول Model Context (MCP) يربط مساعدي الذكاء الاصطناعي مثل Claude مع Salesforce. يتيح تفاعلات اللغة الطبيعية مع بيانات وبيانات تعريف Salesforce، مما يسمح للمستخدمين باستعلام وتعديل وإدارة كائنات وسجلات Salesforce بسلاسة. من خلال إتاحة واجهات برمجة تطبيقات Salesforce القوية عبر أدوات MCP القياسية، يمكّن الخادم عملاء الذكاء الاصطناعي من تنفيذ استعلامات قواعد البيانات، وإدارة الكائنات، والتعامل مع كود Apex، وأتمتة سير العمل مباشرة من بيئات التطوير. يستفيد المطورون من وصول مبسط إلى موارد Salesforce، وإنتاجية محسنة، والقدرة على بناء تكاملات وأتمتة قوية مدعومة بالذكاء الاصطناعي عبر منصات متعددة.

قائمة التعليمات البرمجية (Prompts)

لا توجد قوالب تعليمات برمجية صريحة مذكورة في المستودع.

قائمة الموارد

لا توجد موارد MCP صريحة مذكورة في المستودع.

قائمة الأدوات

• salesforce_search_objects
  البحث عن الكائنات القياسية والمخصصة في Salesforce باستخدام تطابقات جزئية للأسماء.
• salesforce_describe_object
  استرجاع معلومات مخطط تفصيلية، بما في ذلك الحقول والعلاقات وقوائم الخيارات لكائن ما.
• salesforce_query_records
  استعلام السجلات مع دعم للعلاقات والشروط المعقدة.
• salesforce_aggregate_query
  تنفيذ استعلامات تجميعية باستخدام GROUP BY وHAVING ووظائف تجميع متنوعة.
• salesforce_dml_records
  إدراج أو تحديث أو حذف أو دمج سجلات Salesforce.
• salesforce_manage_object
  إنشاء وتعديل الكائنات المخصصة وضبط خصائصها.
• salesforce_manage_field
  إضافة أو تعديل الحقول المخصصة، بما في ذلك حقول العلاقات وصلاحيات الوصول.
• salesforce_manage_field_permissions
  منح/سحب/قراءة صلاحيات أمان الحقول لمحات معينة.
• salesforce_search_all
  البحث عبر عدة كائنات Salesforce باستخدام استعلامات SOSL.
• salesforce_read_apex
  قراءة فئات Apex، إدراجها حسب النمط، واسترجاع كود المصدر وبياناتها التعريفية.
• salesforce_write_apex
  إنشاء أو تحديث فئات Apex مع تحديد الكود وإصدارات واجهة البرمجة.
• salesforce_read_apex_trigger
  قراءة مشغلات Apex، إدراج المشغلات، واسترجاع بياناتها التعريفية/الكود المصدري.
• salesforce_write_apex_trigger
  إنشاء أو تحديث مشغلات Apex لكائنات معينة مع تحديد الأحداث وإصدارات API.
• salesforce_execute_anonymous
  تنفيذ كود Apex مجهول وعرض سجلات التصحيح والنتائج.

حالات الاستخدام لهذا الخادم MCP

• إدارة قاعدة بيانات Salesforce
  تنفيذ عمليات CRUD على سجلات Salesforce، وتبسيط معالجة البيانات، وأتمتة المهام المتكررة عبر تعليمات الذكاء الاصطناعي.
• استكشاف المخططات والبيانات التعريفية
  استرجاع مخططات الكائنات وتفاصيل الحقول والعلاقات بسرعة للمساعدة في بناء التكاملات أو فهم بنية المنظمة.
• إعداد تقارير وتحليلات متقدمة
  تنفيذ استعلامات تجميعية لإنشاء ملخصات وإجراء تحليلات وتصفية النتائج المجمعة لدعم احتياجات الأعمال.
• إدارة كود Apex والمشغلات
  قراءة وإنشاء وتحديث فئات أو مشغلات Apex مباشرة من بيئة التطوير، مما يسرّع دورات النشر والصيانة.
• بحث عبر الكائنات واكتشاف البيانات
  استخدام البحث المعتمد على SOSL للعثور على المعلومات عبر عدة كائنات، مما يسهل تحديد السجلات والعلاقات في منظمات Salesforce الكبيرة.

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Node.js على جهازك.
2. ثبّت خادم Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. حدد موقع ملف إعداد Windsurf (مثل windsurf.config.json).
4. أضف خادم Salesforce MCP باستخدام المقطع التالي:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. احفظ الملف وأعد تشغيل Windsurf.
6. تحقق من تشغيل الخادم في لوحة تحكم MCP.

Claude

1. تأكد من تثبيت Node.js.
2. ثبّت خادم Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. عدل ملف إعداد تكامل Claude.
4. أضف التالي إلى قسم mcpServers:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. احفظ وأعد تشغيل Claude.
6. تحقق من توفر Salesforce MCP في مساحة عمل Claude.

Cursor

1. قم بتثبيت Node.js.
2. ثبّت Salesforce MCP:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. افتح ملف إعداد Cursor.
4. أضف خادم Salesforce MCP كما هو موضح:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. احفظ التغييرات وأعد تشغيل Cursor.
6. اختبر الاتصال بالخادم في لوحة تكاملات MCP.

Cline

1. تأكد من تثبيت Node.js.
2. ثبّت الحزمة:
   npm install -g @tsmztech/mcp-server-salesforce@latest
3. ابحث وافتح ملف إعدادات Cline الخاص بك.
4. أدرج خادم Salesforce MCP:

   {
     "mcpServers": {
       "salesforce-mcp": {
         "command": "mcp-server-salesforce",
         "args": [],
         "env": {
           "SALESFORCE_CLIENT_ID": "your-client-id",
           "SALESFORCE_CLIENT_SECRET": "your-client-secret",
           "SALESFORCE_USERNAME": "your-username",
           "SALESFORCE_PASSWORD": "your-password",
           "SALESFORCE_TOKEN": "your-security-token"
         }
       }
     }
   }
   

5. احفظ وأعد تشغيل Cline.
6. تحقق من حالة خادم MCP في قائمة أدواتك.

تأمين مفاتيح API:
استخدم دائمًا متغيرات البيئة للبيانات الحساسة. في الإعداد، أضف الحقول اللازمة إلى كائن env كما هو موضح أعلاه.
لتمرير مدخلات إضافية، يمكنك استخدام:

{
  "mcpServers": {
    "salesforce-mcp": {
      "command": "mcp-server-salesforce",
      "args": [],
      "env": {
        "SALESFORCE_CLIENT_ID": "your-client-id"
      },
      "inputs": {
        "instanceUrl": "https://your-instance.salesforce.com"
      }
    }
  }
}

كيفية استخدام MCP هذا ضمن التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عمل FlowHunt، ابدأ بإضافة مكون MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي الخاص بك:

انقر على مكون MCP لفتح لوحة الإعداد. في قسم إعداد النظام لـ MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق:

{
  "salesforce-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، سيكون وكيل الذكاء الاصطناعي قادرًا الآن على استخدام هذا MCP كأداة بكل وظائفه وقدراته. تذكر تغيير “salesforce-mcp” إلى اسم خادم MCP الفعلي الخاص بك واستبدال الرابط برابط خادم MCP الخاص بك.

نظرة عامة

بين هذين الجدولين، يقدم خادم Salesforce MCP توثيقًا ممتازًا للأدوات والإعداد، لكنه يفتقر لتوثيق قوالب التعليمات البرمجية والموارد والجذور أو العينات. قوته الأساسية تكمن في مجموعة أدوات Salesforce القوية وتعليمات الإعداد الواضحة. وبناءً على ذلك، أقيم المستودع بـ 7/10 من حيث تكامل MCP العملي وقابلية الاستخدام للمطورين.

تقييم MCP