# Ferramentas MCP + Documentos API | MerchandAise

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

Exponha recursos MerchandAise aprovados a agentes AI por meio de definições de ferramentas compatíveis com MCP detectáveis ​​e terminais de execução com autorização de assistente. Revise documentos legíveis por humanos e contratos OpenAPI legíveis por máquina para planejamento, testes e gerenciamento de versão com versão. Use APIs MerchandAise, contratos OpenAPI, incorporações de comunidade, fluxos de trabalho de fornecedores, identidade empresarial e ferramentas MCP para conectar mercadorias personalizadas em sites, portais e agentes AI.

## Superfícies de integração e contratos
Use APIs MerchandAise, contratos OpenAPI, incorporações de comunidade, fluxos de trabalho de fornecedores, identidade empresarial e ferramentas MCP para conectar mercadorias personalizadas em sites, portais e agentes AI.
Exponha recursos MerchandAise aprovados a agentes AI por meio de definições de ferramentas compatíveis com MCP detectáveis ​​e terminais de execução com autorização de assistente.
Revise documentos legíveis por humanos e contratos OpenAPI legíveis por máquina para planejamento, testes e gerenciamento de versão com versão.

## Superfícies de integração e contratos
- **Ferramentas MCP:** Exponha recursos MerchandAise aprovados a agentes AI por meio de definições de ferramentas compatíveis com MCP detectáveis ​​e terminais de execução com autorização de assistente. Human guide: Ferramentas MCP (/pt/developers/ai-agents-mcp#implementation-checklist). Machine-readable contract: Abra o terminal de ferramentas MCP (/pt/.well-known/mcp/server-card). Access: public. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#mcp-tools.
- **Documentos API:** Revise documentos legíveis por humanos e contratos OpenAPI legíveis por máquina para planejamento, testes e gerenciamento de versão com versão. Human guide: Documentos API (/pt/developers/api-integrations). Machine-readable contract: Assistant tooling OpenAPI JSON (/api/docs/openapi.json). Access: public. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#api-docs.

## Início rápido de integração
- **Step 1: Escolha o contrato que corresponde ao seu fluxo de trabalho:** Comece com a superfície que corresponde ao seu usuário e modelo de autenticação: incorporação de comunidade, identidade empresarial, operações de fornecedor ou ferramentas MCP para assistentes.
- **Step 2: Valide limites de autenticação, controle de versão e ambiente:** Confirme os cabeçalhos, escopos, expectativas de retorno de chamada e versões do contrato necessários na preparação antes de rotear o tráfego de produção.
- **Step 3: Teste fluxos de trabalho completos antes do lançamento:** Verifique solicitações, webhooks, provisionamento, observabilidade e caminhos de reversão para que a integração seja confiável desde o primeiro uso ao vivo.

## Quem constrói com MerchandAise
- **Operadores comunitários:** Lance vitrines incorporadas, transferências de configuradores e fluxos comunitários dentro de sites de clubes, ligas e empresas com contratos públicos versionados.
- **Equipes empresariais e parceiros de plataforma:** Conecte portais de compras, sistemas de identidade e operações internas a fluxos de trabalho de mercadorias sem reconstruir a aprovação e a lógica do fornecedor.
- **Agente AI e construtores de automação:** Dê aos assistentes acesso estruturado a ferramentas para descoberta, cotação e operações aprovadas por meio de endpoints compatíveis com MCP.

## Production launch gates for developers
A production integration needs more than a public endpoint. Use these gates to decide whether your workflow is ready for customer, supplier, enterprise, or AI-agent traffic.
- **Sandbox and access review:** Confirm which contracts are public, which enterprise surfaces require approval, and which credentials or workspace roles are needed before launch.
- **Versioned implementation evidence:** Keep generated clients, callback URLs, auth scopes, contract versions, and rollback ownership documented before production traffic is enabled.
- **Operational observability:** Plan logs, retries, support ownership, failure states, and health checks for every workflow that can affect an order, supplier, or enterprise user.

## Precisa de uma revisão de integração?
Compartilhe sua arquitetura, cronograma de implementação e canais de destino. Recomendaremos a superfície de contrato, o padrão de autenticação e a sequência de lançamento corretos.
- **Fale com a equipe de integrações:** /pt/contact?intent=agent-mcp-review
- **View AI product designer:** /pt/ai-custom-product-designer