# المطور API، أدوات التضمين، أدوات MCP وتكامل المؤسسات | MerchandAise

- slug: developers
- locale: ar
- localeResolved: ar
- canonical: https://www.merchandaise.com/ar/developers

استكشف واجهات برمجة تطبيقات مطوري MerchandAise للبضائع المخصصة: مستندات OpenAPI، وتضمينات المجتمع، وسير عمل الموردين، وهوية المؤسسة، وأدوات MCP لوكلاء AI.

## منصة المطور
استخدم واجهات برمجة التطبيقات MerchandAise وعقود OpenAPI وعمليات التضمين المجتمعية وسير عمل الموردين وهوية المؤسسة وأدوات MCP لتوصيل البضائع المخصصة بمواقع الويب والبوابات ووكلاء AI.

## من يبني مع MerchandAise
- **مشغلي المجتمع:** قم بتشغيل واجهات المتاجر المضمنة وعمليات تسليم المكوّنات وتدفقات المجتمع داخل مواقع النادي والدوري والشركة من خلال العقود العامة ذات الإصدارات.
- **فرق المؤسسة وشركاء النظام الأساسي:** قم بتوصيل بوابات المشتريات وأنظمة الهوية والعمليات الداخلية بسير عمل البضائع دون إعادة بناء منطق الموافقة والمورد.
- **AI وكيل وبناة الأتمتة:** امنح المساعدين إمكانية الوصول إلى الأدوات المنظمة للاكتشاف والاقتباس والعمليات المعتمدة من خلال نقاط النهاية المتوافقة مع MCP.

## أسطح التكامل والعقود
- **API مستندات:** قم بمراجعة المستندات التي يمكن قراءتها بواسطة الإنسان وعقود OpenAPI القابلة للقراءة آليًا للتخطيط والاختبار وإدارة الإصدارات. Human guide: Read API docs (/ar/developers/api-integrations). Machine-readable contract: OpenAPI JSON (/api/docs/openapi.json). Access: public. Public reference for assistant and tooling APIs. Production access and order-affecting operations still require the applicable authorization. Canonical section: /developers#api-docs.
- **تضمين المجتمع API:** قم بتنفيذ عمليات تضمين واجهة المتجر الآمنة محليًا، وسير عمل المجتمع، وعمليات التسليم المصادق عليها باستخدام عقد عام مُصدر. Human guide: Explore community workflows (/ar/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Public versioned contract for storefront embeds, community discovery, and locale-aware handoffs. Canonical section: /developers#community-integrations.
- **المورد API:** قم بتوصيل عمليات الإعداد والكتالوج والعمليات من جانب المورد من خلال نقاط النهاية ذات الإصدارات المصممة لسير عمل التنفيذ. Human guide: Explore partner workflow (/ar/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Public contract for planning and client generation. Operational supplier access remains permissioned. Canonical section: /developers#supplier-integrations.
- **هوية المؤسسة API:** قم بدمج توفير SSO وSCIM وتدفقات الهوية الجاهزة للتدقيق لعمليات طرح المؤسسة وإدارتها من خلال عقد محمي للوصول المعتمد للمؤسسة. Human guide: Explore enterprise platform (/ar/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Protected contract for approved enterprise workspaces; request access before using this endpoint. Canonical section: /developers#enterprise-integrations.
- **أدوات MCP:** كشف إمكانات MerchandAise المعتمدة لوكلاء AI من خلال تعريفات الأدوات المتوافقة مع MCP القابلة للاكتشاف ونقاط نهاية التنفيذ مع ترخيص المساعد. Human guide: Read MCP implementation guide (/ar/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/ar/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The external tools list at /api/v1/mcp/tools exposes current tool metadata; each tool call still follows its declared security, workspace, and confirmation boundaries. Canonical section: /developers#mcp-tools.

## التكامل السريع
- **Step 1: اختر العقد الذي يتوافق مع سير عملك:** ابدأ بالسطح الذي يتطابق مع نموذج المستخدم والمصادقة الخاص بك: تضمين المجتمع، أو هوية المؤسسة، أو عمليات الموردين، أو أدوات MCP للمساعدين.
- **Step 2: التحقق من صحة المصادقة والإصدار وحدود البيئة:** قم بتأكيد الرؤوس والنطاقات وتوقعات رد الاتصال وإصدارات العقد المطلوبة في التدريج قبل توجيه حركة مرور الإنتاج.
- **Step 3: اختبار سير العمل الشامل قبل الإطلاق:** تحقق من الطلبات وخطافات الويب والتوفير وإمكانية المراقبة ومسارات التراجع حتى يكون التكامل موثوقًا به من الاستخدام المباشر الأول.

## What production-ready means
A production integration needs more than a public endpoint. Use these gates to decide whether your workflow is ready for customer, supplier, enterprise, or AI-agent traffic.
- **Sandbox and access review:** Confirm which contracts are public, which enterprise surfaces require approval, and which credentials or workspace roles are needed before launch.
- **Versioned implementation evidence:** Keep generated clients, callback URLs, auth scopes, contract versions, and rollback ownership documented before production traffic is enabled.
- **Operational observability:** Plan logs, retries, support ownership, failure states, and health checks for every workflow that can affect an order, supplier, or enterprise user.

## هل تحتاج إلى مراجعة التكامل؟
شارك تصميمك والمخطط الزمني للطرح والقنوات الوجهة. سنوصي بسطح العقد المناسب ونمط المصادقة وتسلسل الإطلاق.
- **تحدث إلى فريق التكامل:** /ar/contact/integrations
- **اكتشف منصة المؤسسة:** /ar/enterprise