# 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. 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: ```text 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 ::: tabs === Claude Code 1. Nel terminale, esegui: ```sh 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. > [!NOTE] > 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](/docs/teams/audit-log) 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: ```sh claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer " ``` 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](/docs/dvina-mcp/api-access). ## Argomenti correlati - [App personalizzate e server MCP](/docs/connectors/custom-apps) - [Accesso API](/docs/dvina-mcp/api-access) - [Usa il comando dvina](/docs/dvina-mcp/cli) - [Panoramica dei team](/docs/teams/overview)