GuideCollegare client IA

Collegare client IA (MCP)

DataCNVS esegue un server Model Context Protocol (MCP), così puoi lavorare sui tuoi canvas dagli strumenti di IA che già usi. Chiedi a Claude o a Claude Code di trovare un'osservazione, costruire una figura a più pannelli, convertire un asse in altre unità o ridisegnare lo stile di un canvas: le modifiche vengono fatte in DataCNVS a tuo nome, e tu e i tuoi collaboratori le vedete in tempo reale.

In questa pagina

I valori dei tuoi dati non raggiungono mai l'IA

I client IA collegati costruiscono e modificano il grafico: pannelli, assi, serie, etichette e stile. Non ricevono mai i numeri contenuti nelle tue osservazioni. DataCNVS disegna la figura a partire dai tuoi dati all'interno dell'app. Come funziona.

Prima di iniziare #

Un piano DataCNVS a pagamento. MCP è incluso in ogni piano DataCNVS a pagamento. In un'area di lavoro il cui piano non lo include, ogni strumento lo spiega e non fa nulla.
MCP attivato per la tua area di lavoro. Gli amministratori dell'area di lavoro lo gestiscono in Impostazioni → Area di lavoro → Generale → IA → MCP / client IA esterni. Disattivarlo impedisce ai client IA di accedere anche ai canvas e alle osservazioni di quell'area di lavoro, ovunque siano condivisi.
I tuoi permessi. Il client IA agisce a tuo nome. Può aprire esattamente i canvas e le osservazioni che puoi aprire tu e modificare solo dove puoi modificare tu.

Tutti i client si collegano allo stesso URL del server:

https://mcp.datacnvs.com/mcp

Inserimento nelle directory

DataCNVS è presente nella directory dei connettori di Claude, quindi puoi collegarlo direttamente da Claude senza alcuna configurazione. Lo stiamo inviando anche alla directory di ChatGPT; finché non sarà elencato lì, usa le impostazioni generiche qui sotto.

Claude (web, desktop e mobile) #

DataCNVS è nella directory dei connettori di Claude, quindi collegarlo richiede pochi clic. Un connettore aggiunto su claude.ai è disponibile anche nelle app Claude per desktop e dispositivi mobili, con lo stesso account. Per usare il connettore non serve un abbonamento Claude a pagamento.

Apri la pagina di DataCNVS nella directory di Claude, oppure vai in Settings → Connectors in Claude e cerca DataCNVS.
Scegli Connect to Claude.
Accedi con il tuo account DataCNVS e approva l'accesso richiesto da Claude: leggere i tuoi canvas e modificarli.
Imposta i permessi degli strumenti come consigliato qui sotto.
In una chat, attiva DataCNVS dal menu degli strumenti e chiedi pure.

Permessi degli strumenti consigliati #

Per impostazione predefinita, Claude chiede conferma prima di ogni strumento che modifica qualcosa. Apri Settings → Connectors → DataCNVS e imposta i permessi degli strumenti. Consigliamo Always allow per tutti gli strumenti di lettura e scrittura, tranne quelli il cui nome inizia con la parola delete. Lascia questi su Needs approval per evitare eliminazioni accidentali.

Strumenti di eliminazionedelete_canvasdelete_canvas_themedelete_observationdelete_observation_memberdelete_plot_objectdelete_variable

Gli strumenti di lettura e scrittura si possono automatizzare senza rischi: le modifiche vengono applicate a tuo nome, compaiono in tempo reale ai collaboratori e si possono annullare per 7 giorni. Le eliminazioni sono definitive, quindi l'ultima parola resta a te.

Su Claude Team ed Enterprise, un Owner aggiunge il connettore una sola volta per l'organizzazione. Ogni membro lo collega poi con il proprio accesso a DataCNVS, così ognuno lavora con i propri permessi.

Claude Code #

Aggiungi il server dal terminale:

bash

claude mcp add --transport http datacnvs https://mcp.datacnvs.com/mcp \
  --client-id 3f7or4t9so6894qi3ofgbgs79j --callback-port 33418

Poi avvia Claude Code, esegui /mcp, scegli datacnvs e seleziona Authenticate. Il browser apre l'accesso a DataCNVS e Claude Code salva il token per te.

Mantieni --callback-port 33418 esattamente com'è: DataCNVS accetta solo accessi che ritornano a quella porta. Se la sta usando un altro programma, chiudilo e riprova.

Il comando qui sopra aggiunge DataCNVS solo al progetto corrente. Per averlo in ogni progetto, aggiungi --scope user:

bash

claude mcp add --transport http --scope user datacnvs https://mcp.datacnvs.com/mcp \
  --client-id 3f7or4t9so6894qi3ofgbgs79j --callback-port 33418

Poiché Claude Code gira sul tuo computer, dispone anche dello strumento request_upload, che carica un file dalla tua macchina direttamente nella pipeline di caricamento di DataCNVS. Le app web, desktop e mobile di Claude non possono inviare file in questo modo; carica invece in DataCNVS.

Impostazioni MCP generiche #

Per collegare qualsiasi altro client MCP, o per verificare la configurazione di un client, queste sono le impostazioni del server:

Impostazione	Valore
URL del server	`https://mcp.datacnvs.com/mcp`
Trasporto	Streamable HTTP
Autenticazione	OAuth 2.1, authorization code + PKCE (S256)
Scope	`https://mcp.datacnvs.com/mcp/canvas.readhttps://mcp.datacnvs.com/mcp/canvas.write`
Metadati della risorsa protetta	`https://mcp.datacnvs.com/.well-known/oauth-protected-resource`
Metadati del server di autorizzazione	`https://mcp.datacnvs.com/.well-known/oauth-authorization-server`
Limite di frequenza	60 chiamate agli strumenti per utente al minuto
Finestra di annullamento	7 giorni dopo una modifica

Il server non supporta la registrazione dinamica dei client, quindi un client richiede un client ID OAuth preregistrato. Claude si collega tramite la directory e Claude Code come descritto sopra. Per collegare qualcos'altro, scrivi a support@datacnvs.com indicando il nome del client e il suo URL di reindirizzamento OAuth.

Lo scope read copre la ricerca e la lettura di canvas, osservazioni, variabili, temi e caricamenti. Lo scope write è necessario per ogni modifica e azione. A un client che ha effettuato l'accesso solo con lo scope read vengono offerti soltanto gli strumenti di lettura.

Per provare il server a mano, MCP Inspector (npx @modelcontextprotocol/inspector@latest) funziona con lo stesso client ID di Claude Code: scegli Streamable HTTP, inserisci l'URL del server e il client ID, quindi accedi.

Come funzionano gli strumenti #

Alcune cose vale la pena sapere, qualunque client tu usi:

Prima le aree di lavoro. L'IA inizia elencando le tue aree di lavoro e i tuoi canvas, poi legge la struttura di un canvas prima di modificarlo. Puoi indicare un canvas per titolo o incollarne il link.
I link ai canvas funzionano ovunque. Qualsiasi strumento che richiede un canvas ne accetta l'URL di DataCNVS.
Le modifiche si applicano subito, a tuo nome. Compaiono in tempo reale a chiunque abbia il canvas aperto, come qualsiasi altra modifica.
Le modifiche si possono annullare. Ogni modifica a un canvas restituisce un ID di modifica, e l'IA può annullarla per 7 giorni. Puoi anche ripristinare una versione precedente dalla cronologia delle versioni del canvas in DataCNVS.
Alcune azioni non si possono annullare. Eliminare un canvas, un'osservazione o un tema, revocare una condivisione e i passaggi della pipeline di caricamento sono definitivi. I client contrassegnano questi strumenti come distruttivi e ti chiedono conferma prima.
Resti tu al controllo. Claude chiede la tua approvazione prima degli strumenti che modificano qualcosa, a meno che tu non li abbia consentiti (vedi i permessi degli strumenti consigliati); Claude Code segue le tue impostazioni dei permessi.
I risultati rimandano al canvas. I risultati che nominano un canvas ne includono il link, così puoi andarci direttamente.

Privacy: l'IA non vede mai i valori dei tuoi dati #

I dati scientifici sono spesso inediti, riservati o regolamentati, quindi DataCNVS è progettato perché un'IA possa aiutarti a costruire la figura senza mai ricevere i dati che contiene.

I client IA costruiscono il grafico. DataCNVS vi disegna i tuoi dati. I valori in sé non lasciano mai DataCNVS.

Cosa l'IA non può vedere #

I valori dei dati. I valori delle serie (ogni punto di ogni curva) e i valori scalari (singole misure, come la massa di un campione o il setpoint di un forno) non vengono mai inviati a un client IA. Lo strumento che legge un'osservazione non restituisce valori, e il risultato di ogni altro strumento viene privato dei valori prima di uscire da DataCNVS.
I file che hai caricato. Nessuno strumento restituisce il contenuto di un file che hai caricato.
Tutto ciò che non puoi aprire. L'IA lavora solo con ciò a cui il tuo account può accedere, nelle aree di lavoro in cui MCP è attivato.

Con cosa lavora l'IA #

La struttura del canvas: pannelli, assi e relativi intervalli, serie, legende, annotazioni, temi e stile.
Nomi e descrizioni: titoli di canvas e osservazioni, nomi delle variabili, unità, grandezze e le etichette di testo delle tue figure.
Riferimenti: ID di osservazioni e variabili, che l'IA restituisce a DataCNVS per indicare quali dati vanno dove.

Questo basta per costruire e ridisegnare una figura, ma significa che titoli, nomi ed etichette sono visibili all'IA. Se per te è importante, non inserirvi nulla di sensibile.

Come le figure mostrano comunque i tuoi dati #

Quando l'IA traccia una serie, passa a DataCNVS un riferimento all'osservazione e alla variabile, mai i numeri. DataCNVS carica poi i valori nel tuo browser, ne converte le unità e li disegna. Intervalli degli assi, tacche e fit sono tutti calcolati da DataCNVS.

Il testo che mostra un valore, come un'etichetta che riporta la massa di un campione, usa un token di etichetta: un segnaposto che nomina la variabile, che DataCNVS compila e converte nelle unità corrette quando disegna l'etichetta. L'IA scrive il segnaposto; non vede mai in cosa si trasforma.

Puoi comunque chiedere dati per valore, ad esempio «osservazioni in cui la temperatura di ricottura era superiore a 600 °C». DataCNVS esegue il confronto da sé e restituisce all'IA solo gli ID delle osservazioni corrispondenti.

Da sapere #

Il tuo fornitore di IA vede la conversazione. Ciò che scrivi, insieme ai nomi e alla struttura restituiti dagli strumenti, viene elaborato dal fornitore di IA che hai scelto, come Anthropic, in base al tuo accordo con lui.
Gli agenti locali possono leggere file locali. Claude Code gira sul tuo computer e può leggerne i file, indipendentemente da DataCNVS. Se carichi un file con request_upload, l'agente ha già ottenuto quel file dal tuo disco; DataCNVS continua comunque a non restituirne mai i valori.
I valori che scrivi tu sono tuoi da condividere. Se incolli dei numeri nella chat, l'IA li vede, come farebbe ovunque.

Per saperne di più, consulta la nostra informativa sulla privacy e la panoramica sulla sicurezza.

Esempi d'uso #

Parla con l'IA come faresti con un collega che conosce DataCNVS. Ogni esempio mostra un prompt, cosa succede e gli strumenti tipicamente coinvolti.

Trovare e descrivere un canvas #

Cosa c'è nel mio canvas «Prove di creep 2026»? Elenca ogni pannello e cosa traccia.

L'IA trova il canvas nelle tue aree di lavoro e ne descrive il layout: pannelli, assi, unità e le serie di ciascuno, per nome. Descrive la figura, non i numeri al suo interno.

Strumentilist_workspaceslist_canvasesread_canvas_model

Costruire una figura dalle tue osservazioni #

Trova le mie prove di trazione sul lotto di campioni B-17 e crea un nuovo canvas che traccia la tensione in funzione della deformazione, una linea per provino.

L'IA cerca tra le tue osservazioni, crea un canvas e traccia ciascuna come serie per riferimento. DataCNVS carica e disegna i dati.

Strumentisearch_observationscreate_canvasplot_series

Cambiare unità e titoli degli assi #

Su «Ciclo forno 14», mostra la temperatura in °C invece che in K e intitola l'asse y «Temperatura (°C)».

La conversione delle unità avviene in DataCNVS. L'IA sceglie solo l'unità di visualizzazione, quindi i valori convertiti non passano mai da lei.

Strumentiread_canvas_modelset_axis_display_unitset_axis_title

Annotare un grafico #

Aggiungi una linea di soglia tratteggiata alla tensione di snervamento nel pannello in alto e una legenda in alto a sinistra.

Annotazioni, linee di soglia, callout e legende sono tutti oggetti del grafico che l'IA può posizionare e stilizzare. I valori che le dai nel prompt, come una soglia, sono tuoi da condividere.

Strumentiread_canvas_modelinsert_threshold_lineinsert_legend

Impaginare una figura a più pannelli #

Trasformala in una figura due per due: copia il pannello in alto a sinistra negli altri tre.

L'IA lavora con la griglia del canvas: inserisce e duplica pannelli e imposta spaziature e margini.

Strumentiinsert_panelduplicate_panelconfigure_canvas_grid

Ridisegnare lo stile per una rivista #

Applica il nostro tema «Rivista a colonna singola» a ogni canvas con «Nature Paper» nel titolo.

L'IA elenca i temi della tua area di lavoro e ne applica uno a ogni canvas, così font, dimensioni e colori coincidono in tutto un articolo.

Strumentilist_canvas_themesapply_canvas_theme

Caricare un file (solo Claude Code) #

Carica ./data/run_42.csv su DataCNVS, associa le sue colonne alle nostre variabili abituali e avvisami quando è pronto per essere tracciato.

Claude Code carica il file dal tuo computer, attende l'analisi e invia le associazioni delle unità. DataCNVS si occupa di analisi e conversione; i valori analizzati non vengono mai restituiti all'IA.

Strumentirequest_uploadwait_for_uploadsubmit_unit_mappings

Annullare una modifica #

Annulla le ultime due modifiche che hai fatto a quel canvas.

Ogni modifica a un canvas ha un ID di modifica che l'IA può annullare, finché nulla ha cambiato gli stessi oggetti da allora. Per ripristini più ampi, recupera una versione precedente dalla cronologia delle versioni del canvas.

Strumentiundo_canvas_edit

Disattivare l'accesso #

Per te: rimuovi o scollega DataCNVS nel tuo client (Claude: Settings → Connectors; Claude Code: claude mcp remove datacnvs). Questo elimina i token del client.
Per un'intera area di lavoro: un amministratore dell'area di lavoro disattiva MCP / client IA esterni in Impostazioni → Area di lavoro → Generale → IA. Ha effetto dalla chiamata successiva a uno strumento, per ogni membro e ogni client.
Per i dati condivisi: l'interruttore appartiene all'area di lavoro proprietaria di un canvas o di un'osservazione, quindi disattivarlo copre anche quei dati ovunque siano stati condivisi.

Serve aiuto? #

Se un client non si collega, uno strumento rifiuta, o vuoi credenziali client per qualcosa che non è elencato qui, scrivi a support@datacnvs.com indicando il client che usi e cosa gli hai chiesto.

In questa pagina