# Documentazione agenti IA e MCP | MerchandAise

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

Esplora la documentazione MCP MerchandAise, il server e gli strumenti IA per design e preventivi, con permessi dello spazio di lavoro e approvazioni degli utenti.

## Comprendi cosa può fare l’assistente
Nelle sessioni supportate, l’utente può descrivere un’idea, vedere il prodotto in 3D interattivo e chiedere modifiche. L’assistente usa le stesse informazioni sul prodotto e lo stesso stato del design del processo MerchandAise; gli strumenti attuali determinano cosa può leggere o modificare.
La scheda del server e i metadati degli strumenti esterni sono pubblici per la ricerca. Ogni chiamata rispetta comunque i limiti dichiarati di sicurezza e spazio di lavoro, mentre le approvazioni dell’acquirente, della prova e della produzione restano visibili e attribuibili.

## Scopri il server. Poi richiedi l'accesso appropriato.
- **Agenti IA e MCP:** Collega un assistente IA tramite il Model Context Protocol. Scopri gli strumenti supportati e conserva le scelte di design, i permessi e le conferme richieste dell’utente. Human guide: Leggi la guida all'implementazione di MCP (/it-ch/developers/ai-agents-mcp#implementation-checklist). Machine-readable contract: Scheda pubblica del server MCP in JSON (/.well-known/mcp/server-card). Accesso: Pubblico. Documento pubblico per la ricerca automatica dei client. L’elenco degli strumenti esterni in /api/v1/mcp/tools espone i metadati attuali; ogni chiamata rispetta comunque i limiti dichiarati di sicurezza, spazio di lavoro e conferma. Canonical page: /it-ch/developers/ai-agents-mcp. Canonical section: /it-ch/developers/ai-agents-mcp#mcp-tools.
- **Documentazione API e OpenAPI:** Trova il riferimento API per gli strumenti degli assistenti e le sessioni di design, poi scegli il contratto per community, fornitori o aziende adatto al tuo processo. Human guide: Esplora la documentazione API (/it-ch/developers/api-integrations). Machine-readable contract: OpenAPI JSON degli strumenti per assistenti (/api/docs/openapi.json). Accesso: Pubblico. Riferimento pubblico per le API degli assistenti e degli strumenti. L’accesso in produzione e le operazioni che influiscono sugli ordini richiedono comunque l’autorizzazione applicabile. Canonical page: /it-ch/developers/ai-agents-mcp. Canonical section: /it-ch/developers/ai-agents-mcp#api-docs.

## Dalla ricerca 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 ricerca da sola non concede ampia autorità per preventivare, cambiare stato o ordinare.
- **Step 2: Concedi il minimo privilegio:** Autorizza solo gli strumenti, lo spazio di lavoro e l’ambiente necessari all’assistente. 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’assistente 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 controlli di prova restano umani:** 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.

## Prima che un agente raggiunga la produzione
Un server MCP discoverable è solo l’inizio. La preparazione di produzione significa che l’assistente ha un ruolo delimitato, ogni azione consequenziale ha un responsabile 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 assistente.
- **Nomina ogni proprietario di conferma:** Definisci chi conferma le modifiche di prodotto, preventivi, prova digitale, campioni di produzione e ordini—e cosa fa l’assistente quando quella persona non è disponibile.
- **Osserva, rifiuta e recupera:** Testa input non validi, stato obsoleto, permessi mancanti, rifiuti, nuovi tentativi, telemetria e percorsi di rollback prima che traffico live raggiunga il processo.

## Domande frequenti
- **Cos’è MCP e questa è un’app pubblica di ChatGPT?:** MCP significa Model Context Protocol: permette a un assistente di scoprire e usare strumenti. Questi documenti descrivono le capacità di integrazione MerchandAise. Una scheda pubblica del server non conferma la disponibilità nello store delle app ChatGPT. L’accesso nello spazio di lavoro ChatGPT dipende dall’account, dalla configurazione dell’app e dall’ambiente supportato.
- **Cosa può fare un agente IA con MerchandAise?:** Un assistente autorizzato può usare gli strumenti approvati per il suo spazio di lavoro e ambiente, come la ricerca dei prodotti, la guida al design o al preventivo e altre operazioni esplicitamente abilitate. Strumenti disponibili e permessi vengono definiti durante la verifica dell’integrazione.
- **Un agente IA può ordinare automaticamente?:** Non per il solo fatto di scoprire il server o elencare gli strumenti. Ogni processo che influisce su un ordine deve mantenere autenticazione, conferma dell’acquirente e dello spazio di lavoro, prezzi della versione attuale, approvazione della prova digitale, producibilità confermata dal fornitore, controlli tecnici obbligatori e la scelta esatta dei campioni e delle approvazioni concordate per l’ordine. I requisiti già accettati non possono essere annullati senza comunicazione.
- **L’integrazione MCP MerchandAise è pubblica?:** La scheda del server MCP e i metadati attuali degli strumenti esterni sono pubblici per la ricerca automatica. Ogni chiamata segue il modello di sicurezza dichiarato; le operazioni protette su spazi di lavoro, fornitori, aziende, preventivi e ordini mantengono autorizzazioni e conferme richieste.

## Hai in mente un processo per un agente?
Dicci a chi serve l’assistente, cosa può fare e dove una persona deve restare in controllo. Mappiamo MCP, API e confini di approvazione adeguati.
- **Revisiona un processo agent:** /it-ch/contact?intent=agent-mcp-review
- **Esplora i contratti API:** /it-ch/developers/api-integrations