{"pageKey":"Developers","slug":"developers-ai-agents-mcp","locale":"pt","localeResolved":"pt","fallbackApplied":false,"version":"developers-ai-agents-mcp@2026-11-19T12:57:25.264Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/pt/developers/ai-agents-mcp","payload":{"slug":"developers-ai-agents-mcp","purpose":"llm-developers-ai-agents-mcp","title":"Documentação de agentes de IA e MCP | MerchandAise","description":"Explore documentação MCP, descoberta do servidor e ferramentas de agentes de IA da MerchandAise para design de produtos e orientação de orçamentos, com permissões de espaço e aprovações do utilizador.","sections":[{"heading":"Compreenda o que o assistente pode fazer","paragraphs":["Em sessões compatíveis, um utilizador pode descrever uma ideia, ver o produto em 3D interativo e pedir alterações. O assistente usa a mesma informação de produto e estado de design do percurso MerchandAise; as ferramentas atuais determinam o que pode ler ou alterar.","A ficha do servidor e os metadados externos das ferramentas são públicos para descoberta. Cada chamada continua a seguir os limites declarados de segurança e espaço, enquanto as aprovações do comprador, da prova e da produção permanecem visíveis e atribuíveis."]},{"heading":"Descubra o servidor. Depois, peça o acesso adequado.","items":[{"title":"Agentes de IA e MCP","description":"Ligue um assistente de IA através do Model Context Protocol. Descubra ferramentas compatíveis e preserve as escolhas de design, as permissões e as confirmações exigidas do utilizador. Human guide: Leia o guia de implementação MCP (/pt/developers/ai-agents-mcp#implementation-checklist). Machine-readable contract: Ficha pública do servidor MCP em JSON (/.well-known/mcp/server-card). Acesso: Público. Documento público de descoberta para clientes automáticos. A lista externa de ferramentas em /api/v1/mcp/tools expõe os metadados atuais; cada chamada continua sujeita aos limites declarados de segurança, espaço de trabalho e confirmação. Canonical page: /pt/developers/ai-agents-mcp. Canonical section: /pt/developers/ai-agents-mcp#mcp-tools."},{"title":"Documentação API e OpenAPI","description":"Encontre a referência API para ferramentas de assistentes e sessões de design. Depois, escolha o contrato de comunidade, fornecedor ou empresa para o seu percurso. Human guide: Explore a documentação API (/pt/developers/api-integrations). Machine-readable contract: OpenAPI das ferramentas de assistentes em JSON (/api/docs/openapi.json). Acesso: Público. Referência pública para API de assistentes e ferramentas. O acesso de produção e as operações que afetam encomendas continuam a exigir a autorização aplicável. Canonical page: /pt/developers/ai-agents-mcp. Canonical section: /pt/developers/ai-agents-mcp#api-docs."}]},{"heading":"Da descoberta do servidor ao primeiro percurso","items":[{"title":"Step 1: Descubra em segurança","description":"Use a ficha pública do servidor MCP e a lista de ferramentas para identificar a MerchandAise e o conjunto atual de ferramentas externas. A descoberta, por si só, não concede autorização geral para orçamentar, alterar estados ou encomendar."},{"title":"Step 2: Conceda apenas as permissões necessárias","description":"Autorize apenas as ferramentas, o espaço e o ambiente de que o assistente precisa. Separe a exploração de leitura das ações que alteram um design, orçamento, aprovação ou estado de encomenda."},{"title":"Step 3: Confirme antes de haver consequências","description":"Mantenha confirmação humana explícita para ações sensíveis, teste estados desatualizados e recusas e comprove os percursos de recuperação antes de ativar tráfego de produção."}]},{"heading":"O que o agente deve preservar","items":[{"title":"Um estado de produto com versões","description":"O assistente trabalha com o mesmo design, intenção de compra, orçamento confirmado pelo fornecedor, aprovação e estado de encomenda das restantes interfaces MerchandAise."},{"title":"Privacidade comercial e de fornecedores","description":"Quando a MerchandAise processa a transação do comprador, a Hutter Products GmbH é o vendedor contratante e responsável pela transação sob a marca MerchandAise. A identidade, os contactos e os dados internos privados dos fornecedores não são expostos a um agente."},{"title":"As aprovações de provas continuam humanas","description":"Uma vista 3D não é uma prova física. O orçamento confirmado explica as opções de amostra disponíveis para o cliente, os custos, as limitações e os prazos. Aprove a prova digital exata e conclua as verificações técnicas obrigatórias e qualquer aprovação de amostra exigida ou selecionada antes da produção em série. Os requisitos de encomendas já aceites continuam a ser vinculativos."}]},{"heading":"Antes de um agente chegar à produção","paragraphs":["Um servidor MCP detetável é apenas o início. Estar pronto para produção significa que o assistente tem uma função limitada, cada ação com consequências 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 leitura, aconselhamento, alteração de estado, sensível para fornecedores ou com efeito em encomendas antes de a disponibilizar a um assistente."},{"title":"Identifique cada responsável por confirmações","description":"Defina quem confirma alterações de produto, orçamentos, provas digitais, amostras de produção e encomendas, e o que o assistente faz quando essa pessoa está indisponível."},{"title":"Observe, recuse e recupere","description":"Teste entradas inválidas, estados desatualizados, permissões em falta, recusas, novas tentativas, telemetria e percursos de reversão antes de o percurso receber tráfego real."}]},{"heading":"Perguntas frequentes","items":[{"title":"O que é MCP e esta é uma aplicação pública no ChatGPT?","description":"MCP significa Model Context Protocol: uma forma de um assistente descobrir e usar ferramentas. Estes documentos descrevem as capacidades de integração da MerchandAise. Uma ficha pública de servidor não confirma a disponibilidade na loja de aplicações do ChatGPT. O acesso ao espaço do ChatGPT depende da sua conta, da configuração da aplicação e do ambiente compatível."},{"title":"O que pode fazer um agente de IA com a MerchandAise?","description":"Um assistente autorizado pode usar as ferramentas aprovadas para o seu espaço e ambiente, como descoberta de produtos, orientação de design ou orçamento e outras operações explicitamente ativadas. As ferramentas disponíveis e as respetivas permissões são determinadas durante a análise da integração."},{"title":"Um agente de IA pode fazer encomendas automaticamente?","description":"Não basta descobrir o servidor ou listar ferramentas. Qualquer percurso que afete encomendas deve preservar a autenticação, a confirmação do comprador e do espaço, os preços atuais da versão, a aprovação da prova digital, a viabilidade de produção confirmada pelo fornecedor, as verificações técnicas obrigatórias e as escolhas e aprovações de amostra acordadas para a encomenda. Os requisitos de encomendas já aceites não podem ser dispensados sem aviso."},{"title":"A integração MCP da MerchandAise é pública?","description":"A ficha do servidor MCP e os metadados atuais das ferramentas externas são públicos para descoberta por máquinas. Cada chamada segue o modelo de segurança declarado, e as operações protegidas de espaço, fornecedor, empresa, orçamento e encomenda mantêm as autorizações e confirmações exigidas."}]},{"heading":"Tem um percurso de agente em mente?","paragraphs":["Diga-nos a quem serve o assistente, o que deve poder fazer e onde uma pessoa precisa de manter o controlo. Mapeamos os limites adequados de MCP, API e aprovação."],"items":[{"title":"Analise um percurso de agente","description":"/pt/contact?intent=agent-mcp-review"},{"title":"Explore contratos API","description":"/pt/developers/api-integrations"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}