Claude, ChatGPT, Codex, Cursor
Claude Code, Codex e Cursor si collegano con una chiave API; claude.ai e ChatGPT come connettore, con «Consenti». Poi l'assistente lavora sui tuoi dati in linguaggio naturale: cerca, conta e propone correzioni.
Reparto vendite e clienti uno dei reparti della tua azienda AI
Server MCP e API per collegare il negozio a Claude, ChatGPT e ai tuoi sistemi
Un server MCP permette a un assistente AI di leggere e modificare i dati di un programma. Quello di Elbuz dà a Claude, ChatGPT, Codex o Cursor l'accesso a prodotti, clienti e ordini con i permessi di un dipendente, e tu approvi ogni modifica in «Polso».
- MCP
- Claude
- ChatGPT
- Codex
- Cursor
- API v2
- Webhook
Cos'è un server MCP?
Un unico standard per tutti gli assistenti AI, senza un'integrazione diversa per ognuno.
MCP (Model Context Protocol) è uno standard aperto con cui gli assistenti AI si collegano a un programma. Il server MCP è la parte del programma che dice all'assistente quali dati e quali azioni sono disponibili ed esegue le sue richieste. L'assistente interroga il server MCP di Elbuz, il server risponde con i dati che può vedere un determinato dipendente e ogni modifica torna a te per l'approvazione: assistente ↔ MCP ↔ Elbuz.
- TrasportoStreamable HTTP: richieste JSON-RPC via POST
- Connessionechiave API oppure OAuth con la schermata «Consenti»
- Strumentidescrivere, cercare, leggere, aggregare, creare, modificare, eseguire un'azione, cercare nella guida
- Niente cancellazionil'assistente non può eliminare nulla
Collegare Claude e ChatGPT al negozio
Un server MCP per l'e-commerce: il tuo assistente accede ai dati di Elbuz senza sviluppo.
Controllo del catalogo
Conta, categoria per categoria, i prodotti senza foto, senza descrizione o senza prezzo.
Ordine nelle anagrafiche
Trova attributi o produttori doppi e propone di unire ogni coppia.
Testi e correzioni
Scrive descrizioni brevi dei prodotti; ogni modifica aspetta il tuo «Accetta».
Sicurezza: chiavi, permessi del dipendente e «Polso»
L'assistente vede solo ciò che è consentito a un dipendente, e le sue modifiche arrivano prima in «Polso».
- Chiave a nome di un dipendentel'assistente o il programma vedono solo ciò che è consentito a quel dipendente
- «Dati visibili»limita clienti e documenti come nelle finestre
- La chiave nuova è «Sola lettura»la scrittura si abilita a parte
- Modifiche tramite «Polso»ognuna arriva come «prima → dopo» e aspetta l'approvazione; solo la «Direzione» può attivare «Agisci da solo»
Esempi di uso: cosa puoi chiedere all'assistente
Alcuni compiti che l'assistente svolge partendo da una richiesta in linguaggio naturale.
- Prodotti senza fotoper categoria
- Unire attributi doppicoppia per coppia
- Scrivere descrizioni brevicon il tuo «Accetta»
- Report sugli ordinidel giorno o della settimana
- Clienti senza follow-upl'elenco e i contatti di domani
- Controllare le giacenzesenza modificare alcun dato
API REST v2 per le integrazioni
Un'API per l'e-commerce: il tuo sito, il tuo CMS o il tuo gestionale scambiano prodotti, clienti e ordini con Elbuz.
API v2
Catalogo, listini, clienti, documenti, trattative e agenda, con i permessi di un dipendente; chiave Bearer, limite di 120 richieste al minuto per chiave (MCP incluso) e modifiche lette con un cursore, senza buchi.
Ordini dal sito
POST /api/v2/orders/sync riceve ordini in lotti fino a 100; un nuovo invio dopo un'interruzione della connessione non crea doppioni (Idempotency-Key). Per OpenCart 3 c'è un modulo pronto.
Webhook
Elbuz avvisa il tuo server delle modifiche a clienti, documenti e richieste di «Polso», in lotti fino a 100 e con fino a sei tentativi di consegna se il tuo server non risponde.
Cosa succede agli ordini dentro Elbuz: gestione degli ordini.
Domande sul server MCP e sull'API
Cosa sono i server MCP e il Model Context Protocol?
MCP (Model Context Protocol) è uno standard aperto che permette a un assistente AI di collegarsi a un programma e lavorare con i suoi dati. Il server MCP è la parte del programma: indica all'assistente quali dati e azioni esistono ed esegue le sue richieste. Il server MCP di Elbuz dà accesso a catalogo, listini, clienti, documenti, trattative ed e-mail: scrivi in linguaggio naturale e l'assistente cerca, calcola e propone modifiche.
Che differenza c'è tra MCP e un'API?
Un'API è un'interfaccia per programmi: il tuo sito o il tuo gestionale scambia dati con Elbuz tramite richieste descritte nella documentazione. MCP è uno strato per gli assistenti AI: l'assistente stesso scopre quali dati ci sono e cosa può farci, e agisce secondo le tue istruzioni. In Elbuz entrambi funzionano con gli stessi permessi del dipendente e lo stesso «Polso».
Come si collega il server MCP di Elbuz a Claude o ChatGPT?
In Claude Code, Codex o Cursor aggiungi il server MCP di Elbuz con una chiave API creata a nome di un dipendente. In claude.ai e ChatGPT si aggiunge come connettore: non serve una chiave, accedi a Elbuz e premi «Consenti» (OAuth). L'accesso si revoca nella finestra «API e token di accesso».
L'assistente AI può danneggiare qualcosa nel negozio?
Non senza la tua approvazione. L'assistente lavora con i permessi del dipendente per cui è stata emessa la chiave, e una chiave nuova nasce come «Sola lettura». Se la scrittura è abilitata, per impostazione predefinita ogni modifica aspetta la tua approvazione in «Polso» come «prima → dopo». Solo la «Direzione» può attivare «Agisci da solo», e un freno di emergenza riporta la chiave alla modalità «Chiedi» se fa troppe modifiche in un'ora. Il server MCP non ha alcuno strumento per cancellare.
Come invio gli ordini del mio sito a Elbuz tramite API?
Il tuo sito, il tuo CMS o il tuo gestionale invia gli ordini nuovi e le loro modifiche con una richiesta POST /api/v2/orders/sync, in lotti fino a 100. I nuovi diventano documenti «Ordine cliente», quelli già caricati vengono riconosciuti e aggiornati, senza doppioni.
Quali limiti ha l'API?
120 richieste al minuto per chiave, e le richieste dell'assistente MCP con la stessa chiave rientrano in questo limite. Gli ordini si ricevono in lotti fino a 100; i webhook arrivano in lotti fino a 100, con fino a sei tentativi di consegna se il tuo server non risponde. Una chiave vede e modifica solo ciò che consentono i permessi del suo dipendente.
Cos'altro fa la tua azienda AI
14 giorni gratis
Collega il tuo assistente AI a Elbuz
Nella tua azienda AI lavorano già dipendenti AI, e con MCP anche il tuo assistente si unisce a loro. 50 € di credito alla registrazione e 14 giorni per provarlo.