Dvina MCP

Usa Dvina da altre app con MCP

Collega un client MCP come Claude Code, ChatGPT o Cursor a Dvina, accedi e consenti al client di leggere e aggiungere contenuti al tuo Dvina, con la tua approvazione.

Vedi in Markdown

Dvina ha un proprio server MCP. Collega un client MCP, come Claude Code, ChatGPT o Cursor, e l'app potrà cercare nel tuo Dvina, leggere i tuoi documenti e la tua memoria e aggiungere note, attività e promemoria per tuo conto.

Prima di iniziare

Ti serve l'indirizzo del server:

https://api.dvina.ai/mcp

Se la tua azienda ospita Dvina sui propri server, usa l'indirizzo dell'API Dvina della tua azienda, aggiungendo /mcp alla fine. Chiedilo al tuo amministratore.

Il server usa Streamable HTTP. Se il client ti chiede di scegliere un protocollo di trasporto, scegli HTTP.

Collega un client

Claude Code

  1. Nel terminale, esegui:

    claude mcp add --transport http dvina https://api.dvina.ai/mcp

  2. Avvia Claude Code, esegui /mcp, scegli dvina e accedi a Dvina.

ChatGPT

  1. Apri la sezione di ChatGPT che ti consente di aggiungere un server MCP.
  2. Inserisci https://api.dvina.ai/mcp come indirizzo del server e scegli OAuth se ti viene chiesto come accedere.
  3. Accedi a Dvina quando ChatGPT te lo chiede.

Cursor

  1. Apri la sezione di Cursor che ti consente di aggiungere un server MCP.
  2. Aggiungi un server con il nome dvina e l'indirizzo https://api.dvina.ai/mcp.
  3. Accedi a Dvina quando Cursor te lo chiede.

Non ti servono un ID client o un segreto client. Il client si registra automaticamente con Dvina alla prima connessione.

Accedi

Il server MCP di Dvina ti fa accedere tramite OAuth nel browser:

  1. Accedi a Dvina come fai di solito.
  2. Se fai parte di più spazi di lavoro, scegline uno in Seleziona spazio di lavoro, poi scegli Continua. Il client opera solo in quello spazio di lavoro.
  3. In Autorizza accesso, controlla il nome dell'app, poi scegli Consenti accesso. Scegli Nega se non la riconosci.

Il client resta connesso, quindi non devi accedere ogni volta.

Cosa può fare un client

Il client vede gli strumenti di Dvina e li usa quando la tua richiesta lo richiede:

Area Cosa può fare il client
Ricerca Cercare contemporaneamente nelle tue chat, nei documenti, nella memoria e nel mondo.
Memoria Elencare e leggere i tuoi file di memoria, aggiungerne uno nuovo o modificarne uno.
Mondo Elencare i tuoi argomenti, mostrare ciò che Dvina sa su un argomento o su qualsiasi altra cosa ed elencare il tuo Feed.
Documenti Elencare, leggere e cercare nella tua Libreria, creare note e cartelle, caricare file e sostituire, spostare o rinominare un documento, oppure spostarlo nel cestino.
Canvas Elencare e leggere i tuoi canvas, creare un canvas o riscrivere una pagina.
Attività e obiettivi Elencare le tue attività e leggere ciò che hanno fatto, avviare un'attività o un'attività che contribuisce a un obiettivo, assegnare altro lavoro a un'attività o interromperla.
Messaggi programmati Elencarli, programmare un messaggio o un promemoria, una sola volta o con ricorrenza, oppure annullarlo.
Agenti e competenze Elencare e leggere i tuoi agenti e le tue competenze, creare un agente, aggiungere una competenza o modificare gli uni o le altre.
Progetti Elencare i tuoi progetti e mostrare la cartella e le attività recenti di un progetto.
Condivisione Vedere chi ha accesso a un elemento e cosa altri hanno condiviso con te, oppure concedere o revocare l'accesso a qualcuno.
Impostazioni Mostrare le tue preferenze o attivare o disattivare la memoria.

Il client non può eliminare nulla definitivamente, aprire link pubblici, collegare o scollegare app, né modificare le impostazioni di amministrazione o fatturazione.

Approva le modifiche

Le operazioni del client seguono le stesse regole valide in tutto Dvina:

  • La lettura avviene senza chiederti conferma.
  • L'aggiunta di qualcosa di nuovo, come una nota, un file di memoria o un'attività, avviene senza chiederti conferma. Non modifica mai ciò che è già presente.
  • La modifica o la rimozione di qualcosa, come spostare un documento nel cestino, riscrivere una pagina di un canvas, interrompere un'attività o condividere un elemento, richiede prima la tua conferma. Il client mostra il riepilogo della modifica fornito da Dvina e tu puoi approvarla o rifiutarla. Se la rifiuti, non cambia nulla.

Nota

Se un client non può chiederti conferma, Dvina non esegue la modifica richiesta da quel client. Esegui la modifica nell'app Dvina oppure usa un client che possa chiederti conferma.

Il tuo accesso e le regole della tua azienda

Il client agisce per tuo conto, nei limiti di ciò che puoi vedere e fare in Dvina:

  • Funziona solo finché fai parte dello spazio di lavoro e solo nei limiti consentiti dal tuo ruolo.
  • Se il tuo amministratore disattiva una funzionalità, come il caricamento dei file, nemmeno il client può usarla.
  • Ciò che il client aggiunge o modifica è soggetto alle regole di protezione dei dati della tua azienda, come nell'app.
  • Ciò che aggiunge o modifica viene registrato nel tuo registro di controllo come operazione dell'assistente per tuo conto, con l'indicazione del client da cui proviene.
  • Le sue operazioni vengono conteggiate nel tuo utilizzo, entro i tuoi limiti abituali.

Collegati con una chiave API invece di OAuth

Con il piano Enterprise, un client può collegarsi con un token di accesso personale invece di effettuare l'accesso. Usa questa opzione per un client che non può accedere con OAuth o per uno script.

  1. Apri Impostazioni e scegli Accesso API.
  2. In Token di accesso personali, scegli Crea token.
  3. Inserisci un Nome, scegli l'Accesso e la Scadenza, poi scegli Crea token.
  4. In Copia il tuo token, copia il token. Viene mostrato solo in questo momento.

Scegli l'accesso necessario al client:

  • Sola lettura: il client vede solo gli strumenti di lettura. Può cercare e leggere i tuoi contenuti in Dvina, ma non può aggiungere o modificare nulla.
  • Lettura e scrittura: il client vede tutti gli strumenti e le modifiche richiedono comunque la tua approvazione, come con OAuth.

Invia il token nell'header Authorization, dopo Bearer. In Claude Code, ad esempio:

claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"

In un altro client, aggiungi lo stesso header nella sezione che consente di impostare gli header per un server MCP.

Il token agisce per tuo conto, nello spazio di lavoro in cui l'hai creato, con il ruolo che hai attualmente in quello spazio. Per sostituirlo, aprilo in Token di accesso personali e scegli Ruota…: un nuovo token lo sostituisce e quello precedente smette subito di funzionare. Per disattivarlo, scegli Revoca…: tutto ciò che lo usa smette subito di funzionare.

Per saperne di più sui token, consulta Accesso API.