# Documentação de agentes de IA e MCP | MerchandAise

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

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.

## Compreenda o que o assistente pode fazer
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.

## Descubra o servidor. Depois, peça o acesso adequado.
- **Agentes de IA e MCP:** 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.
- **Documentação API e OpenAPI:** 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.

## Da descoberta do servidor ao primeiro percurso
- **Step 1: Descubra em segurança:** 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.
- **Step 2: Conceda apenas as permissões necessárias:** 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.
- **Step 3: Confirme antes de haver consequências:** 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.

## O que o agente deve preservar
- **Um estado de produto com versões:** 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.
- **Privacidade comercial e de fornecedores:** 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.
- **As aprovações de provas continuam humanas:** 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.

## Antes de um agente chegar à produção
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.
- **Mapeie o acesso por consequência:** 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.
- **Identifique cada responsável por confirmações:** 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.
- **Observe, recuse e recupere:** 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.

## Perguntas frequentes
- **O que é MCP e esta é uma aplicação pública no ChatGPT?:** 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.
- **O que pode fazer um agente de IA com a MerchandAise?:** 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.
- **Um agente de IA pode fazer encomendas automaticamente?:** 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.
- **A integração MCP da MerchandAise é pública?:** 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.

## Tem um percurso de agente em mente?
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.
- **Analise um percurso de agente:** /pt/contact?intent=agent-mcp-review
- **Explore contratos API:** /pt/developers/api-integrations
