Documentation › Connecter un assistant IA
Connecter un assistant IA (MCP)
Un assistant IA comme Claude, GitHub Copilot ou ChatGPT peut travailler dans SerenForce à votre place : retrouver un process ou un artefact, en créer un, déposer un modèle de document, modifier le dessin puis le publier. Il passe par le connecteur MCP de votre organisation et n’a que vos droits.
À quoi ça sert ?
- Retrouver : « Quels process parlent d’intégration ? », « Quels modèles a l’artefact Contrat de travail ? ».
- Créer : un process vide (avec son seul bloc de départ) ou un artefact avec les modèles que vous lui donnez (Word, Excel, PowerPoint, PDF, HTML ou texte, avec des placeholders {{Nom}}).
- Modifier : l’assistant lit le dessin d’un process ou d’un artefact, le change, l’enregistre comme brouillon, puis le publie si vous le lui demandez. Il peut aussi récupérer un modèle, le corriger et le déposer de nouveau.
- Mise en page : chaque bloc dessiné par l’assistant affiche son nom, les personnes qui le font et son résumé, comme dans l’éditeur. Un dessin nouveau est rangé tout seul : les étapes les unes sous les autres, les phases côte à côte, sans lien qui passe au-dessus d’une étape. Demandez « remets le dessin en page » pour ranger de nouveau un process déjà dessiné.
- Tout ce qu’il crée vous appartient et apparaît dans les onglets Processes et Artifacts, comme si vous l’aviez fait vous-même. Ouvrez-le dans l’éditeur pour vérifier avant de publier.
Connecter l’assistant
- Demandez l’adresse à votre administrateur
Elle a la forme https://…/api/<identifiant de votre organisation>/v1/mcp : la même adresse que l’application, suivie de /v1/mcp.
- Ajoutez un serveur MCP dans votre assistant
Dans les réglages de l’assistant (connecteurs, serveurs MCP), ajoutez un serveur de type HTTP avec cette adresse.
- Connectez-vous
La première fois, l’assistant ouvre votre navigateur sur la page de connexion Microsoft (le même compte que pour l’application). Connectez-vous et acceptez : l’assistant vous garde ensuite connecté et renouvelle votre connexion tout seul. S’il demande un client ID, c’est l’identifiant d’application (client) de votre organisation : votre administrateur vous le donne.
- Essayez
Demandez : « Liste mes process SerenForce ». L’assistant affiche ceux que vous voyez dans l’onglet Processes.
Que demander ?
- « Crée un artefact Contrat de travail avec ce fichier Word. »
- « Dans le process Intégration, ajoute une description qui résume les étapes, enregistre le brouillon. »
- « Télécharge le modèle de l’artefact Offre, remplace “client” par “bénéficiaire” et dépose la nouvelle version. »
À savoir
- L’assistant ne peut rien de plus que vous : il ne voit que les process et artefacts que vous voyez et ne modifie que ceux dont vous êtes propriétaire ou contributeur. Quand il n’a pas le droit, SerenForce lui explique pourquoi, dans votre langue.
- Un brouillon enregistré par l’assistant remplace le brouillon en cours : vérifiez-le dans l’éditeur avant de le publier.
- Les formats de modèles acceptés sont les mêmes que dans l’application : .docx, .xlsx, .pptx, .odt, .ods, .odp, .pdf, .html, .htm et .txt.
- L’assistant ne lance pas d’instance de process et ne supprime rien.
- Pour l’administrateur : l’application n’accepte un assistant installé sur l’ordinateur qu’aux adresses saisies dans AI assistant addresses (une par ligne, par exemple http://localhost/callback pour Claude Code), à l’installation de la plateforme et à l’inscription de chaque organisation. Laissé vide, ce champ n’autorise aucun assistant : c’est le réglage le plus sûr pour une organisation qui n’en utilise pas.
- Une organisation inscrite avant, ou dont la page de connexion Microsoft refuse l’adresse de retour : dans l’administration, ouvrez l’organisation, onglet Authentication, section AI assistants, puis Add AI assistant addresses. SerenForce ajoute les adresses à l’application Microsoft Entra ID (Add to the application), ou vous téléchargez le script Azure CLI qui le fait (Download the script). Les adresses que l’application a déjà sont conservées.
Permissions
- Se connecter : au moins une de View processes, View artifacts, Create processes, Edit processes, Create artifacts, Edit artifacts ou Start process instances.
- Ensuite, chaque demande demande la même permission que dans l’application : View processes / View artifacts pour lire, Create processes / Create artifacts pour créer, Edit processes / Edit artifacts pour enregistrer et publier ; déposer un modèle demande Create artifacts ou Edit artifacts. Utilisateurs et rôles explique comment les obtenir.