{"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 (/it/.well-known/mcp/server-card). Access: public. 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). Access: public. 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":"AI e la vista 3D nativa del prodotto supportano la decisione, ma l’approvazione del digital proof e l’approvazione del campione reale rimangono richieste prima della produzione di massa."}]},{"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":"Non solo scoprendo il server o elencando gli strumenti. Qualsiasi workflow che incide su ordini deve preservare autenticazione, conferma dell’acquirente e dello workspace, prezzi version-current, approvazione del digital proof e il gate del campione reale richiesto prima della produzione di massa."},{"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"}}