# Документация за AI агенти и MCP | MerchandAise

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

Разгледайте MCP документацията, откриването на сървъра и AI инструментите на MerchandAise за продуктов дизайн и оферти с права за работното пространство и потребителски одобрения.

## Разберете какво може да прави асистентът
В поддържаните сесии потребителят може да опише идея, да види продукта в интерактивен 3D преглед и да поиска промени. Асистентът използва същите продуктови данни и състояние на дизайна като процеса на MerchandAise; текущите инструменти определят какво може да чете или променя.
Картата на сървъра и външните метаданни за инструментите са публични за откриване. Всяко извикване все пак следва декларираната граница за сигурност и работно пространство, а одобренията на купувача, пробните прегледи и производството остават видими и с установима отговорност.

## Открийте сървъра. След това поискайте правилния достъп.
- **AI агенти и MCP:** Свържете AI асистент чрез Model Context Protocol. Открийте поддържаните инструменти и запазете дизайнерските избори, правата и изискваните потвърждения на потребителя. Ръководство за внедряване: Прочетете ръководството за MCP внедряване (/bg/developers/ai-agents-mcp#implementation-checklist). Машинночетим договор: Публична MCP server-card JSON (/.well-known/mcp/server-card). Достъп: Публичен. Публичен документ за откриване от машинни клиенти. Външният списък с инструменти на /api/v1/mcp/tools показва актуалните метаданни; всяко извикване все пак следва декларираните граници за сигурност, работно пространство и потвърждение. Канонична страница: /bg/developers/ai-agents-mcp. Каноничен раздел: /bg/developers/ai-agents-mcp#mcp-tools.
- **API документация и OpenAPI:** Намерете API справочника за асистентски инструменти и дизайн сесии, след което изберете договора за общност, доставчик или компания според процеса си. Ръководство за внедряване: Разгледайте API документацията (/bg/developers/api-integrations). Машинночетим договор: OpenAPI JSON за асистентски инструменти (/api/docs/openapi.json). Достъп: Публичен. Публичен справочник за API на асистенти и инструменти. Достъпът до реалната среда и операциите, засягащи поръчки, все пак изискват приложимото разрешение. Канонична страница: /bg/developers/ai-agents-mcp. Каноничен раздел: /bg/developers/ai-agents-mcp#api-docs.

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

## Какво трябва да запазва агентът
- **Едно версионирано продуктово състояние:** Асистентът работи със същите дизайн, търговско намерение, потвърдена от доставчика оферта, одобрение и статус на поръчка като всеки друг интерфейс на MerchandAise.
- **Търговска поверителност и защита на доставчиците:** Когато MerchandAise обработва сделката с купувача, Hutter Products GmbH е договорният продавач и Merchant of Record под бранда MerchandAise. Частната самоличност, контактите и вътрешните данни на доставчиците не се разкриват на агент.
- **Одобренията на пробните прегледи остават при хората:** 3D прегледът не е физическо доказателство. Потвърдената оферта обяснява наличните възможности за клиентски мостри, разходите, ограниченията и сроковете. Преди серийното производство одобрете точния дигитален пробен преглед и завършете задължителните технически проверки и всички изисквани или избрани одобрения на мостри. Изискванията по вече приети поръчки остават задължителни.

## Преди агентът да достигне реалната среда
Откриваемият MCP сървър е само началото. Готовността за реална употреба означава ограничена роля на асистента, отговорно лице за всяко действие с последствия и връщане на потребителите в безопасно състояние при грешка.
- **Определете достъпа според последствията:** Класифицирайте всеки инструмент като само за четене, консултативен, променящ състоянието, чувствителен за доставчици или засягащ поръчки, преди да го предоставите на асистент.
- **Посочете отговорника за всяко потвърждение:** Определете кой потвърждава промените по продукти, офертите, дигиталните пробни прегледи, производствените мостри и поръчките — и какво прави асистентът, когато този човек не е на разположение.
- **Наблюдавайте, отказвайте и възстановявайте:** Тествайте невалидни данни, остаряло състояние, липсващи права, откази, повторни опити, телеметрия и връщане назад, преди реален трафик да достигне процеса.

## Често задавани въпроси
- **Какво е MCP и това публично приложение за ChatGPT ли е?:** MCP означава Model Context Protocol: начин асистент да открива и използва инструменти. Тези документи описват възможностите за интеграция на MerchandAise. Публичната карта на сървъра не потвърждава наличност в магазина за приложения на ChatGPT. Достъпът в работно пространство на ChatGPT зависи от акаунта ви, настройката на приложението и поддържаната среда.
- **Какво може да прави AI агент с MerchandAise?:** Упълномощеният асистент може да използва одобрените за работното му пространство и среда инструменти, като откриване на продукти, насоки за дизайн или оферти и други изрично активирани операции. Наличните инструменти и правата им се определят при прегледа на интеграцията.
- **Може ли AI агент автоматично да прави поръчки?:** Не чрез откриване на сървъра или списъка с инструменти. Всеки процес, засягащ поръчка, трябва да запазва удостоверяването, потвърждението на купувача и работното пространство, актуалните по версия цени, одобрението на дигиталния пробен преглед и потвърдената от доставчика производимост, задължителните технически проверки и точния избор на клиентска мостра и изисквания за одобрение, договорени за поръчката. Вече приетите изисквания не могат да бъдат отменяни мълчаливо.
- **Публична ли е MCP интеграцията на MerchandAise?:** MCP картата на сървъра и текущите външни метаданни за инструментите са публични за машинно откриване. Отделните извиквания следват декларирания модел за сигурност, а защитените операции за работни пространства, доставчици, компании, оферти и поръчки запазват изискваните разрешения и потвърждения.

## Имате идея за процес с агент?
Кажете ни на кого служи асистентът, какво трябва да му е позволено да прави и къде човек трябва да запази контрола. Ще определим правилните граници за MCP, API и одобренията.
- **Прегледайте процес с агент:** /bg/contact?intent=agent-mcp-review
- **Разгледайте API договорите:** /bg/developers/api-integrations
