{"pageKey":"Developers","slug":"developers-ai-agents-mcp","locale":"en-US","localeResolved":"en-US","fallbackApplied":false,"version":"developers-ai-agents-mcp@2026-10-05T16:15:01.372Z","lastModified":null,"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 Documentation | MerchandAise","description":"Explore MerchandAise MCP documentation, server discovery and AI agent tools for product design and quote guidance, with workspace permissions and user approvals.","sections":[{"heading":"Understand what the assistant can do","paragraphs":["In supported sessions, a user can describe an idea, see the product in interactive 3D and ask for changes. The assistant uses the same product information and design state as the MerchandAise workflow; current tools determine what it can read or change.","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":"AI agents & MCP","description":"Connect an AI assistant through the Model Context Protocol. Discover supported tools and preserve the user’s design choices, permissions and required confirmations. Human guide: Read MCP implementation guide (/en-us/developers/ai-agents-mcp#implementation-checklist). Machine-readable contract: Public MCP server-card JSON (/.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":"API docs & OpenAPI","description":"Find the API reference for assistant tooling and design sessions, then choose the community, supplier or enterprise contract for your workflow. Human guide: Explore API 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 server discovery to your first workflow","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":"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":"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 is MCP, and is this a public ChatGPT app?","description":"MCP stands for Model Context Protocol: a way for an assistant to discover and use tools. These documents describe MerchandAise integration capabilities. A public server card does not confirm ChatGPT app-store availability. ChatGPT workspace access depends on your account, app setup and the supported environment."},{"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 supplier-confirmed producibility, mandatory technical checks, and the exact customer-sample choice and approval requirements agreed for the order. Existing accepted-order requirements cannot be silently waived."},{"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":"route-owned-source","schema":"2025-11-05"}}