Dvina MCP

Utiliser Dvina depuis d’autres apps avec MCP

Connectez un client MCP comme Claude Code, ChatGPT ou Cursor à Dvina, connectez-vous à votre compte et autorisez-le à consulter votre Dvina et à y ajouter du contenu.

Voir en Markdown

Dvina dispose de son propre serveur MCP. Connectez un client MCP, comme Claude Code, ChatGPT ou Cursor, pour permettre à cette app d’effectuer des recherches dans votre Dvina, de consulter vos documents et votre mémoire, et d’ajouter des notes, des tâches et des rappels en votre nom.

Avant de commencer

Vous avez besoin de l’adresse du serveur :

https://api.dvina.ai/mcp

Si votre entreprise héberge Dvina sur ses propres serveurs, utilisez l’adresse de son API Dvina en ajoutant /mcp à la fin. Demandez cette adresse à votre administrateur.

Le serveur utilise Streamable HTTP. Si le client vous demande de choisir un transport, sélectionnez HTTP.

Connecter un client

Claude Code

  1. Dans votre terminal, exécutez :

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

  2. Lancez Claude Code, exécutez /mcp, choisissez dvina, puis connectez-vous à Dvina.

ChatGPT

  1. Ouvrez la section de ChatGPT qui permet d’ajouter un serveur MCP.
  2. Saisissez https://api.dvina.ai/mcp comme adresse du serveur et choisissez OAuth si une méthode de connexion vous est demandée.
  3. Connectez-vous à Dvina lorsque ChatGPT vous le demande.

Cursor

  1. Ouvrez la section de Cursor qui permet d’ajouter un serveur MCP.
  2. Ajoutez un serveur nommé dvina avec l’adresse https://api.dvina.ai/mcp.
  3. Connectez-vous à Dvina lorsque Cursor vous le demande.

Vous n’avez pas besoin d’un identifiant client ni d’un secret client. Le client s’enregistre auprès de Dvina lors de sa première connexion.

Se connecter

Le serveur MCP de Dvina vous connecte via OAuth, dans votre navigateur :

  1. Connectez-vous à Dvina comme vous le faites habituellement.
  2. Si vous appartenez à plusieurs espaces de travail, choisissez-en un sous Sélectionner un espace de travail, puis choisissez Continuer. Le client fonctionne uniquement dans cet espace de travail.
  3. Sous Autoriser l’accès, vérifiez le nom de l’app, puis choisissez Autoriser l’accès. Choisissez Refuser si vous ne la reconnaissez pas.

Le client reste connecté : vous n’avez donc pas à vous connecter à chaque fois.

Ce qu’un client peut faire

Le client a accès aux outils de Dvina et les utilise lorsque votre demande le nécessite :

Domaine Ce que le client peut faire
Recherche Rechercher dans vos conversations, vos documents, votre mémoire et votre monde en même temps.
Mémoire Lister et lire vos fichiers de mémoire, en ajouter un ou en modifier un.
Monde Lister vos sujets, afficher ce que Dvina sait sur un sujet ou toute autre chose, et lister votre fil.
Documents Lister, lire et rechercher dans votre bibliothèque, créer des notes et des dossiers, importer des fichiers, et remplacer, déplacer ou renommer un document, ou le mettre à la corbeille.
Canevas Lister et lire vos canevas, créer un canevas ou réécrire une page.
Tâches et objectifs Lister vos tâches et consulter ce qu'elles ont fait, lancer une tâche ou une tâche qui contribue à un objectif, donner du travail supplémentaire à une tâche ou en arrêter une.
Messages programmés Les lister, programmer un message ou un rappel, ponctuel ou récurrent, ou en annuler un.
Agents et compétences Lister et consulter vos agents et compétences, créer un agent, ajouter une compétence ou modifier l'un ou l'autre.
Projets Lister vos projets et afficher le dossier et les tâches récentes d'un projet.
Partage Voir qui a accès à un élément et ce que d'autres ont partagé avec vous, ou accorder ou retirer l'accès à quelqu'un.
Réglages Afficher vos préférences, ou activer ou désactiver la mémoire.

Le client ne peut pas supprimer définitivement des éléments, ouvrir des liens publics, connecter ou déconnecter des applications, ni modifier les réglages d'administration ou de facturation.

Approuver les modifications

Les actions du client suivent les mêmes règles que partout dans Dvina :

  • La lecture s'effectue sans vous demander de confirmation.
  • L'ajout d'un nouvel élément, comme une note, un fichier de mémoire ou une tâche, s'effectue sans vous demander de confirmation. Il ne modifie jamais ce qui existe déjà.
  • La modification ou le retrait d'un élément, comme la mise à la corbeille d'un document, la réécriture d'une page de canevas, l'arrêt d'une tâche ou le partage d'un élément, nécessite d'abord votre accord. Le client affiche le résumé de la modification fourni par Dvina, et vous l'approuvez ou la refusez. Si vous la refusez, rien ne change.

Remarque

Si un client ne peut pas vous demander de confirmation, Dvina n'effectue pas la modification demandée par ce client. Faites plutôt la modification dans l'application Dvina, ou utilisez un client capable de vous demander une confirmation.

Vos droits d'accès et les règles de votre entreprise

Le client agit en votre nom, avec les mêmes possibilités de consultation et d'action que vous dans Dvina :

  • Il fonctionne uniquement tant que vous êtes membre de l'espace de travail, et dans les limites autorisées par votre rôle.
  • Si votre administrateur désactive une fonctionnalité, comme l'importation de fichiers, le client ne peut pas non plus l'utiliser.
  • Les ajouts et les modifications du client sont soumis aux règles de protection des données de votre entreprise, comme dans l'application.
  • Ses ajouts et modifications sont enregistrés dans votre journal d'audit comme des actions de l'assistant effectuées pour vous, avec le nom du client à leur origine.
  • Ses actions sont comptabilisées dans votre utilisation, dans les limites habituelles.

Se connecter avec une clé API plutôt qu'avec OAuth

Avec l'offre Enterprise, un client peut se connecter à l'aide d'un jeton d'accès personnel au lieu de passer par une connexion avec authentification. Utilisez cette méthode pour un client qui ne peut pas se connecter avec OAuth, ou pour un script.

  1. Ouvrez les réglages et choisissez Accès API.
  2. Sous Jetons d'accès personnels, choisissez Créer un jeton.
  3. Saisissez un Nom, choisissez l'Accès et la date d'Expiration, puis choisissez Créer un jeton.
  4. Sous Copier votre jeton, copiez le jeton. C'est la seule fois où il est affiché.

Choisissez les droits d'accès dont le client a besoin :

  • Lecture seule : le client ne voit que les outils de lecture. Il peut rechercher et lire le contenu de votre Dvina, mais ne peut rien ajouter ni modifier.
  • Lecture et écriture : le client voit tous les outils, et les modifications nécessitent toujours votre approbation, comme avec OAuth.

Envoyez le jeton dans l'en-tête Authorization, après Bearer. Dans Claude Code, par exemple :

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

Dans un autre client, ajoutez le même en-tête à l'endroit où vous pouvez définir les en-têtes d'un serveur MCP.

Le jeton agit en votre nom, dans l'espace de travail où vous l'avez créé, avec votre rôle actuel dans cet espace. Pour le remplacer, ouvrez-le sous Jetons d'accès personnels et choisissez Renouveler… : un nouveau jeton le remplace, et l'ancien cesse immédiatement de fonctionner. Pour le désactiver, choisissez Révoquer… : tout ce qui l'utilise cesse immédiatement de fonctionner.

Pour en savoir plus sur les jetons, consultez Accès API.