توثيق API

• REST API

  لنظام ERP وأنظمتك المالية، ويغطي حاليا المنتجات والطلبات.

  ابدأ مع REST

• خادم MCP

  لمساعدي الذكاء الاصطناعي مثل Claude، ويضم 50 أداة في ENTEK Corporate.

  ابدأ مع MCP

Authorization: Bearer <your-token>

لا يفعل الرمز إلا ما يستطيع من أصدره فعله في التطبيق. احفظه كما تحفظ كلمة المرور، وإذا تسرب فألغه من الإعدادات.

# list products
curl https://<base-url>/api/products \
  -H "Authorization: Bearer <your-key>"

عنوان الخادم

نرسلها مع مفتاحك

حدود الاستخدام

نرسلها مع مفتاحك

محتوى الطلب في POST /api/orders

نرسلها مع مفتاحك

الأخطاء والإصدارات

نرسلها مع مفتاحك

الربط في أربع خطوات

1. 1تفعيل API & Integrations. يفعله مسؤول الشركة من إعدادات ENTEK Corporate، فهو معطل افتراضيا في الشركات الجديدة.
2. 2إنشاء رمز وصول. يحمل الرمز دورك، فلن يتجاوز المساعد حدود صلاحياتك أبدا. سمه باسم الأداة التي ستستخدمه.
3. 3إضافة الخادم إلى برنامج العميل. الصق عنوان الخادم والرمز في عميل MCP، كما في المثال أدناه.
4. 4التحقق من الاتصال. يكفي أن تسأل: "بأي حساب أنا متصل؟"، فيستدعي العميل whoami ويعرض اسم شركتك. وبعدها يمكنك تجربة: "اعرض فروعنا".

{
  "mcpServers": {
    "entek-corporate": {
      "url": "https://mcp.corporate.entek.ai",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}

list_orders { "branch_id": "<id from list_branches>", "status": "shipped" }
// runs with the token owner's permissions

كيف يعمل الخادم

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

الخادم: mcp.corporate.entek.ai. قبل الإطلاق، تأكد من المسار الدقيق وصيغة الترويسة بمراسلة [email protected].

على خادم MCP في ENTEK Corporate 50 أداة. أدوات الكتابة تعدل بيانات حقيقية، فلا تمنحها إلا لمن يملك هذه الصلاحية في التطبيق.