تكامل خادم BambooHR MCP

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

خادم BambooHR MCP هو مكتبة بروتوكول سياق النماذج (MCP) مصممة لتسهيل التكامل السلس بين المساعدين الذكيين وواجهة برمجة تطبيقات BambooHR. تم بناؤه باستخدام Node.js وTypeScript، ويوفر واجهة نظيفة وآمنة من النوع للوصول إلى نقاط نهاية متعددة في BambooHR والتفاعل معها. يعمل كجسر بين أنظمة الذكاء الاصطناعي وبيانات الموارد البشرية، مما يمكّن المطورين والمؤسسات من تنفيذ تدفقات عمل متقدمة مثل استعلام دليل الموظفين، وإدارة تعيينات المشاريع، وتقديم ساعات العمل، واسترجاع معلومات عن توافر الفريق. يمكّن هذا التكامل المساعدين الذكيين من أتمتة مهام الموارد البشرية، وتبسيط استرجاع البيانات، ودعم إدارة موارد بشرية أكثر فعالية ضمن بيئات التطوير.

قائمة المحفزات

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

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

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

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

• fetchWhosOut: يسترجع قائمة الموظفين غير المتواجدين حالياً في المكتب.
• fetchProjects: يجلب بيانات المشاريع المرتبطة بأحد الموظفين.
• submitWorkHours: يتيح تقديم ساعات العمل لمشروع أو مهمة محددة.
• getMe: يسترجع تفاصيل المستخدم المصادق عليه.
• fetchEmployeeDirectory: يعرض جميع الموظفين مع أسمائهم، عناوين بريدهم الإلكتروني، ومسمياتهم الوظيفية.
• fetchTimeEntries: يسترجع سجلات إدخالات الوقت للموظفين.

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

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

كيفية إعداده

Windsurf

1. تأكد من تثبيت Node.js وnpm.
2. استنسخ المستودع وثبّت التبعيات:

   git clone https://github.com/encoreshao/bamboohr-mcp.git
   cd bamboohr-mcp
   npm install
   

3. حرر ملف التكوين الخاص بك لإضافة خادم BambooHR MCP:

   {
     "mcpServers": {
       "bamboohr-mcp": {
         "command": "npx",
         "args": ["@bamboohr/mcp-server@latest"]
       }
     }
   }
   

4. عيّن متغيرات البيئة لمفاتيح API (انظر أدناه).
5. احفظ وأعد تشغيل Windsurf. تحقق من تشغيل الخادم.

Claude

1. المتطلبات: تثبيت Node.js وnpm.
2. استنسخ وأعد إعداد خادم BambooHR MCP كما سبق.
3. في إعدادات Claude أضف:

   {
     "mcpServers": {
       "bamboohr-mcp": {
         "command": "npx",
         "args": ["@bamboohr/mcp-server@latest"]
       }
     }
   }
   

4. عيّن متغيرات البيئة المطلوبة (انظر أدناه).
5. احفظ وأعد تشغيل Claude وتحقق من الاتصال.

Cursor

1. ثبّت Node.js وnpm.
2. استنسخ وثبّت bamboohr-mcp:

   git clone https://github.com/encoreshao/bamboohr-mcp.git
   cd bamboohr-mcp
   npm install
   

3. أضف إلى إعدادات Cursor:

   {
     "mcpServers": {
       "bamboohr-mcp": {
         "command": "npx",
         "args": ["@bamboohr/mcp-server@latest"]
       }
     }
   }
   

4. عيّن متغيرات البيئة (انظر أدناه).
5. احفظ وأعد تشغيل Cursor.

Cline

1. تأكد من وجود Node.js وnpm.
2. استنسخ وثبّت كما هو موضح أعلاه.
3. أضف التالي إلى إعدادات Cline:

   {
     "mcpServers": {
       "bamboohr-mcp": {
         "command": "npx",
         "args": ["@bamboohr/mcp-server@latest"]
       }
     }
   }
   

4. عيّن متغيرات البيئة كما هو موضح.
5. احفظ وأعد تشغيل Cline.

تأمين مفاتيح API باستخدام متغيرات البيئة

عيّن التالي في بيئتك أو في ملف .env:

BAMBOOHR_TOKEN=your_api_token_here
BAMBOOHR_COMPANY_DOMAIN=yourcompany
BAMBOOHR_EMPLOYEE_ID=123

يمكنك أيضًا تحديد متغيرات البيئة ضمن إعدادات JSON:

{
  "mcpServers": {
    "bamboohr-mcp": {
      "command": "npx",
      "args": ["@bamboohr/mcp-server@latest"],
      "env": {
        "BAMBOOHR_TOKEN": "your_api_token_here",
        "BAMBOOHR_COMPANY_DOMAIN": "yourcompany",
        "BAMBOOHR_EMPLOYEE_ID": "123"
      }
    }
  }
}

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

| دعم Roots | ⛔ | غير مذكور |

رأينا

يوفر BambooHR MCP تكاملاً أساسياً وآمناً من النوع مع BambooHR للمطورين ومساعدي الذكاء الاصطناعي المبنيين على MCP. على الرغم من أن بنيته جيدة ويغطي نقاط نهاية أساسية في واجهة الموارد البشرية، إلا أنه يفتقر حالياً لتعريفات صريحة للمحفزات/الموارد ولا يوثق ميزات MCP المتقدمة مثل Roots أو Sampling. مناسب لأتمتة الموارد البشرية الأساسية لكنه ليس مرجعاً متكاملاً لـ MCP.

استناداً إلى ما سبق، أقيّم هذا الخادم MCP بـ 4/10 من حيث اكتمال MCP العام: يغطي الأدوات الأساسية والتكوين، لكنه يفتقر للميزات المتقدمة وقوالب المحفزات وكشف الموارد.

تقييم MCP