# Agentes AI e MCP para fluxos de merchandising | MerchandAise

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

Ligue agentes AI aos fluxos de merchandising da MerchandAise através de descoberta MCP pública, ferramentas com permissões, confirmações humanas e controlos seguros para produção.

## Um assistente. Um fluxo de trabalho regulado.
Um assistente pode ajudar a transformar uma descrição ou referência carregada numa direção de produto suportada, visualização 3D nativa do produto e expectativas de preço, MOQ e entrega apoiadas pelo fornecedor. Deve estender o fluxo de trabalho da MerchandAise, e não criar uma segunda fonte de verdade.
O cartão do servidor e os metadados de ferramentas externas são públicos para efeitos de descoberta. Cada chamada de ferramenta continua a cumprir os respetivos limites declarados de segurança e espaço de trabalho, enquanto as aprovações de comprador, prova e produção permanecem visíveis e atribuíveis.

## Descubra o servidor. Depois, solicite o acesso adequado.
- **Descoberta MCP e ferramentas reguladas:** Utilize o cartão de servidor público e a lista de ferramentas externas para descoberta por máquina, respeitando depois os limites declarados de segurança, espaço de trabalho e confirmação de cada ferramenta quando executada por um agente. Human guide: Ler guia de implementação MCP (/pt/developers/ai-agents-mcp). Machine-readable contract: JSON do cartão de servidor MCP público (/pt/.well-known/mcp/server-card). Access: public. Documento de descoberta pública para clientes de máquinas. A lista de ferramentas externas em /api/v1/mcp/tools expõe os metadados atuais das ferramentas; cada chamada de ferramenta continua a seguir os respetivos limites declarados de segurança, espaço de trabalho e confirmação. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#mcp-tools.
- **Documentação da API de ferramentas do assistente:** Explore os endpoints atuais do assistente e de ferramentas para sessões de design e revisão de integração. Esta referência pública não confere autoridade anónima para cotar ou efetuar uma encomenda. Human guide: Abrir documentação de ferramentas do assistente (/pt/developers/api-integrations). Machine-readable contract: OpenAPI JSON de ferramentas do assistente (/api/docs/openapi.json). Access: public. Referência pública para APIs de assistente e ferramentas. O acesso de produção e as operações que afetam encomendas continuam a exigir a autorização aplicável. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#api-docs.

## Da descoberta a uma ação regulada
- **Step 1: Descubra com segurança:** Utilize o cartão de servidor MCP público e a lista de ferramentas para identificar a MerchandAise e o inventário atual de ferramentas externas. A descoberta por si só não confere autoridade ampla para cotar, alterar estados ou encomendar.
- **Step 2: Conceda o privilégio mínimo:** Autorize apenas as ferramentas, o espaço de trabalho e o ambiente necessários ao assistente. Separe a exploração de leitura isolada das ações que alteram o estado de um design, orçamento, aprovação ou encomenda.
- **Step 3: Confirme antes de agir:** Mantenha a confirmação humana explícita para ações sensíveis, teste o comportamento de estados desatualizados e recusas, e comprove os caminhos de recuperação antes de ativar o tráfego de produção.

## O que o agente deve preservar
- **Um estado de produto versionado:** O assistente opera sobre o mesmo estado de design, intenção comercial, orçamento apoiado pelo fornecedor, aprovação e encomenda que qualquer outra superfície da MerchandAise.
- **Privacidade comercial e de fornecedores:** Sempre que a MerchandAise processa a transação do comprador, a Hutter Products GmbH é o vendedor contratual e Merchant of Record sob a marca MerchandAise. A identidade privada do fornecedor, contactos e dados internos não são expostos a um agente.
- **As aprovações de provas continuam humanas:** A AI e o suporte 3D nativo do produto auxiliam na decisão, mas a aprovação digital da prova e a aprovação de uma amostra de produção genuína continuam a ser obrigatórias antes da produção em massa.

## Antes de um agente chegar à produção
Um servidor MCP descobertível é apenas o ponto de partida. Estar pronto para produção significa que o assistente tem um papel delimitado, cada ação consequencial tem um responsável e as falhas devolvem os utilizadores a um estado seguro.
- **Mapeie o acesso por consequência:** Classifique cada ferramenta como apenas de leitura, consultiva, alteradora de estado, sensível para o fornecedor ou geradora de encomendas antes de a conceder a um assistente.
- **Nomeie cada responsável pelas confirmações:** Defina quem confirma alterações de produtos, orçamentos, provas digitais, amostras de produção e encomendas — e o que o assistente faz quando essa pessoa não está disponível.
- **Observe, recuse e recupere:** Teste entradas inválidas, estados desatualizados, falta de permissões, recusas, tentativas falhadas, telemetria e caminhos de reversão antes de o tráfego real chegar ao fluxo de trabalho.

## FAQ
- **O que pode um agente AI fazer com a MerchandAise?:** Um assistente autorizado pode utilizar as ferramentas aprovadas para o respetivo espaço de trabalho e ambiente, tais como descoberta de produtos, orientação de design ou orçamentação, e outras operações explicitamente ativadas. As ferramentas disponíveis e as respetivas permissões são determinadas durante a revisão da integração.
- **Pode um agente AI efetuar encomendas automaticamente?:** Não apenas por descobrir o servidor ou listar ferramentas. Qualquer fluxo de trabalho que afete encomendas deve preservar a autenticação, a confirmação do comprador e do espaço de trabalho, preços atualizados por versão, aprovação digital de provas e o requisito da amostra genuína antes da produção em massa.
- **A integração MCP da MerchandAise é pública?:** O cartão de servidor MCP e os metadados atuais das ferramentas externas são públicos para descoberta por máquina. As chamadas de ferramentas individuais seguem o respetivo modelo de segurança declarado, e as operações protegidas de espaço de trabalho, fornecedor, empresa, orçamento e encomenda mantêm a autorização e as confirmações necessárias.

## Tem em mente um fluxo de trabalho com agentes?
Diga-nos a quem o assistente se destina, o que lhe deve ser permitido fazer e onde uma pessoa precisa de manter o controlo. Mapearemos o limite adequado de MCP, API e aprovação.
- **Analisar fluxo de trabalho de agente:** /pt/contact?intent=agent-mcp-review
- **Explorar contratos de API:** /pt/developers/api-integrations