Connettore MCP: differenze tra le versioni

AdA, Connettore MCP e Assistant DocAI
 
Connettore MCP: istanza dedicata per cliente
 
(2 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:
{{Riepilogo|Il '''Connettore MCP''' di QCSNET (Assistant MCP Connector) è il ponte sicuro tra i modelli di intelligenza artificiale e i software aziendali: permette ad [[AdA]], a Claude (Desktop, Code, web) e a ogni client compatibile con lo standard MCP di leggere dati, inserire operazioni e preparare documenti in Evolution, CRM, WMS, DocAI e programmi di terzi, sempre con i permessi dell'utente.}}
{{Riepilogo|Il '''Connettore MCP''' di QCSNET è il ponte sicuro tra l'intelligenza artificiale e i software aziendali: collega i modelli AI ad Assistant (Evolution, CRM, WMS, DocAI) e a qualsiasi software di terze parti con API. L'AI smette di scrivere testi generici e lavora sui dati reali, con un solo punto di accesso e un solo livello di sicurezza. Funziona con [[AdA]] oppure con il tuo provider (Claude Desktop, Claude Code o un altro client compatibile MCP).}}


== Cos'è ==
== Due modi di usarlo ==
MCP (''Model Context Protocol'') è lo standard aperto con cui un assistente AI usa strumenti esterni. Il connettore QCSNET espone come strumenti le funzioni dei nostri prodotti: l'AI capisce la richiesta in linguaggio naturale, sceglie lo strumento giusto e lo usa per conto dell'utente.
{| class="wikitable"
! Modo !! Come funziona
|-
| '''Con AdA''' || [[AdA]] è l'interfaccia QCSNET con i migliori modelli (Claude, ChatGPT, Mistral, GLM e altri) già provati, ruoli, gruppi e permessi per utente. Il connettore è già collegato; paghi i consumi (token) dei modelli.
|-
| '''Con il tuo provider''' || Se usi già Claude Desktop, Claude Code o un altro client compatibile con il ''Model Context Protocol'', colleghi il connettore e resti con il tuo abbonamento: l'AI raggiunge i tuoi software con gli stessi permessi e le stesse regole.
|}


== Con quali client funziona ==
{{Nota|Con un provider esterno il testo della conversazione è trattato dal provider scelto, secondo le sue condizioni. I dati aziendali restano nei sistemi collegati.}}
* [[AdA]], l'interfaccia AI di QCSNET;
* '''Claude''' (Desktop, Code e web), aggiungendo il connettore tra i connettori personalizzati;
* ogni altro client compatibile con MCP.


L'indirizzo del connettore e l'attivazione per la tua azienda li fornisce QCSNET.
== Sa, fa, orchestra ==
* '''Sa''': giacenze, movimentazioni, ubicazioni, clienti, fatturato, costi e margini, in tempo reale e in linguaggio naturale, senza query né report.
* '''Fa''': inserisce operazioni e manutenzioni da testo o da documento (con OCR), prepara offerte, apre e lavora ticket, scrive email, crea campagne.
* '''Orchestra''': una sola richiesta attraversa più software e più passaggi, dall'arrivo della richiesta fino all'avviso al cliente.


== Cosa può fare ==
== Cosa puoi fare ==
Le funzioni disponibili dipendono dai moduli Assistant attivi e dai permessi dell'utente.
{| class="wikitable"
{| class="wikitable"
! Area !! Esempi di strumenti
! Area !! Esempi
|-
|-
| '''Logistica''' ([[Assistant Evolution]]) || Inserire servizi di trasporto anche da allegati (ordini, DDT letti con OCR), consultare servizi, bordereau e viaggi.
| '''Interrogare''' || Giacenze, movimentazioni e ubicazioni; dati economici (fatturato, costi, margini, confronti tra anni); documentazione (questa wiki), email e cronologia delle conversazioni.
|-
|-
| '''CRM''' ([[Assistant CRM]]) || Elencare, aprire e aggiornare ticket, registrare commenti e ore, spostare le fasi; leggere e inviare email; gestire offerte, liste marketing e campagne; consultare richieste di assistenza.
| '''Inserire e modificare''' || Servizi di trasporto, operazioni e manutenzioni da testo libero o da allegati con OCR; offerte, ticket, commenti, ore lavorate, cambi di fase.
|-
|-
| '''Magazzino''' ([[Assistant WMS]]) || Consultare giacenze, movimenti e ubicazioni; inserire operazioni.
| '''Comunicare''' || Email commerciali e tecniche costruite sul contesto reale; campagne e liste di destinatari segmentate; comunicazioni di rilascio ai clienti.
|-
|-
| '''Documenti''' ([[Assistant DocAI]]) || Inviare documenti a DocAI e leggerne i risultati.
| '''Orchestrare''' || Flussi logistici e operativi complessi; processi ripetibili e programmabili.
|-
|-
| '''Dati e analisi''' || Consultare i dati con query in sola lettura, esportarli, fare previsioni su serie storiche.
| '''Sistemi di bordo''' || Chiedere al satellitare dove si trova un mezzo, che percorso ha fatto o quando arriverà, senza aprire il portale del fornitore.
|-
|-
| '''Informazioni commerciali''' || Ricerca aziende e report di affidabilità (Creditsafe), arricchimento delle anagrafiche.
| '''Contabilità''' || Dal documento alla registrazione: l'AI compone le scritture e le mostra in anteprima; tu confermi, lei registra.
|-
|-
| '''Comunicazione''' || Preparare email e chiamate, leggere le trascrizioni delle chiamate.
| '''Posta elettronica''' || Smistare le richieste, riconoscere le urgenti, collegarle a clienti e ticket e preparare la risposta (che resta in bozza finché non la invii).
|-
|-
| '''Privacy''' || Anonimizzare testi e documenti prima dell'elaborazione e ripristinare i dati originali.
| '''Previsioni''' || Interrogare il database in linguaggio naturale e proiettare volumi, fatturato e andamenti, con interrogazioni in sola lettura validate prima dell'esecuzione.
|-
|-
| '''Documentazione''' || Cercare in questa wiki per rispondere alle domande sull'uso dei prodotti.
| '''Protezione''' || Anonimizzare i dati sensibili prima che arrivino al modello e ripristinarli a lavoro finito.
|-
|-
| '''Programmi di terzi''' || Ogni software con API (OpenAPI o WSDL) registrato nel connettore.
| '''Informazioni commerciali''' || Ricerca aziende e solvibilità dei clienti.
|}
|}
Gli strumenti disponibili dipendono dai prodotti attivi per la tua azienda e dai permessi del tuo utente.
 
=== Basta una frase ===
* «Quanta merce del depositante Rossi è ferma in magazzino da più di 90 giorni, e dove si trova?» → risposta immediata con ubicazioni e quantità.
* «Ecco il documento di trasporto: inserisci l'operazione di carico.» → il documento viene letto con OCR, l'operazione compilata e mostrata prima di registrarla.
* «Il cliente ha segnalato un problema: aprimi il ticket, registra le ore e prepara la risposta.» → ticket aperto, ore rendicontate, email in bozza da rivedere.
* «Controlla l'affidabilità di questo nuovo cliente, verifica se è già in anagrafica e, se è tutto a posto, preparami l'offerta.» → servizio di credito esterno, CRM e offerta: tre software, una sola richiesta.
 
== Non solo Assistant ==
{| class="wikitable"
! Software !! Collegamento
|-
| QCSNET: [[Assistant Evolution]], [[Assistant CRM]], [[Assistant WMS]], [[Assistant DocAI]] || Integrazione nativa, già pronta.
|-
| Terze parti: ERP, TMS, servizi esterni || Collegati tramite le loro API (OpenAPI o WSDL), senza sviluppare un'integrazione per ogni AI.
|-
| Il tuo software interno || Lo collega QCSNET e diventa uno strumento dell'AI.
|}
Categorie già collegabili: ERP e contabilità; TMS e piattaforme di trasporto; informazioni commerciali; infrastruttura IT; fonti web con riferimenti verificabili.


== Sicurezza ==
== Sicurezza ==
* Autenticazione aziendale (Zitadel, OIDC): l'AI agisce con l'identità e i permessi dell'utente, riga per riga.
Le regole le applica il connettore, non il modello:
* Ogni azienda è isolata (multi-tenant) e ogni operazione è tracciata.
* '''Permessi riga per riga''': l'AI accede solo a ciò a cui accede l'utente che la sta usando.
* Le operazioni che modificano dati richiedono conferma.
* '''Autenticazione enterprise''': Zitadel con JWT e OIDC, nessuna credenziale condivisa.
* Le credenziali dei software collegati restano nel connettore e il modello non le vede mai.
* '''Istanza dedicata''': ogni cliente ha il proprio connettore; dati e operazioni di ogni azienda e di ogni depositante sono separati e tracciati.
* '''Doppio passaggio sulle scritture''': ogni operazione che modifica dati prevede anteprima e conferma esplicita, anche sui software terzi.
* '''Tracciabilità''': ogni operazione ha riferimenti controllabili.
* '''Credenziali al sicuro''': le chiavi dei software terzi restano nel connettore; il modello non le vede mai.
 
== Attivazione ==
Ogni cliente ha un'istanza del connettore dedicata, con il proprio indirizzo. Si attiva in pochi passaggi, senza sviluppo: QCSNET fornisce l'indirizzo della tua istanza da aggiungere al client (vedi [[Connettore MCP/Collegare un client|Collegare un client]]) (in Claude: tra i connettori personalizzati) e l'accesso avviene con l'account aziendale. Per [[Assistant WMS]] il connettore è disponibile anche come AddOn dedicato: vedi il [https://www.qcsnet.it/it/connettore-mcp-per-assistant-wms sito QCSNET].
 


== Per il WMS ==
== Guide ==
Il connettore per [[Assistant WMS]] è disponibile anche come AddOn dedicato. Vedi il [https://www.qcsnet.it/it/connettore-mcp-per-assistant-wms sito QCSNET].
* [[Connettore MCP/Collegare un client|Collegare Claude o un altro client]]
* [[Connettore MCP/Strumenti|L'elenco degli strumenti e i flussi tipici]]


[[Categoria:Intelligenza artificiale]]
[[Categoria:Intelligenza artificiale]]
[[Categoria:Prodotti QCSNET]]
[[Categoria:Prodotti QCSNET]]