تكامل خادم Box MCP

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

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

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

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

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

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

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

• box_who_am_i
  الحصول على معلومات المستخدم الحالي والتحقق من حالة الاتصال.

• box_authorize_app_tool
  بدء عملية تفويض تطبيق Box.

• box_search_tool
  البحث عن الملفات في Box باستخدام الاستعلامات وامتدادات الملفات والمواقع ومعرّفات المجلد الأصل.

• box_read_tool
  قراءة محتوى نصي لملف في Box عن طريق معرّفه.

• box_ask_ai_tool
  اسأل Box AI عن ملف باستخدام محفز.

• box_ask_ai_tool_multi_file
  استعلام Box AI باستخدام عدة ملفات ومحفز.

• box_hubs_ask_ai_tool
  اسأل Box AI عن محور باستخدام معرّف المحور ومحفز.

• box_search_folder_by_name
  تحديد موقع مجلد حسب اسمه.

• box_ai_extract_data
  استخراج الحقول المحددة من ملف باستخدام الذكاء الاصطناعي.

• box_list_folder_content_by_folder_id
  عرض محتويات مجلد بواسطة معرّف المجلد، مع خيار التكرار.

• box_manage_folder_tool
  إنشاء أو تحديث أو حذف المجلدات في Box.

• box_upload_file_tool
  رفع ملفات إلى Box.

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

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

• تحليل المحتوى بمساعدة الذكاء الاصطناعي
  استخدم Box AI لاستخراج بيانات منظمة، تلخيص المستندات، أو الإجابة على الأسئلة حول محتوى الملفات، مما يمكّن من معالجة المستندات بذكاء واستخلاص رؤى.

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

• العمليات الجماعية والتقارير
  عرض محتويات المجلدات بشكل متكرر وتجميع المعلومات لأغراض التدقيق أو التقارير أو مهام الترحيل.

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

كيفية إعداده

Windsurf

1. تأكد من تثبيت المتطلبات الأساسية (مثل Node.js).

2. حدد موقع ملف إعدادات Windsurf الخاص بك.

3. أضف خادم Box MCP باستخدام مقتطف JSON في قسم mcpServers:

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

4. احفظ الإعدادات وأعد تشغيل Windsurf.

5. تحقق من الإعداد عبر التأكد أن الخادم يستجيب للطلبات.

تأمين مفاتيح API

استخدم متغيرات البيئة للبيانات الحساسة:

"mcpServers": {
  "box-mcp": {
    "command": "npx",
    "args": ["@box/mcp-server-box@latest"],
    "env": {
      "BOX_CLIENT_ID": "your-client-id",
      "BOX_CLIENT_SECRET": "your-client-secret"
    },
    "inputs": {}
  }
}

Claude

1. قم بتثبيت Node.js إذا لزم الأمر.

2. افتح ملف إعدادات Claude.

3. أضف خادم Box MCP في قسم mcpServers:

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

4. احفظ التغييرات وأعد تشغيل Claude.

5. تأكد من أن خادم MCP يعمل.

تأمين مفاتيح API

"env": {
  "BOX_CLIENT_ID": "your-client-id",
  "BOX_CLIENT_SECRET": "your-client-secret"
}

Cursor

1. قم بتثبيت المتطلبات حسب الحاجة.

2. حرر ملف إعدادات Cursor الخاص بك.

3. أدرج إدخال خادم Box MCP:

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

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

5. تحقق من التكامل.

تأمين مفاتيح API

"env": {
  "BOX_CLIENT_ID": "your-client-id",
  "BOX_CLIENT_SECRET": "your-client-secret"
}

Cline

1. تأكد من تثبيت Node.js والمتطلبات الأخرى.

2. افتح ملف إعدادات Cline.

3. أضف إعداد خادم Box MCP:

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

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

5. اختبر اتصال الخادم.

تأمين مفاتيح API

"env": {
  "BOX_CLIENT_ID": "your-client-id",
  "BOX_CLIENT_SECRET": "your-client-secret"
}

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

دعم الجذور غير موثق

استنادًا إلى الجدول أعلاه، هذا الخادم MCP قوي جدًا من حيث تغطية الأدوات ووضوح الإعداد، لكنه يفتقر إلى توثيق قوالب المحفزات أو الموارد/الجذور/دعم العينات بشكل صريح. بشكل عام، هو تكامل متين وعملي لتدفقات العمل على Box، لكنه قد يستفيد من ميزات MCP إضافية وتوثيق أغنى.

تقييم MCP