Connecter un assistant distant avec Dokos Connect

Dokos Connect relie un assistant à votre site Dokos sans rien installer sur votre poste. Vous indiquez l'adresse de votre site, vous vous connectez avec votre compte Dokos, puis vous posez vos questions : « Quelles sont mes factures impayées ? », « Crée une tâche pour relancer ce fournisseur ».

L'assistant agit avec votre compte. Il lit et modifie uniquement ce que vos permissions autorisent.

Choisir son parcours

      
flowchart LR
    U(Vous) --> A[Claude ou client MCP configurable]
    U --> B[ChatGPT, plugin public]
    A -->|connexion directe| S[(Votre site Dokos)]
    B --> G[Passerelle api.dokos.cloud]
    G -->|relais avec votre autorisation| S

    

La connexion directe est le parcours à privilégier quand votre assistant la permet. La passerelle sert uniquement les assistants qui imposent une adresse unique pour tous leurs utilisateurs. Un échec de connexion directe ne bascule jamais vers la passerelle.

Prérequis

Ces réglages se font une fois par site. Ils demandent le rôle Gestionnaire d'IA.

1. L'application Dokos AI est installée sur le site.
2. Ouvrez les Paramètres de l'IA, onglet MCP, section Ouvrir ce site aux assistants externes.
3. Activez Activer le serveur MCP.
4. Activez Autoriser les modifications par MCP si les assistants peuvent créer ou modifier des documents. Sans ce réglage, ils peuvent seulement lire.
5. Enregistrez.
6. Contrôlez la liste Prérequis de connexion. Elle indique « Prêt : les assistants distants peuvent se connecter. » quand tout est en place.

La liste vérifie quatre points :

Les trois options de Paramètres OAuth sont actives par défaut. Si l'une d'elles manque, le bouton Activer les paramètres OAuth les active toutes. Ce bouton demande le rôle Responsable système.

La même section affiche l'adresse du serveur MCP du site, avec un bouton Copier, et le nombre d'utilisateurs qui peuvent lire ou modifier par MCP. Le lien Vérifier les accès ouvre l'onglet Accès.

Attribuez ensuite les rôles aux utilisateurs concernés :

Les règles d'accès par type de document de l'onglet Accès s'appliquent aussi aux assistants distants.

Pour la passerelle, le site doit aussi être accessible sur Internet en HTTPS, sur le port standard.

Se connecter depuis Claude

Ce parcours est direct : api.dokos.cloud n'intervient pas.

1. Ajoutez la place de marché https://gitlab.com/dokos/dokos-cli :
   • dans Claude Cowork ou l'application Claude de bureau, ouvrez Customize → Plugins → Add marketplace ;
   • dans Claude Code, lancez /plugin marketplace add https://gitlab.com/dokos/dokos-cli.
2. Installez le plugin dokos-connect.
3. Saisissez l'adresse de votre site telle qu'elle apparaît dans votre navigateur, sans https:// et sans rien après le nom. Exemple : acme.dokos.cloud.
4. Lancez la connexion : bouton Connect dans l'application Claude, ou commande /mcp puis dokos dans Claude Code.
5. Une page de votre site s'ouvre. Connectez-vous avec votre compte Dokos, puis cliquez sur Autoriser.
6. De retour dans Claude, demandez : « Sur quel site Dokos suis-je connecté ? ». Claude répond avec le site et votre compte.

Si les outils Dokos n'apparaissent pas, lancez /dokos-connect:connect. Cette commande contrôle le site sans s'y connecter. Elle nomme le réglage manquant : adresse erronée, Dokos AI absent, serveur MCP désactivé ou option OAuth désactivée.

Pour changer de site, lancez /plugin configure dokos-connect et saisissez la nouvelle adresse. Lancez /reload-plugins ou redémarrez Claude, relancez la connexion, puis demandez de nouveau à Claude sur quel site il est connecté.

Se connecter depuis un client MCP configurable

Indiquez à votre client l'adresse du serveur MCP de votre site. Copiez-la depuis l'onglet MCP des Paramètres de l'IA, ou composez-la :

https://<votre-site>/api/method/dokos_ai.mcp.endpoint

Le client découvre l'authentification du site, ouvre la page de connexion de votre site, puis reçoit son autorisation. Ce parcours est direct lui aussi.

Se connecter depuis ChatGPT

Deux parcours existent. Le serveur MCP personnalisé est disponible dès maintenant. Le plugin public le remplacera pour la plupart des utilisateurs à sa publication.

Avec un serveur MCP personnalisé

Ce parcours est direct : api.dokos.cloud n'intervient pas. Il fonctionne dans ChatGPT sur le web.

1. Dans ChatGPT, ouvrez la page Plugins : https://chatgpt.com/plugins.
2. Cliquez sur Ajouter, puis sur Ajouter un serveur MCP personnalisé.
3. Saisissez un Nom, par exemple Dokos. La description est facultative.
4. Sous Connexion, gardez URL du serveur et collez l'adresse du serveur MCP de votre site :

   https://<votre-site>/api/method/dokos_ai.mcp.endpoint
   

5. Dans Authentification, choisissez OAuth.
6. Cochez Je comprends et souhaite continuer, puis cliquez sur Créer en tant que plugin.
7. Une page de votre site s'ouvre. Connectez-vous avec votre compte Dokos, puis cliquez sur Autoriser.
8. Installez le plugin créé. Dans une nouvelle conversation, saisissez @, puis sélectionnez le plugin.
9. Demandez : « Sur quel site Dokos suis-je connecté ? ».

Les règles de votre compte ou de votre espace de travail ChatGPT s'appliquent : un administrateur peut interdire les serveurs MCP personnalisés.

Après une mise à jour de Dokos AI, ouvrez le plugin dans ChatGPT et actualisez la connexion. ChatGPT relit alors la liste des outils.

Avec le plugin public Dokos Connect

Le plugin public utilise la passerelle. Elle vous demande votre site, puis vous envoie vous connecter sur votre site.

1. Dans ChatGPT, installez le plugin Dokos Connect et lancez la connexion.
2. Une page de api.dokos.cloud s'ouvre. Elle affiche le nom de l'assistant et les accès demandés. Le plugin public demande la lecture et la modification.
3. Saisissez l'adresse de votre site, par exemple https://acme.dokos.cloud, puis cliquez sur Allow and continue to my site.
4. Votre site s'ouvre. Connectez-vous avec votre compte Dokos et autorisez Dokos Connect.
5. De retour dans ChatGPT, demandez : « Sur quel site Dokos suis-je connecté ? ».

      
sequenceDiagram
    actor U as Vous
    participant C as ChatGPT
    participant G as Passerelle api.dokos.cloud
    participant S as Votre site Dokos
    C->>G: Demande de connexion
    G-->>U: Quel est votre site ?
    U->>G: Adresse du site, accord
    G-->>U: Redirection vers votre site
    U->>S: Connexion et autorisation
    S-->>G: Autorisation pour votre compte
    G-->>C: Connexion établie
    C->>G: Question ou action
    G->>S: Même demande, avec votre autorisation
    S-->>G: Résultat, selon vos permissions
    G-->>C: Résultat

    

Le nom affiché est celui que l'assistant déclare. Continuez uniquement si vous avez lancé cette connexion vous-même.

Si l'adresse saisie est refusée, la page se réaffiche avec la raison. Corrigez l'adresse et validez de nouveau. La page reste valable 10 minutes. Cancel vous ramène dans ChatGPT sans rien connecter.

Une connexion est liée à un site et un compte. Pour travailler sur un autre site, supprimez la connexion dans ChatGPT et recommencez avec la nouvelle adresse.

Ce que l'assistant peut faire

Votre assistant affiche le titre de l'outil à la place de son nom, par exemple dans une demande de confirmation. Les titres sont en anglais.

Chaque outil indique aussi à l'assistant ce qu'il fait :

• Les outils de lecture ne modifient rien.
• Les outils d'écriture peuvent modifier ou supprimer des données, sauf doc_create, qui ajoute seulement un document.
• Aucun outil n'agit en dehors de votre site.

L'assistant utilise ces indications pour décider s'il vous demande une confirmation avant un appel. Chaque assistant applique ses propres règles.

L'assistant ne peut ni exécuter de code sur le site, ni appeler une méthode arbitraire. Une liste retourne au plus 500 documents par appel. Le site accepte 300 appels par minute.

L'écriture exige trois conditions réunies : le réglage Autoriser les modifications par MCP sur le site, le rôle Rédacteur IA pour l'utilisateur, et, avec la passerelle, un assistant connecté avec l'accès en modification.

Chaque appel passe par les mêmes contrôles que l'assistant intégré :

• Les permissions de votre compte et les règles d'accès de l'onglet Accès s'appliquent.
• L'appel est inscrit dans le Journal d'audit IA, avec l'outil, l'assistant et le résultat. Un appel refusé y figure aussi.
• Un appel en erreur est annulé : il ne laisse aucune modification partielle.

Exemples

Suivre les factures impayées

« Liste mes factures de vente impayées, de la plus ancienne à la plus récente. »

L'assistant interroge les factures de vente validées dont le montant dû est positif. Il présente le client, l'échéance et le montant. Les factures que votre compte ne peut pas ouvrir n'apparaissent pas.

Créer une tâche

« Crée une tâche "Relancer le fournisseur Acme" pour vendredi. »

L'assistant crée un document ToDo. Avec le plugin Claude, l'assistant décrit la modification et attend votre accord. Avec le plugin ChatGPT, une demande explicite vaut accord : l'assistant vous interroge seulement si la demande est ambiguë. Si l'écriture n'est pas autorisée, l'assistant vous indique que la connexion est en lecture seule.

Explorer un site de production sans risque

Laissez Autoriser les modifications par MCP désactivé, ou donnez seulement le rôle Lecteur d'IA. L'assistant peut analyser les données et exécuter les rapports. Aucun outil d'écriture ne lui est proposé.

Appliquer une procédure de l'entreprise

« Montre-moi le guide du processus de vente, puis prépare un devis pour le client Dupont. »

L'assistant charge le guide que votre site partage, puis suit ses étapes. Un guide est partagé quand la case Partager avec des agents externes est cochée dans l'éditeur de compétences — voir L'assistant.

Après une réponse incertaine

Une écriture a expiré, ou l'assistant signale une erreur réseau. La passerelle abandonne un appel quand le site ne répond pas en 20 secondes. Demandez-lui de vérifier le document avant toute nouvelle tentative : la modification a pu être enregistrée. Les assistants ne relancent pas d'eux-mêmes une création, une validation, une annulation ou une suppression.

Se déconnecter et révoquer un accès

Avec la passerelle, une connexion expire après 30 jours. L'assistant demande alors une nouvelle autorisation. Une connexion révoquée ne se rétablit pas : il faut en ouvrir une nouvelle.

Données traitées par la passerelle

Ce paragraphe concerne uniquement le plugin public pour ChatGPT. En connexion directe, aucune donnée ne passe par api.dokos.cloud.

• Vos demandes et leurs résultats transitent par la passerelle. Elle n'enregistre ni les arguments, ni les résultats.
• Elle ne conserve ni votre compte, ni l'autorisation délivrée par votre site. Cette autorisation voyage dans le jeton que détient votre assistant, sous une forme chiffrée que seule la passerelle peut lire.
• Elle conserve l'inscription de Dokos Connect sur votre site, sous forme chiffrée, jusqu'à 35 jours après le dernier usage. Cette inscription est commune à tous les utilisateurs du site.
• Elle tient des compteurs anonymes : le nombre d'actions par jour et par type. Ils ne nomment ni site, ni utilisateur.

La passerelle ne peut donc pas lister les connexions, ni en révoquer une à votre place. Vous gardez la main : supprimez la connexion dans votre assistant, ou le jeton de Dokos Connect sur votre site.

L'autorisation que votre site délivre à la passerelle porte sur votre compte entier, pas seulement sur les outils de cette page. La passerelle l'utilise uniquement pour ces outils. La restriction à la lecture seule est appliquée par la passerelle et par les réglages de votre site.

Dépannage

Sur le site

Sur la page de la passerelle

Pendant l'utilisation de la passerelle

Voir aussi

• Piloter Dokos depuis un assistant externe — le parcours avec Dokos CLI et une clé d'API
• Activer et paramétrer l'IA
• Connecter des outils externes à l'assistant — le branchement inverse