{"pageKey":"Developers","slug":"developers-ai-agents-mcp","locale":"it","localeResolved":"it","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/it/developers/ai-agents-mcp","payload":{"slug":"developers-ai-agents-mcp","purpose":"llm-developers-ai-agents-mcp","title":"Agenti AI e MCP per flussi di lavoro di merchandise | MerchandAise","description":"Connetti gli agenti AI ai flussi di lavoro di merchandise di MerchandAise tramite la discovery pubblica di MCP, strumenti autorizzati, conferme umane e controlli sicuri per la produzione.","sections":[{"heading":"Un assistant. Un workflow governato.","paragraphs":["Un assistant può trasformare una descrizione o un riferimento caricato in una direzione di prodotto supportata, una vista 3D nativa del prodotto e un prezzo, MOQ e tempi di consegna supportati da un fornitore. Deve estendere il workflow di MerchandAise, non creare una seconda fonte di verità.","La server card e i metadata degli strumenti esterni sono pubblici per la discovery. Ogni chiamata a uno strumento rispetta comunque la sicurezza e i confini di workspace dichiarati, mentre acquirente, proof e approvazioni di produzione restano visibili e attribuibili."]},{"heading":"Scopri il server. Poi richiedi l'accesso appropriato.","items":[{"title":"Rilevamento e strumenti controllati MCP","description":"Utilizza la scheda server pubblica e l'elenco degli strumenti esterni per il rilevamento automatico, quindi rispetta i limiti dichiarati di sicurezza, area di lavoro e conferma di ciascuno strumento quando viene eseguito da un agente. Human guide: Leggi la guida all'implementazione di MCP (/it/developers/ai-agents-mcp). Machine-readable contract: Scheda server pubblica MCP JSON (/.well-known/mcp/server-card). Accesso: Pubblico. Documento di rilevamento pubblico per client automatici. L'elenco degli strumenti esterni all'indirizzo /api/v1/mcp/tools espone i metadati correnti degli strumenti; ogni chiamata di strumento rispetta comunque i limiti dichiarati di sicurezza, area di lavoro e conferma. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#mcp-tools."},{"title":"Documentazione degli strumenti dell'assistente API","description":"Esplora gli endpoint correnti dell'assistente e degli strumenti per le sessioni di progettazione e la revisione dell'integrazione. Questo riferimento pubblico non concede l'autorizzazione anonima per richiedere preventivi o effettuare ordini. Human guide: Apri la documentazione degli strumenti dell'assistente (/it/developers/api-integrations). Machine-readable contract: Strumenti dell'assistente OpenAPI JSON (/api/docs/openapi.json). Accesso: Pubblico. Riferimento pubblico per gli API dell'assistente e degli strumenti. L'accesso in produzione e le operazioni che influiscono sugli ordini richiedono comunque l'autorizzazione applicabile. Canonical page: /developers/ai-agents-mcp. Canonical section: /developers/ai-agents-mcp#api-docs."}]},{"heading":"Dalla discovery a un’azione governata","items":[{"title":"Step 1: Scopri in sicurezza","description":"Usa la public MCP server card e la lista tools per identificare MerchandAise e l’inventario corrente di strumenti esterni. La discovery da sola non concede ampia autorità per preventivare, cambiare stato o ordinare."},{"title":"Step 2: Concedi il minimo privilegio","description":"Autorizza solo gli strumenti, lo workspace e l’ambiente necessari all’assistant. Separa l’esplorazione in sola lettura dalle azioni che modificano design, preventivo, approvazione o stato d’ordine."},{"title":"Step 3: Conferma prima della conseguenza","description":"Mantieni conferme umane esplicite per azioni sensibili, testa comportamenti su stato obsoleto e rifiuto, e dimostra percorsi di recovery prima di abilitare traffico di produzione."}]},{"heading":"Cosa l’agente deve preservare","items":[{"title":"Uno stato prodotto versionato","description":"L’assistant opera sullo stesso design, intento commerciale, preventivo supportato da fornitore, approvazione e stato d’ordine di tutte le altre superfici MerchandAise."},{"title":"Riservatezza commerciale e del fornitore","description":"Quando MerchandAise processa la transazione d’acquisto, Hutter Products GmbH è il venditore contraente e Merchant of Record sotto il marchio MerchandAise. Identità, contatti e dati interni dei fornitori non sono esposti a un agente."},{"title":"I gate di proof restano umani","description":"Una vista 3D non costituisce una prova fisica. Il preventivo confermato spiega le opzioni di campionatura disponibili, i costi, i limiti e i tempi. Prima della produzione in serie, approva la prova digitale esatta e completa i controlli tecnici obbligatori e le approvazioni dei campioni richiesti o scelti. I requisiti degli ordini già accettati restano vincolanti."}]},{"heading":"Prima che un agente raggiunga la produzione","paragraphs":["Un server MCP discoverable è solo l’inizio. La readiness di produzione significa che l’assistant ha un ruolo delimitato, ogni azione consequenziale ha un owner e i fallimenti riportano gli utenti a uno stato sicuro."],"items":[{"title":"Mappa l’accesso in base alla conseguenza","description":"Classifica ogni strumento come sola lettura, consultivo, che cambia stato, sensibile al fornitore o che incide sull’ordine prima di concederlo a un assistant."},{"title":"Nomina ogni proprietario di conferma","description":"Definisci chi conferma le modifiche di prodotto, preventivi, digital proof, campioni di produzione e ordini—e cosa fa l’assistant quando quella persona non è disponibile."},{"title":"Osserva, rifiuta e recupera","description":"Testa input non validi, stato obsoleto, permessi mancanti, rifiuti, retry, telemetria e percorsi di rollback prima che traffico live raggiunga il workflow."}]},{"heading":"FAQ","items":[{"title":"Cosa può fare un agente AI con MerchandAise?","description":"Un assistant autorizzato può usare gli strumenti approvati per il suo workspace e ambiente, come discovery prodotto, guida su design o preventivi e altre operazioni esplicitamente abilitate. Gli strumenti disponibili e i loro permessi vengono definiti durante la revisione dell’integrazione."},{"title":"Un agente AI può piazzare ordini automaticamente?","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":"L’integrazione MCP di MerchandAise è pubblica?","description":"La server card MCP e i metadata degli strumenti esterni sono pubblici per la discovery macchina. Le chiamate ai singoli strumenti seguono il loro modello di sicurezza dichiarato, e le operazioni protette su workspace, fornitori, enterprise, preventivi e ordini mantengono le autorizzazioni e le conferme richieste."}]},{"heading":"Hai in mente un workflow per un agente?","paragraphs":["Dicci a chi serve l’assistant, cosa può fare e dove una persona deve restare in controllo. Mappiamo MCP, API e confini di approvazione adeguati."],"items":[{"title":"Revisiona un workflow agent","description":"/it/contact?intent=agent-mcp-review"},{"title":"Esplora i contratti API","description":"/it/developers/api-integrations"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}