Connecter un assistant IA à SpeakDo
Avec SpeakDo, vous pouvez travailler dans votre ERP de deux façons :
- depuis l'application mobile, pour le terrain ;
- depuis un assistant IA compatible MCP, pour utiliser les actions autorisées par votre compte.
MCP (Model Context Protocol) est le protocole de connexion entre l'assistant et SpeakDo. Ce n'est pas un produit distinct : les deux interfaces utilisent les mêmes droits ERP, les mêmes actions contrôlées et les mêmes règles de confirmation.
ERP validé avec les assistants IA : Dolibarr. L'accès MCP n'est pas encore annoncé comme validé avec ERPNext.
Ce que votre assistant peut faire#
Après connexion, l'assistant découvre automatiquement les actions qui correspondent à votre utilisateur : le même catalogue que l'application mobile, filtré par votre profil métier, la politique de votre compte, les modules de votre ERP et vos droits. Il peut par exemple rechercher un client, consulter un devis ou préparer la création d'une intervention.
Le catalogue n'est pas identique pour tous les utilisateurs. SpeakDo ne donne pas de droit supplémentaire : une action que votre compte ne peut pas réaliser dans Dolibarr n'est pas proposée à l'assistant.
Pour le détail, voir Actions et sécurité MCP.
Connecter Claude#
Le connecteur Claude est actuellement validé avec SpeakDo en conditions réelles.
Avant de commencer#
- vous avez accès à votre fiche utilisateur dans Dolibarr ;
- l'administrateur a activé SpeakDo et l'accès MCP pour votre utilisateur ;
- vous utilisez Claude avec la possibilité d'ajouter un connecteur MCP personnalisé.
Créer l'accès dans Dolibarr#
- Dans Dolibarr, ouvrez votre fiche utilisateur puis l'onglet SpeakDo.
- Dans la section Accès MCP, choisissez Claude.
- Créez un accès OAuth.
- Conservez le code de pairage affiché par SpeakDo. Il est nécessaire pour l'autorisation et n'est affiché qu'une seule fois.
Si la section Accès MCP n'est pas disponible, demandez à votre administrateur SpeakDo de l'activer pour votre utilisateur.
Ajouter le connecteur dans Claude#
-
Dans Claude, ajoutez un connecteur MCP personnalisé.
-
Renseignez l'URL MCP :
https://api.speakdo.fr/mcp -
Renseignez l'OAuth Client ID :
claude -
Laissez l'OAuth Client Secret vide.
-
Claude ouvre la page d'autorisation SpeakDo.
-
Saisissez le code de pairage obtenu dans Dolibarr, puis autorisez la connexion.
Claude découvre ensuite automatiquement les actions auxquelles votre utilisateur a réellement accès.
Les actions sensibles demandent confirmation#
Une action d'écriture suit toujours ce parcours :
Votre demande
↓
SpeakDo prépare l'action
↓
Claude présente le récapitulatif
↓
Vous confirmez
↓
SpeakDo revérifie les autorisations
↓
Dolibarr exécute l'action
La préparation seule ne crée rien dans l'ERP.
Exemple#
Vous : « Crée une intervention pour Acme demain à 15 h, objet Reprise de parc. »
Assistant : « Je vais créer une intervention :
- Tiers : Acme
- Date : demain, 15 h
- Objet : Reprise de parc
Confirmer ? »
Vous : « Oui. »
Seulement après cette confirmation, l'intervention est créée dans Dolibarr.
Révoquer un accès#
Dans Dolibarr, ouvrez la fiche utilisateur concernée, puis la section Accès MCP de l'onglet SpeakDo. Révoquez l'accès concerné. L'assistant ne pourra plus l'utiliser.
Intégrations techniques#
SpeakDo peut aussi fournir un jeton dédié pour certaines intégrations service-à-service. Ce jeton est affiché une seule fois et peut être révoqué. Il ne correspond pas à une clé API Dolibarr.
Cette page décrit le parcours OAuth Claude. Ne partagez jamais un jeton technique avec une personne ou un assistant non autorisé.
Compatibilité#
Claude est le premier client MCP validé avec SpeakDo. D'autres clients peuvent demander des réglages d'authentification ou de fonctionnalités spécifiques ; ils ne sont pas annoncés comme validés tant qu'ils n'ont pas été testés.