تحتاج إلى دور يمكنه فتح Workspace Config وإدارة API keys (عادةً SuperAdmin أو Admin). تحتاج أيضًا إلى Node.js 20+ على الجهاز الذي يشغّل Claude Desktop أو Cursor.
المتطلبات
حزمة MCP على npm هي
agencyhandy-mcp. يشغّلها Claude وCursor عبر npx -y agencyhandy-mcp@1.
إعداد Claude أو Cursor MCP
1
افتح Workspace Config
في AgencyHandy، افتح Workspace Config (إعدادات الشركة)، ثم انتقل إلى تبويب API Key.
2
أنشئ مفتاح API لمساحة العمل
أنشئ مفتاح API جديدًا لمساحة العمل (أو استخدم مفتاحًا محفوظًا). انسخ المفتاح عند ظهوره — لن يتمكن AgencyHandy من إظهار المفتاح الكامل لاحقًا.
3
انسخ إعداد MCP
في تبويب API Key نفسه، استخدم لوحة إعداد Claude / Cursor MCP. انقر Copy MCP config ليضم JSON مفتاحك ورابط الواجهة الخلفية.
4
الصق في Cursor أو Claude Desktop
الصق الإعداد في:
- Cursor: مشروع أو مستخدم
.mcp.json - Claude Desktop:
claude_desktop_config.json
npx -y agencyhandy-mcp@1 ومفتاح API كما تم إنشاؤهما.5
أعد التشغيل وجرّب مطالبة
أغلق Cursor أو Claude Desktop بالكامل ثم أعد فتحه. بعد ذلك اطلب شيئًا بسيطًا مثل موجز صباحي لمساحة العمل.
أمثلة على المطالبات
استخدم لغة طبيعية. فضّل الاسم الكامل أو البريد عند تعيين العمل لاختيار الشخص الصحيح.عندما يشترك شخصان في الاسم نفسه
إذا كان في الفريق شخصان باسم Sara، فسيسأل Claude أيهما تقصد. إنه لا يخترع المعرّفات ولا يخمن بصمت. ضمّن دائمًا اسمًا كاملًا أو بريدًا في المطالبة عندما قد تتعارض الأسماء.ما يعمل الآن مقابل ما لم يتوفر بعد
يدعم MCP قراءة مساحة العمل والإجراءات (إنشاء، تعيين، إرسال، تحديث) بمفتاح API الخاص بك. ردود دردشة العميل غير معروضة عبر MCP بعد — استخدم AgencyHandy لتلك المحادثات.
ذات صلة
- أنشئ المفاتيح وانسخ الإعداد داخل التطبيق من Workspace Config → API Key
Latest package on the
1 tag is 1.7.2+. Claude can read ah://api-context (also inside ah://full-context) for API path gotchas: leads, projects/orders, tasks, comments, labels, clients, invoices, vouchers, and forms.- الحزمة:
agencyhandy-mcpعلى npm (npx -y agencyhandy-mcp@1)