تكامل خادم HubSpot MCP

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

تم تصميم خادم HubSpot MCP (بروتوكول سياق النماذج) لتمكين مساعدي الذكاء الاصطناعي من التفاعل مباشرة مع بيانات HubSpot CRM. يعمل هذا الخادم كجسر بين نماذج الذكاء الاصطناعي وحسابك في HubSpot، ما يسمح بالوصول السلس إلى جهات الاتصال، والشركات، وبيانات التفاعل. يتضمن تخزينًا شعاعيًا مدمجًا (باستخدام FAISS) للبحث الدلالي وآليات التخزين المؤقت التي تساعد على تخطي قيود واجهة HubSpot API، مما يضمن استجابة أسرع وأكثر موثوقية. يركز هذا الخادم على العمليات الأساسية عالية القيمة والمتكررة في CRM، مع معالجة أخطاء قوية وتحسين ملائم للذكاء الاصطناعي. هذا يجعل من تدفقات CRM المتعددة الخطوات أكثر كفاءة ويعزز قدرات تطوير الذكاء الاصطناعي من خلال توفير وصول مباشر وغني بالسياق إلى بيانات الأعمال.

قائمة الموجهات

• (لم يتم العثور على قوالب موجهات صريحة في المستودع. قسم “أمثلة الموجهات” في ملف README يحتوي فقط على أمثلة للمستخدم، وليست قوالب قابلة لإعادة الاستخدام.)

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

(لا توجد موارد صريحة موصوفة في المستودع أو التوثيق. لم يتم سرد أي موارد MCP أساسية.)

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

• hubspot_create_contact
  إنشاء جهات اتصال في HubSpot مع منطق منع التكرار.

• hubspot_create_company
  إنشاء شركات في HubSpot مع منطق منع التكرار.

• hubspot_get_company_activity
  استرجاع النشاط لشركات محددة.

• hubspot_get_active_companies
  استرجاع أحدث الشركات النشطة.

• hubspot_get_active_contacts
  استرجاع أحدث جهات الاتصال النشطة.

• hubspot_get_recent_conversations
  استرجاع أحدث سلاسل المحادثات مع الرسائل.

• hubspot_search_data
  بحث دلالي عبر بيانات HubSpot التي تم استرجاعها مسبقًا.

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

• إنشاء جهات اتصال تلقائيًا
  تمكين مساعدي الذكاء الاصطناعي من إنشاء جهات اتصال جديدة في HubSpot مباشرة من المحادثات أو رسائل البريد الإلكتروني أو نصوص ملفات LinkedIn، مما يسهل استقبال العملاء ويقلل من إدخال البيانات يدويًا.

• إدارة بيانات الشركات
  تبسيط عملية إنشاء وتحديث ملفات الشركات في HubSpot عبر تدفقات الذكاء الاصطناعي، لضمان دقة سجلات CRM وحداثتها.

• مراقبة النشاط والتفاعل
  استرجاع أحدث نشاط على الشركات وجهات الاتصال، ما يسمح لفرق المبيعات والعملاء الآليين بمراقبة اتجاهات التفاعل والمتابعة بشكل أكثر فعالية.

• تحليل المحادثات
  الوصول إلى سلاسل المحادثات الأخيرة وتحليلها، بحيث يمكن للذكاء الاصطناعي تلخيص التفاعلات أو تحديد فرص المتابعة.

• بحث CRM دلالي
  استخدام التخزين الشعاعي المدمج لإجراء بحث دلالي عبر بيانات HubSpot، مما يسهل على الذكاء الاصطناعي العثور على المعلومات ذات الصلة في التفاعلات السابقة وسجلات CRM.

كيفية إعداده

Windsurf

1. تأكد من تثبيت Docker.
2. احصل على رمز وصول HubSpot مع الصلاحيات المطلوبة.
3. في إعدادات Windsurf، ابحث عن قسم خوادم MCP.
4. أضف خادم HubSpot MCP باستخدام المقطع JSON التالي:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. احفظ الإعدادات وأعد تشغيل Windsurf.
6. تحقق من الإعداد عبر الاستعلام عن بيانات HubSpot عبر Windsurf.

Claude

1. ثبت Node.js إذا لم يكن موجودًا.
2. احصل على رمز وصول HubSpot الخاص بك.
3. عدل إعدادات Claude لإضافة خادم MCP.
4. أضف خادم HubSpot MCP بواسطة:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. احفظ وأعد تشغيل Claude.
6. تأكد أن خادم MCP ظاهر ويستجيب.

Cursor

1. ثبت Docker وNode.js.
2. احصل على رمز وصول HubSpot.
3. افتح ملف إعدادات Cursor.
4. أضف هذا تحت mcpServers:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. احفظ التغييرات وأعد تشغيل Cursor.

Cline

1. تأكد من تثبيت Docker.
2. احصل على رمز وصول HubSpot.
3. في بيئة Cline، افتح ملف الإعداد المناسب.
4. أضف:

   {
     "mcpServers": {
       "hubspot": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "HUBSPOT_ACCESS_TOKEN=your_token",
           "-v", "/path/to/storage:/storage",
           "buryhuang/mcp-hubspot:latest"
         ]
       }
     }
   }
   

5. احفظ وأعد تشغيل Cline.

حماية مفاتيح API
من الأفضل دائمًا حماية رمز وصول HubSpot باستخدام متغيرات البيئة بدلاً من كتابته مباشرة. مثال:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "HUBSPOT_ACCESS_TOKEN=${HUBSPOT_ACCESS_TOKEN}",
        "-v", "/path/to/storage:/storage",
        "buryhuang/mcp-hubspot:latest"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your_token"
      }
    }
  }
}

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

استخدام MCP في FlowHunt

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

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

{
  "hubspot": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بمجرد الإعداد، يصبح بمقدور عميل الذكاء الاصطناعي استخدام هذا الخادم MCP كأداة بكل وظائفه وقدراته. تذكر تغيير “hubspot” إلى اسم خادم MCP الفعلي الخاص بك (مثل “github-mcp”، “weather-api”، إلخ) واستبدال الرابط برابط خادم MCP الخاص بك.

نظرة عامة

تقييمي العام لخادم HubSpot MCP هو:
بينما يتمتع الخادم بقوة في الأدوات والتوثيق لإعداده، إلا أن غياب قوالب الموجهات الصريحة وموارد MCP الأساسية يحد من مرونته في سير عمل الذكاء الاصطناعي المتقدم. لا يوجد ذكر لدعم العينات أو الجذور. هو مناسب للاستخدام العملي في CRM، لكنه قد يستفيد من تغطية خصائص MCP بشكل أوسع.

درجة MCP

درجة جدول MCP: 7/10