# Разработчик 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: Прочетете API документи (/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: /bg/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. Договор с публични версии за вграждане на витрини, откриване на общността и предавания, съобразени с локала. Canonical section: /bg/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. Обществена поръчка за планиране и генериране на клиенти. Оперативният достъп на доставчик остава разрешен. Canonical section: /bg/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. Защитен договор за одобрени корпоративни работни пространства; поискайте достъп, преди да използвате тази крайна точка. Canonical section: /bg/developers#enterprise-integrations.
- **Инструменти MCP:** Разкривайте одобрени MerchandAise възможности на AI агенти чрез откриваеми MCP-съвместими дефиниции на инструменти и крайни точки за изпълнение с оторизация на асистент. Human guide: Прочетете ръководството за внедряване на MCP (/bg/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/.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: /bg/developers#mcp-tools.

## Бърз старт на интеграцията
- **Step 1: Изберете договора, който отговаря на вашия работен процес:** Започнете с повърхността, която съответства на вашия модел на потребител и удостоверяване: вграждане на общността, корпоративна идентичност, операции на доставчик или MCP инструменти за асистенти.
- **Step 2: Потвърдете границите на автентичността, управлението на версиите и средата:** Потвърдете необходимите заглавки, обхвати, очаквания за обратно извикване и версии на договора в етапа, преди да насочите производствения трафик.
- **Step 3: Тествайте работните процеси от край до край преди стартиране:** Проверете заявките, уеб куките, осигуряването, наблюдаемостта и пътищата за връщане назад, така че интеграцията да е надеждна от първото използване на живо.

## What production-ready means
Производствената интеграция се нуждае от нещо повече от публична крайна точка. Използвайте тези врати, за да решите дали вашият работен процес е готов за трафик на клиенти, доставчици, предприятия или AI-агенти.
- **Sandbox and access review:** Потвърдете кои договори са публични, кои корпоративни повърхности изискват одобрение и кои идентификационни данни или роли на работното пространство са необходими преди стартиране.
- **Versioned implementation evidence:** Поддържайте документирани генерираните клиенти, URL адресите за обратно извикване, обхватите на удостоверяване, версиите на договора и собствеността за връщане назад, преди производственият трафик да бъде активиран.
- **Operational observability:** Планирайте регистрационни файлове, повторни опити, поддръжка за собственост, състояния на неизправност и проверки на здравето за всеки работен процес, който може да засегне поръчка, доставчик или корпоративен потребител.

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