# Agenti AI e MCP per flussi di lavoro di merchandise | MerchandAise

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

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.

## Un assistant. Un workflow governato.
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.

## Scopri il server. Poi richiedi l'accesso appropriato.
- **Rilevamento e strumenti controllati MCP:** 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.
- **Documentazione degli strumenti dell'assistente API:** 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.

## Dalla discovery a un’azione governata
- **Step 1: Scopri in sicurezza:** 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.
- **Step 2: Concedi il minimo privilegio:** 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.
- **Step 3: Conferma prima della conseguenza:** 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.

## Cosa l’agente deve preservare
- **Uno stato prodotto versionato:** L’assistant opera sullo stesso design, intento commerciale, preventivo supportato da fornitore, approvazione e stato d’ordine di tutte le altre superfici MerchandAise.
- **Riservatezza commerciale e del fornitore:** 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.
- **I gate di proof restano umani:** 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.

## Prima che un agente raggiunga la produzione
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.
- **Mappa l’accesso in base alla conseguenza:** Classifica ogni strumento come sola lettura, consultivo, che cambia stato, sensibile al fornitore o che incide sull’ordine prima di concederlo a un assistant.
- **Nomina ogni proprietario di conferma:** 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.
- **Osserva, rifiuta e recupera:** Testa input non validi, stato obsoleto, permessi mancanti, rifiuti, retry, telemetria e percorsi di rollback prima che traffico live raggiunga il workflow.

## FAQ
- **Cosa può fare un agente AI con MerchandAise?:** 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.
- **Un agente AI può piazzare ordini automaticamente?:** 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.
- **L’integrazione MCP di MerchandAise è pubblica?:** 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.

## Hai in mente un workflow per un agente?
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.
- **Revisiona un workflow agent:** /it/contact?intent=agent-mcp-review
- **Esplora i contratti API:** /it/developers/api-integrations