{"pageKey":"Developers","slug":"developers-ai-agents-mcp","locale":"pt","localeResolved":"pt","fallbackApplied":false,"version":"developers-ai-agents-mcp@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/pt/developers/ai-agents-mcp","payload":{"slug":"developers-ai-agents-mcp","purpose":"llm-developers-ai-agents-mcp","title":"Agentes AI e MCP para fluxos de merchandising | MerchandAise","description":"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.","sections":[{"heading":"Um assistente. Um fluxo de trabalho regulado.","paragraphs":["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."]},{"heading":"Descubra o servidor. Depois, solicite o acesso adequado.","items":[{"title":"Descoberta MCP e ferramentas reguladas","description":"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 (/.well-known/mcp/server-card). Acesso: Público. 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."},{"title":"Documentação da API de ferramentas do assistente","description":"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). Acesso: Público. 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."}]},{"heading":"Da descoberta a uma ação regulada","items":[{"title":"Step 1: Descubra com segurança","description":"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."},{"title":"Step 2: Conceda o privilégio mínimo","description":"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."},{"title":"Step 3: Confirme antes de agir","description":"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."}]},{"heading":"O que o agente deve preservar","items":[{"title":"Um estado de produto versionado","description":"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."},{"title":"Privacidade comercial e de fornecedores","description":"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."},{"title":"As aprovações de provas continuam humanas","description":"A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding."}]},{"heading":"Antes de um agente chegar à produção","paragraphs":["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."],"items":[{"title":"Mapeie o acesso por consequência","description":"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."},{"title":"Nomeie cada responsável pelas confirmações","description":"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."},{"title":"Observe, recuse e recupere","description":"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."}]},{"heading":"FAQ","items":[{"title":"O que pode um agente AI fazer com a MerchandAise?","description":"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."},{"title":"Pode um agente AI efetuar encomendas automaticamente?","description":"An authorized assistant can use the tools approved for its workspace and environment, such as product discovery, design or quote guidance, and other explicitly enabled operations. The available tools and their permissions are determined during integration review."},{"title":"A integração MCP da MerchandAise é pública?","description":"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."}]},{"heading":"Tem em mente um fluxo de trabalho com agentes?","paragraphs":["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."],"items":[{"title":"Analisar fluxo de trabalho de agente","description":"/pt/contact?intent=agent-mcp-review"},{"title":"Explorar contratos de API","description":"/pt/developers/api-integrations"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}