# Разработчик API, вграждане, MCP инструменти и корпоративни интеграции | MerchandAise

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

Разгледайте API за разработчици на MerchandAise за персонализирани стоки: документи на OpenAPI, вграждания на общността, работни процеси на доставчици, корпоративна идентичност и инструменти MCP за агенти на AI.

## Платформа за разработчици
Използвайте MerchandAise API, OpenAPI договори, общностни вграждания, работни потоци на доставчици, корпоративна идентичност и MCP инструменти, за да свържете персонализирани стоки в уебсайтове, портали и AI агенти.

## Кой изгражда с MerchandAise
- **оператори на Общността:** Стартирайте вградени витрини, предавания на конфигуратори и потоци на общността в клубове, лиги и фирмени сайтове с публични договори с версии.
- **Корпоративни екипи и партньори на платформата:** Свържете порталите за доставки, системите за идентичност и вътрешните операции към работните потоци на стоките без повторно изграждане на одобрение и логика на доставчика.
- **AI агент и създатели на автоматизация:** Дайте на асистентите структуриран достъп до инструменти за откриване, цитиране и одобрени операции чрез крайни точки, съвместими с MCP.

## Интеграционни повърхности и договори
- **API документи:** Прегледайте четими от хора документи и машинно четими OpenAPI договори за планиране, тестване и управление на версиите. Human guide: Read API docs (/bg/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 (/bg/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 (/bg/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 (/bg/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 (/bg/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/bg/.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.

## Нуждаете се от преглед на интеграцията?
Споделете вашата архитектура, времева линия за внедряване и целеви канали. Ние ще препоръчаме правилната договорна повърхност, модел за удостоверяване и последователност на стартиране.
- **Говорете с екипа за интеграция:** /bg/contact/integrations
- **Разгледайте корпоративната платформа:** /bg/enterprise