{"pageKey":"Developers","slug":"developers-ai-agents-mcp","locale":"en-US","localeResolved":"en-US","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/en-us/developers/ai-agents-mcp","payload":{"slug":"developers-ai-agents-mcp","purpose":"llm-developers-ai-agents-mcp","title":"AI agents & MCP for merchandise workflows | MerchandAise","description":"Connect AI agents to MerchandAise merchandise workflows through public MCP discovery, permissioned tools, human confirmations, and production-safe controls.","sections":[{"heading":"One assistant. One governed workflow.","paragraphs":["An assistant can help turn a description or uploaded reference into a supported product direction, product-native 3D view, and supplier-backed price, MOQ, and delivery expectations. It should extend the MerchandAise workflow, not create a second source of truth.","The server card and external tool metadata are public for discovery. Each tool call still follows its declared security and workspace boundary, while buyer, proof, and production approvals stay visible and attributable."]},{"heading":"Discover the server. Then request the right access.","items":[{"title":"MCP discovery and governed tools","description":"Use the public server card and external tools list for machine discovery, then honor each tool’s declared security, workspace, and confirmation boundaries when an agent executes it. Human guide: Read MCP implementation guide (/en-us/developers/ai-agents-mcp#implementation-checklist). Machine-readable contract: Public MCP server-card JSON (/en-us/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The external tools list at /api/v1/mcp/tools exposes current tool metadata; each tool call still follows its declared security, workspace, and confirmation boundaries. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#mcp-tools."},{"title":"Assistant tooling API docs","description":"Explore current assistant and tooling endpoints for design sessions and integration review. This public reference does not grant anonymous authority to quote or place an order. Human guide: Open assistant tooling docs (/en-us/developers/api-integrations). Machine-readable contract: Assistant tooling OpenAPI JSON (/api/docs/openapi.json). Access: public. Public reference for assistant and tooling APIs. Production access and order-affecting operations still require the applicable authorization. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#api-docs."}]},{"heading":"From discovery to a governed action","items":[{"title":"Step 1: Discover safely","description":"Use the public MCP server card and tools list to identify MerchandAise and the current external tool inventory. Discovery alone grants no broad authority to quote, change state, or order."},{"title":"Step 2: Grant the least privilege","description":"Authorize only the tools, workspace, and environment the assistant needs. Separate read-only exploration from actions that change a design, quote, approval, or order state."},{"title":"Step 3: Confirm before consequence","description":"Keep explicit human confirmation for sensitive actions, test stale-state and refusal behavior, and prove recovery paths before production traffic is enabled."}]},{"heading":"What the agent must preserve","items":[{"title":"One versioned product state","description":"The assistant works against the same design, commerce intent, supplier-backed quote, approval, and order state as every other MerchandAise surface."},{"title":"Commercial and supplier privacy","description":"Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Private supplier identity, contacts, and internal data are not exposed to an agent."},{"title":"Proof gates stay human","description":"AI and product-native 3D support the decision, but digital-proof approval and approval of a genuine production sample remain required before mass production."}]},{"heading":"Before an agent reaches production","paragraphs":["A discoverable MCP server is only the beginning. Production readiness means the assistant has a bounded role, every consequential action has an owner, and failures return users to a safe state."],"items":[{"title":"Map access by consequence","description":"Classify every tool as read-only, advisory, state-changing, supplier-sensitive, or order-affecting before granting it to an assistant."},{"title":"Name every confirmation owner","description":"Define who confirms product changes, quotes, digital proofs, production samples, and orders—and what the assistant does when that person is unavailable."},{"title":"Observe, refuse, and recover","description":"Test invalid inputs, stale state, missing permissions, refusals, retries, telemetry, and rollback paths before live traffic reaches the workflow."}]},{"heading":"FAQ","items":[{"title":"What can an AI agent do with MerchandAise?","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":"Can an AI agent place orders automatically?","description":"Not by discovering the server or listing tools. Any order-affecting workflow must preserve authentication, buyer and workspace confirmation, version-current pricing, digital-proof approval, and the genuine-sample gate required before mass production."},{"title":"Is the MerchandAise MCP integration public?","description":"The MCP server card and current external tool metadata are public for machine discovery. Individual tool calls follow their declared security model, and protected workspace, supplier, enterprise, quote, and order operations retain their required authorization and confirmations."}]},{"heading":"Have an agent workflow in mind?","paragraphs":["Tell us who the assistant serves, what it should be allowed to do, and where a person needs to stay in control. We will map the right MCP, API, and approval boundary."],"items":[{"title":"Review an agent workflow","description":"/en-us/contact?intent=agent-mcp-review"},{"title":"Explore API contracts","description":"/en-us/developers/api-integrations"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}