MCP

À propos

Le Model Context Protocol (MCP) est une norme ouverte qui permet aux modèles d’IA et aux applications externes d’accéder en toute sécurité à des données contextuelles et en temps réel provenant de systèmes connectés. Dans le cadre d’Elium, MCP établit un pont fluide entre votre base de connaissances et des outils d’IA tels que ChatGPT ou d’autres assistants compatibles.

Grâce à MCP, un assistant d’IA peut interroger le contenu de votre instance Elium afin, par exemple, de répondre à des questions d’utilisateurs, de résumer des documents ou de fournir une assistance contextuelle sans avoir à copier ou exporter manuellement les données. L’accès est géré via une authentification OAuth, garantissant que seules les personnes et applications autorisées peuvent récupérer les informations, conformément à leurs droits Elium.

Chaque instance Elium expose son point d’accès MCP à l’adresse suivante : https://nom-de-votre-plateforme.elium.com/services/mcp

Outils disponibles

Une fois la connexion établie, le serveur MCP d’Elium propose des outils pour rechercher, lire, créer et modifier des articles.

Chaque outil s’exécute avec les droits de l’utilisateur authentifié : un assistant ne peut donc accéder qu’au contenu que cet utilisateur est déjà autorisé à voir dans Elium.

findRelevantArticles

Effectue une recherche sémantique (basée sur le sens) dans toute la base de connaissances à partir d’une question en langage naturel et renvoie les articles les plus pertinents, classés par pertinence. Cet outil n’accepte ni filtre ni restriction de périmètre. C’est l’outil utilisé par défaut par un assistant pour répondre à une question.

Chaque résultat comprend le titre de l’article, un lien pour l’ouvrir et un extrait du contenu correspondant. Les extraits peuvent aussi provenir de documents joints, lorsque ceux-ci sont les plus pertinents.

findSpecificArticles

Exécute une recherche plus ciblée, lorsqu’un assistant a besoin de filtrer plutôt que de classer par sens. Elle prend en charge :

• la recherche par mots-clés (un résultat doit contenir tous les termes fournis)

• le filtrage par modèle, par espaces précis et par plage de dates

• le choix de l’ordre de tri

• la limitation du nombre de résultats (10 par défaut, 50 au maximum)

Utile pour des demandes telles que "les cinq articles les plus récents créés à partir du modèle Politique dans l’espace RH".

readArticle

Récupère le contenu d’un article à partir de son identifiant, au format Markdown, ainsi que ses principales métadonnées : propriétaire, espace, modèle, tags, attributs personnalisés éventuels (libellé et valeur), date de revue ou d’expiration, statut d’approbation, date de dernière version et indication si l’article est archivé.

Un assistant appelle généralement cet outil après une recherche, lorsqu’il a besoin de plus de contexte que ce que fournit un extrait. Il utilise les métadonnées pour évaluer l’actualité et la fiabilité du contenu.

Lorsqu’ils sont renseignés, le propriétaire, l’espace et le modèle sont chacun désignés par un identifiant et un nom. Les informations de vérification aident l’assistant à préciser le statut de ses sources :

Le résultat précise aussi la langue, les traductions disponibles et la version lue. L’assistant peut demander le dernier brouillon avec draft: true, si vous avez le droit d’y accéder.

createArticle

Demandez à votre assistant connecté d’enregistrer du contenu dans Elium, par exemple : "Créez un brouillon intitulé Compte rendu de réunion dans l’espace Opérations à partir de ce Markdown."

1. Demandez à l’assistant de trouver l’espace avec findSpaces et de vérifier que vous pouvez y créer du contenu.
2. Fournissez le titre de l’article et son contenu en Markdown. L’assistant les transmet à createArticle avec l’identifiant de l’espace. Par défaut, l’article est enregistré en brouillon (publish: false).
3. Ouvrez le lien de l’article renvoyé par l’assistant. Relisez le brouillon dans Elium, puis suivez votre procédure habituelle de publication ou d’approbation.

Vous pouvez demander explicitement à l’assistant de publier le nouvel article (publish: true). Vos droits dans l’espace s’appliquent : une approbation peut être nécessaire avant la publication. Le résultat contient l’identifiant de l’article, son lien et une indication de publication. Un article non publié peut être un brouillon ou un article en attente d’approbation.

L’outil accepte le Markdown standard, notamment les tableaux, listes de tâches, textes barrés, notes de bas de page, formules mathématiques, indices et exposants. Pour des exemples de syntaxe, consultez Format d’entrée Markdown. Utilisez les formes Markdown standard avec cet outil ; il ne propose pas le mode d’import Elium Markdown.

Si l’import ne peut pas conserver une mise en forme ou un contenu, la demande est refusée avant la création de l’article. Demandez à l’assistant de corriger les problèmes signalés, puis de réessayer.

updateArticle

Demandez à votre assistant connecté de modifier un passage précis, par exemple : "Dans la politique de déplacement, remplace l’indemnité de repas de 25 € par 30 € et enregistre un brouillon."

1. Demandez à l’assistant de lire d’abord l’article, y compris son dernier brouillon s’il contient des modifications non publiées.
2. Indiquez les passages à modifier. L’assistant transmet le texte Markdown exact et son remplacement. Il doit aussi transmettre la version lue pour qu’Elium refuse la modification si une version plus récente existe. Pour un article traduit, la langue lue est obligatoire ; seule cette traduction est modifiée.
3. Ouvrez le lien de l’article dans Elium. Relisez le brouillon, puis suivez votre procédure habituelle de publication ou d’approbation. L’outil ne publie jamais les modifications.

Chaque passage doit correspondre à un seul emplacement, sauf si l’assistant demande explicitement de remplacer toutes les occurrences. Un remplacement vide supprime le texte. Si un passage est introuvable, ambigu ou chevauche une autre modification, toute la demande est refusée et l’article reste inchangé. La modification est aussi refusée si quelqu’un édite déjà l’article. En cas de conflit de version, demandez à l’assistant de relire le dernier brouillon avant de réessayer.

L’outil modifie uniquement le corps de l’article. Il peut ajouter un court commentaire à l’historique des versions et signale les ajustements de mise en forme. Consultez le format Markdown en entrée pour connaître les formats acceptés.

findSpaces

Liste les espaces auxquels vous avez accès. L’assistant peut ainsi comprendre l’organisation de votre plateforme et utiliser les identifiants d’espace pour restreindre une recherche avec findSpecificArticles.

Un filtre facultatif recherche dans le nom des espaces, sans tenir compte des majuscules ni des accents. Les résultats sont classés par nom et limités à 50 espaces par requête, même sans filtre. Si l’espace recherché n’apparaît pas, précisez son nom. Les espaces archivés sont exclus.

Chaque résultat comprend l’identifiant, le nom, le lien et le type de visibilité de l’espace, ainsi que sa description et son groupe d’espaces s’ils sont renseignés. Il précise aussi votre rôle, le nombre de membres et vos droits de création et de publication. Si vous pouvez créer du contenu sans pouvoir le publier directement, une approbation est nécessaire avant publication.

Utile comme première étape avant une recherche ciblée, ou pour des demandes telles que "dans quels espaces puis-je publier ?".

findTemplates

Liste les modèles d’article (types d’article) activés pour toute la plateforme ou installés dans des espaces que vous pouvez voir. Chaque résultat comprend l’identifiant du modèle, son nom, son icône si elle est définie et une indication de sa disponibilité dans tous les espaces. Pour un modèle installé dans des espaces précis, seuls les identifiants des espaces visibles pour vous sont renvoyés.

Le filtre facultatif sur le nom fonctionne comme celui de findSpaces. Les résultats sont classés par nom et limités à 50 modèles par requête. Si le modèle recherché n’apparaît pas, précisez son nom.

Cela permet à un assistant de trouver le bon modèle avant de filtrer une recherche, pour des demandes telles que "trouve tous les articles qui utilisent le modèle FAQ".

Exemples concrets

Voici quelques actions qu’un assistant connecté peut réaliser, et les outils qu’il utilise en arrière-plan.

• "Comment demander un congé parental ?" Une recherche par le sens (findRelevantArticles) répond à partir des articles RH les plus pertinents, avec les liens.

• "Résume les politiques que nous avons mises à jour ce trimestre." Un filtrage par modèle et par plage de dates (findSpecificArticles), puis la lecture de chaque résultat (readArticle) pour le résumer.

• "Notre politique de conservation des données est-elle toujours à jour ?" La lecture de l’article (readArticle), puis la vérification de sa date de revue et de son statut d’approbation avant de répondre.

• "Dans quels espaces puis-je publier ?" La liste des espaces de l’utilisateur et de ses droits (findSpaces).

• "Trouve tous les articles FAQ dans l’espace Support." La recherche du modèle (findTemplates), celle de l’espace (findSpaces), puis une recherche filtrée (findSpecificArticles).

Chaque exemple s’exécute avec les droits propres de l’utilisateur. L’assistant ne voit jamais de contenu que l’utilisateur ne pourrait pas déjà ouvrir dans Elium.

Concernant l’authentification

Elium utilise le protocole OAuth 2.0 pour authentifier et autoriser l’accès au point de terminaison MCP.

OAuth garantit que les applications externes ne peuvent accéder aux données Elium qu’au nom d’utilisateurs ayant explicitement donné leur accord.

Il existe deux façons de configurer l’authentification pour les intégrations MCP :

1. Enregistrement dynamique de client (recommandé)

Elium prend en charge l’enregistrement dynamique de client (Dynamic Client Registration, DCR), activé sur toutes les plateformes. Avec le DCR, un assistant s’enregistre lui-même comme client OAuth sur votre plateforme. Personne n’a besoin de créer manuellement un identifiant et un secret client.

Elium n’accepte que les enregistrements d’applications connues, comme ChatGPT et Microsoft Copilot Studio. Chacune doit utiliser une URL de redirection autorisée par Elium : les jetons d’accès ne sont donc délivrés qu’à ces applications. Les applications enregistrées apparaissent dans "Applications connectées" avec un badge "DCR" : consultez Enregistrement dynamique des clients.

Pour connecter une autre application par DCR, contactez support@elium.com en indiquant son nom (client_name) et les URL de redirection qu’elle utilise (redirect_uris). Ne demandez l’ajout que d’applications de confiance.

2. Création manuelle d’un client OAuth

Les administrateurs de plateforme peuvent créer manuellement un client OAuth dans "Paramètres" > "Applications connectées". La configuration de Claude ci-dessous utilise cette méthode.

Une fois le client créé, les identifiants (client ID et client secret) peuvent être utilisés pour s’authentifier auprès du point de terminaison MCP selon le flux standard OAuth 2.0.

Cette approche offre aux administrateurs un contrôle total sur la configuration du client et les URL de redirection autorisées.

Recommandation

Utilisez le DCR dès que votre assistant le permet, comme ChatGPT et Copilot Studio : vous n’avez rien à créer dans Elium. Choisissez la création manuelle d’un client OAuth pour une application qui ne peut pas s’enregistrer elle-même, ou si vous devez gérer vous-même les identifiants et les URL de redirection.

Microsoft Copilot Studio

Elium prend en charge l’enregistrement dynamique de Copilot : inutile de créer une application connectée dans Elium.

1. Dans Copilot Studio, ajoutez un serveur MCP à votre agent. Dans le champ "URL du serveur", saisissez https://nom-de-votre-plateforme.elium.com/services/mcp en remplaçant nom-de-votre-plateforme par le nom de votre plateforme Elium.
2. Sélectionnez "OAuth 2.0", puis "Découverte dynamique". La connexion s’enregistre sans que vous ayez à créer manuellement un identifiant et un secret client.
3. Créez la connexion, connectez-vous à Elium et autorisez les accès demandés. Ajoutez les outils MCP à votre agent, puis posez-lui une question sur un article que vous pouvez lire dans Elium.

Consultez les instructions de configuration de Microsoft Copilot Studio pour retrouver les écrans et les étapes de connexion à jour.

ChatGPT

ChatGPT s’enregistre lui-même auprès d’Elium par enregistrement dynamique de client (DCR) : inutile de créer une application connectée dans Elium.

Les étapes ci-dessous se font dans l’application de bureau ChatGPT. Les libellés cités sont ceux de l’interface en anglais, visible sur les captures.

1. Ouvrez "Customize", puis "Plugins".

2. Cliquez sur "Add" en haut à droite, puis sur "Add custom MCP server".

   Agrandir l’image

3. Remplissez le formulaire :

   • "Name" : Elium

   • "Description (optional)" : une courte description, par exemple Trusted Knowledge Base

   • "Connection" : laissez "Server URL" sélectionné et saisissez https://nom-de-votre-plateforme.elium.com/services/mcp, en remplaçant nom-de-votre-plateforme par le nom de votre plateforme Elium

   • "Authentication" : OAuth

4. Cliquez sur "Advanced OAuth settings". Dans "Registration method", choisissez "Dynamic Client Registration (DCR)".

5. Sous "Default scopes", laissez mcp coché pour que ChatGPT puisse rechercher et lire des articles. Laissez aussi mcp:write coché si ChatGPT doit pouvoir créer et modifier des articles.

   Agrandir l’image

6. Lisez l’avertissement sur les serveurs MCP personnalisés. Cochez "I understand and want to continue", puis cliquez sur "Create as a plugin".

7. Dans la fenêtre "Connect Elium", cliquez sur "Continue to Elium".

   Agrandir l’image

8. Elium s’ouvre dans votre navigateur. Connectez-vous si Elium vous le demande, puis autorisez les accès demandés par ChatGPT.

Vous pouvez maintenant faire des recherches dans votre plateforme Elium depuis une conversation ChatGPT.

Elium apparaît aussi dans l’onglet "Personal" de la page Plugins, sous "Created by you". Si vous avez fermé la fenêtre "Connect Elium" avant l’étape 8, cliquez sur + à côté d’Elium pour la rouvrir.

Agrandir l’image

Claude

Étape 1 : créer l’application connectée Claude dans Elium

• Nom : Claude

• URL de redirection : https://claude.ai/api/mcp/auth_callback

Dans "Paramètres", ouvrez "Applications connectées" et cliquez sur "Nouvelle application". Suivez les étapes pour enregistrer une application avec les informations ci-dessus.

Étape 2 : ajouter le connecteur personnalisé dans Claude

L’URL du serveur MCP : https://your-platform-name.elium.com/services/mcp

Agrandir l’image

Utilisez le Client ID et secret de l’application connectée Elium.

Agrandir l’image

Étape 3 : activer Elium dans la conversation

Agrandir l’image

Vous pouvez maintenant faire des recherches Elium directement depuis une conversation Claude.

Agrandir l’image