MCP Administration

À quoi ça sert

Le module « MCP Administration » permet de configurer Deltia depuis un assistant IA que vous utilisez ailleurs (Claude Code, par exemple), au lieu de passer par les écrans d'administration : « Configurez Deltia depuis un assistant IA : l'organisation et les modules que vous administrez. »

Il est distinct du serveur MCP « métier » décrit dans MCP, qui sert à lire et modifier vos données (tâches, fiches, contrats). L'assistant intégré à Deltia ne voit pas ce serveur. Ici, l'assistant agit sur les réglages : ce qu'un administrateur ferait dans « Administration » et dans les espaces d'administration des modules.

L'assistant agit toujours avec vos droits, jamais avec davantage.

Concepts clés

• Serveur MCP d'administration — un second serveur, avec sa propre adresse, séparé du MCP métier. Une connexion établie avec l'un ne donne pas accès à l'autre.
• Opération — une action de réglage que l'assistant peut exécuter, par exemple lister les chatbots ou configurer un modèle d'IA. Chaque opération porte le nom de son domaine suivi de son action.
• Lecture / Écriture / Écriture destructive — une opération « Lecture » consulte des réglages ; une opération « Écriture » les modifie sans rien supprimer ni remplacer (une création, un réordonnancement) ; une opération « Écriture destructive » supprime, archive, remplace, change un droit d'accès ou a un effet hors de Deltia (un e-mail, une publication). Toute écriture qui n'est pas reconnue comme simple est traitée comme destructive.
• Journal d'audit de l'administration MCP — la liste des appels reçus par ce serveur, distincte de celle du MCP métier.
• Droits d'administrateur — les opérations proposées dépendent de ce que vous administrez : l'organisation, ou chacun des modules dont vous êtes administrateur.

Comment faire

Obtenir l'adresse du serveur

1. Cliquez sur votre avatar, puis sur « Intégrations » dans la partie administration du menu.
2. Cliquez sur la carte « MCP Administration ».
3. Dans la carte « URL du serveur MCP d'administration », copiez l'adresse avec le bouton de copie.

L'adresse dépend de l'adresse par laquelle vous accédez à Deltia.

Connecter Claude Code

1. Sur la page « MCP Administration », repérez la carte « Claude Code ».
2. Copiez la commande affichée et exécutez-la dans votre terminal. Elle ajoute le serveur sous le nom « deltia-admin ».
3. Au premier appel, votre navigateur s'ouvre : connectez-vous et validez l'accès à l'administration.

L'authentification passe par OAuth 2.1. Les autres clients MCP se configurent avec la même adresse, selon la marche décrite dans Connecter un assistant IA externe.

Voir les opérations que l'assistant peut exécuter

1. Sur la page, descendez jusqu'à la carte « Opérations disponibles ».
2. Saisissez un mot dans « Rechercher une opération » pour réduire la liste.
3. Cliquez sur une opération pour déplier son détail : un tableau « Paramètre », « Type », « Requis », « Description ».

Les opérations sont regroupées par domaine, avec leur nombre entre parenthèses. Chacune porte le badge « Lecture », « Écriture » ou « Écriture destructive » (en rouge). Leurs descriptions sont rédigées en anglais, à l'attention de l'assistant.

Consulter le journal d'audit de l'administration

Réservé aux administrateurs du module « MCP Administration ».

1. Cliquez sur votre avatar, puis sur « Intégrations » dans la partie administration du menu, et ouvrez la carte « MCP Administration ».
2. Dans la navigation du module, cliquez sur « Administration ».
3. La page « Journal d'audit de l'administration MCP » liste les appels, le plus récent en premier : « Tous les appels reçus par le serveur MCP d'administration : qui a listé, décrit ou exécuté quelle opération. Une ligne par appel. »
4. Cliquez sur « Filtres » pour restreindre la liste, puis sur la ligne pour lire le détail : paramètres envoyés par l'assistant et, en cas d'échec, « Message d'erreur ».

Chaque ligne indique la date, la personne, l'opération visée (avec, dessous, l'outil appelé), le statut, le client et la latence. Vous pouvez filtrer sur « Outil », « Opération », « Utilisateur », « Client OAuth », « Statut », « Code d'erreur », « Date & heure » et « Latence (ms) ». La lecture est la même que celle du journal du MCP métier : voir Consulter le journal d'audit.

Éviter une confirmation à chaque appel

Les clients IA mémorisent leur autorisation outil par outil. Le serveur propose six outils : lister les opérations, décrire une opération, demander une adresse de téléversement de fichier, puis un outil d'exécution par impact (lectures, écritures simples, écritures destructives).

1. Dans votre client, autorisez une fois « list-admin-operations », « describe-admin-operation », « run-admin-query » et « run-admin-mutation ».
2. Laissez « run-admin-destructive-mutation » en confirmation.

Une suppression, un archivage, un remplacement, un changement de droit d'accès ou une action à effet extérieur demande donc toujours votre accord. Le serveur refuse d'exécuter une opération par un outil qui n'est pas celui de son impact : une écriture destructive ne passe jamais par un outil que vous avez autorisé d'avance.

Demander l'accès au module

Le module « MCP Administration » s'accorde comme les autres modules : voir Donner accès aux modules et aux périmètres. Un administrateur de l'organisation l'attribue à chaque personne concernée. Il doit être activé pour l'organisation, voir Activer et configurer les modules.

Référence

Ce que l'assistant peut faire

L'assistant dispose de six outils : lister les opérations, décrire l'une d'elles, demander une adresse de téléversement pour une image, puis exécuter l'opération par l'un des trois outils d'exécution (lecture, écriture, écriture destructive). Créer une organisation et remplacer son logo font partie des écritures destructives.

Chaque opération est exécutée avec vos droits et les mêmes contrôles qu'à l'écran (périmètre de l'organisation, groupes) : l'assistant ne peut faire que ce que l'écran d'administration correspondant vous autoriserait. La liste des opérations ne décide que de ce qui est affiché, jamais de ce qui est permis. Pour qu'il puisse modifier un élément, il peut aussi lire les listes qui en donnent les identifiants. Les données métier (tâches, contrats, produits) ne sont pas exposées par ce serveur.

Ce qui n'est pas proposé

Seules deux opérations acceptent un fichier : la création d'une organisation et le remplacement de son logo. L'assistant demande d'abord une adresse de téléversement (valable cinq minutes), y dépose l'image (PNG, JPEG, WebP ou SVG, 2 Mo au maximum), puis passe l'emplacement obtenu à l'opération.

Les autres opérations qui exigent un fichier téléversé (diapositives du carrousel, modèles de document Word des contrats et des tâches, imports de tableur), qui renvoient un fichier (exports) ou qui demandent une validation dans un navigateur (autorisation d'un connecteur MCP) ne sont pas disponibles. Faites-les depuis les écrans d'administration.

Les modèles de document de l'assistant IA se gèrent en revanche par ce serveur, sans téléverser de fichier : un administrateur du module Assistant IA peut en créer, concevoir (page HTML, pièce 3D, fichier Office), mettre à jour, modifier les champs et les règles (formules, conditions), les prévisualiser, les activer ou les désactiver. Ces opérations sont des écritures simples. Voir Gérer les modèles de document de l'assistant.

Limites et refus

Traçabilité

Chaque appel reçu par ce serveur (liste, description ou exécution d'une opération) est journalisé avec son auteur, l'outil appelé et l'opération visée. Il apparaît dans le journal d'audit de l'administration MCP, distinct de celui du MCP métier (voir « Consulter le journal d'audit de l'administration »). Un appel refusé pour quota dépassé y figure aussi, avec le code « Quota dépassé » et l'outil mcp-request : le refus intervient avant la lecture de la requête, le journal ne sait donc pas quel outil était visé. Les mots de passe, secrets, jetons et valeurs d'autorisation saisis comme paramètres y sont masqués. Les lignes sont purgées selon la durée de conservation réglée pour le module MCP, voir Limiter les appels et régler la conservation du journal.

Questions fréquentes

L'assistant peut-il modifier mes tâches ou mes contrats ?

Non, pas par ce serveur : il ne porte que les réglages. Pour les données métier, utilisez le serveur décrit dans MCP.

Pourquoi la liste d'opérations est-elle vide ?

Parce que vous n'administrez ni l'organisation ni aucun module. Demandez ce rôle à un administrateur de l'organisation.

Un secret saisi par l'assistant reste-t-il confidentiel ?

Pas entièrement. Certaines opérations prennent un secret en paramètre (clé API, mot de passe de base de données) : il transite alors par la conversation avec l'assistant, même si le journal d'audit le masque. Saisissez-le plutôt dans l'écran d'administration quand c'est possible.