Aller au contenu principal

Claude (MCP)

Le point d'accès MCP permet à un utilisateur d'interroger son instance NomaUBL depuis Claude Desktop, Claude Code ou un connecteur claude.ai, sous son propre compte : les factures et leur historique, les erreurs de validation, l'e-reporting, les tableaux de bord et les chiffres d'une période, le journal du serveur, les paramètres, la documentation. Les factures et les envois d'e-reporting sont ceux des sociétés et du périmètre de données de l'utilisateur, comme dans les listes de l'application. Il est en lecture seule tant que l'instance n'autorise pas les modifications, désactivé par défaut, et demande une licence valide.

Ce qui part chez Anthropic dans ce cas, et ce qui n'y part pas, est décrit dans Données transmises à Anthropic.


Vue d'ensemble​

ProfilProfilClaude (MCP)Fichiers d'exempleConnectez Claude Desktop ou Claude Code à NomaUBL sous votre compte.ADRESSE DU SERVEURhttps://nomaubl.example.com/mcpCopierVALIDITÉ30 jours90 jours365 joursCréer un jetonCLAUDE DESKTOPTéléchargez, ouvrez le fichier, puis collez votre jeton.⤓ ExtensionVOS JETONSnmu_4f2a91c7…créé icicréé le 19/11/2026 · expire le 17/02/2027RévoquerOnglet Claude (MCP)rôles avec Accès MCPAdresse du serveurà donner à ClaudeExtension Claude Desktopadresse déjà renseignéeJetonaffiché une fois, 30 / 90 / 365 jRévoquerjetons et accès ouverts par ClaudeOnglet Fichiers d'exempletout utilisateur · 7 jours

Activation​

Dans Paramètres → Global → AI, groupe MCP server (cet éditeur reste en anglais dans l'application) :

ChampDéfautDescription
MCP endpointNL'instance répond sur /mcp, pour les utilisateurs dont le rôle a Accès MCP.
Allow changes over MCPNClaude peut enregistrer des analyses, des mappings et des documents à la demande de l'utilisateur — voir Modifications. Désactivé : lecture seule.

L'authentification doit être activée sur l'instance : Claude agit toujours au nom d'un utilisateur identifié.

Derrière un proxy inverse, renseigner Public address dans Paramètres → Global → Authentication : la connexion depuis Claude s'appuie sur cette adresse, comme les liens de réinitialisation de mot de passe.


Qui peut se connecter​

Seuls les rôles qui ont la fonctionnalité Accès MCP (Rôles, onglet Accès) peuvent connecter Claude ; aucun rôle ne l'a par défaut. Les autres droits du rôle déterminent ensuite ce que Claude atteint :

OutilsDroit du rôle
Factures, erreurs, cycle de vie, e-reporting, tableaux de bord, chiffres d'une période, documentationAccès MCP. Les factures et les envois d'e-reporting sont limités aux sociétés et aux filtres de lignes du rôle.
Journal du serveurLa page Journal serveur.
Tableau de bord techniqueLa page Tableau de bord IT.
Explorateur de données — modèle, champs, agrégations, analyses enregistréesLa page Explorateur.
Conversion PDF vers XML d'un exempleLa page Traiter Document, ou l'Accès aux paramètres.
Rapport d'implémentation ; revue du paramétrage — objets de configuration, contrôle de configuration, tâches planifiées, jeux de règles, état de la licence, système — ; travail de mappingAccès aux paramètres.

Un rôle sans liste de pages autorisées atteint toutes les pages. Une facture hors du périmètre de l'utilisateur est signalée comme introuvable.


Connecter Claude​

L'adresse du serveur, les jetons et l'extension se trouvent dans l'onglet Claude (MCP) de la fenêtre de profil (le bouton utilisateur de la barre supérieure).

MoyenPourÉtapes
Extension Claude DesktopClaude Desktop, y compris pour une instance inaccessible depuis Internet.Extension télécharge un fichier .mcpb. L'ouvrir avec Claude Desktop : l'adresse du serveur est déjà renseignée, et l'extension demande le jeton personnel. Rien d'autre à installer.
Connexion depuis le clientClaude Code ; un connecteur claude.ai quand l'instance est accessible depuis Internet.Donner au client l'Adresse du serveur seule. Le navigateur ouvre NomaUBL : se connecter comme d'habitude (mot de passe ou SSO), puis sur Connecter Claude à NomaUBL choisir 30, 90 ou 365 jours et cliquer sur Autoriser (ou Refuser).
Jeton colléClaude Code, un script.Créer un jeton, le copier — affiché une seule fois, copiez-le maintenant — et le donner au client dans l'en-tête de requête Authorization: Bearer <jeton>.

L'extension a quatre réglages dans Claude Desktop : Adresse de NomaUBL, Jeton personnel, Dossier d'exemples (facultatif — le seul dossier d'où Claude peut envoyer des fichiers) et Accepter un certificat interne (pour un certificat auto-signé ou d'entreprise). Ils sont dans la langue de l'interface depuis laquelle l'extension a été téléchargée.

Le nom de l'extension porte l'environnement et l'adresse de son instance — NomaUBL – prod · nomaubl.example.com : les extensions de plusieurs instances s'installent côte à côte, chacune avec son jeton. Claude sait à quelle instance il s'adresse et précise celle que concerne une réponse.

Réponse du point d'accèsSignification
404Le point d'accès MCP est désactivé.
401Pas de jeton, ou un jeton inconnu, expiré ou révoqué.
403Le rôle n'a pas Accès MCP, ou l'instance n'a pas de licence valide.

Jetons​

Vos jetons liste les jetons de l'utilisateur et les accès ouverts par une connexion depuis Claude. Chaque ligne indique son origine — le nom du client autorisé, ou créé ici pour un jeton créé dans cet onglet — et ses dates de création et d'expiration ; Révoquer met fin à l'un d'eux aussitôt. Un jeton est valable 30, 90 ou 365 jours.

Un changement de mot de passe, par l'utilisateur ou par un administrateur, et la désactivation du compte suppriment les jetons de l'utilisateur : un compte réactivé repart sans aucun jeton. Un jeton cesse aussi de fonctionner quand le rôle perd Accès MCP.

Le serveur conserve une empreinte du jeton, jamais le jeton lui-même.


Ce que Claude peut faire​

SujetClaude peut
FacturesLister des factures, en lire une en entier (en-tête, lignes, TVA, erreurs de validation, cycle de vie avec les motifs de la plateforme), lister les envois d'e-reporting.
ChiffresLire les chiffres de la Synthèse, des Statistiques, de l'Exploitation et du tableau de bord technique, et la synthèse d'une période.
Explorateur de donnéesLancer toute agrégation de l'Explorateur — regroupement, mesures, filtres, période, N premiers — et les analyses enregistrées.
DiagnosticLire le journal du serveur, les contrôles d'intégrité, les codes de statut et de motif, l'e-annuaire, et suivre les procédures de diagnostic.
Revue du paramétrageLire les objets de configuration, le contrôle de configuration, les tâches planifiées, les jeux de règles, l'état de la licence et les paramètres — les secrets ne sont jamais affichés.
DocumentationChercher et lire la documentation de NomaUBL et le rapport d'implémentation de l'instance.
Exemples et mappingLire la structure d'un XML d'exemple, convertir un PDF d'exemple avec les réglages d'un document, proposer et contrôler un mapping — voir plus bas.

Un résultat de plus de 60 000 caractères est coupé, et Claude est invité à restreindre sa demande.


Fichiers d'exemple​

Un XML ou un PDF du client peut être confié à Claude comme support de travail :

  • depuis la fenêtre de profil : onglet Fichiers d'exemple, bouton Ajouter ;
  • depuis Claude Desktop, qui envoie un fichier du Dossier d'exemples choisi dans les réglages de l'extension, et d'aucun autre dossier, quand l'utilisateur lui demande de travailler dessus.

Les exemples sont des fichiers .xml ou .pdf de 20 Mo au plus, 50 par utilisateur, conservés 7 jours puis supprimés par le serveur. Ce sont les copies de travail d'un utilisateur : ils ne sont jamais traités comme des factures ni envoyés à la plateforme.

L'onglet Fichiers d'exemple est affiché pour tout utilisateur, avec ou sans Accès MCP : un fichier joint dans l'assistant IA s'y retrouve aussi, et s'y supprime.

Avec un exemple, Claude lit la structure d'un XML, ou convertit un PDF avec les réglages d'un document et essaie des ancres de tableau sans rien enregistrer. Avec l'Accès aux paramètres, il fait aussi le travail de mapping de l'éditeur XSL : il propose le mapping d'un exemple (et, pour un PDF texte, les règles d'extraction), lit le mapping enregistré d'un document et les variables exigées par son jeu de règles, contrôle un mapping sur un exemple et montre l'UBL obtenu. L'exemple suit les étapes d'un traitement réel : un PDF converti en PDF texte ou en PDF JD Edwards selon le document, la feuille de style de prétraitement, le découpage en factures, l'inversion de signe. Rien n'est enregistré : Claude donne les valeurs à saisir dans l'éditeur de mapping.


Modifications​

Avec Allow changes over MCP, Claude peut, à la demande de l'utilisateur :

ModificationDroit du rôle
Enregistrer une analyse de l'Explorateur.La page Explorateur.
Enregistrer des valeurs de mapping dans la feuille de style d'un document.Accès aux paramètres.
Enregistrer les réglages PDF vers XML d'un document.Accès aux paramètres.
Créer un document — selon sa source : XML, PDF, UBL ou connecteur, avec sa propre feuille de style vierge ou à partir d'un document existant — ou modifier ses réglages.Accès aux paramètres.

Chaque source garde ses règles : les réglages d'un PDF texte sont refusés sur un document JD Edwards et inversement, et un document UBL n'a pas de mapping. Mots de passe, jetons et clés ne peuvent pas être définis par ce moyen. La version précédente reste dans l'historique des fichiers ou dans l'historique de configuration, et chaque modification est écrite dans le journal du serveur avec le nom de l'utilisateur. Claude demande l'accord de l'utilisateur avant un appel qui modifie quelque chose.


Utilisation​

La vue Utilisation de l'IA du Diagnostic liste les appels faits depuis Claude sous le canal Claude (MCP) — par utilisateur, par jour et par outil, avec ceux en échec et ceux qui ont enregistré une modification. Le journal du serveur contient une ligne par appel en échec et une par modification ; une lecture réussie ne laisse aucune ligne.


Conseils & bonnes pratiques​

  • Accorder Accès MCP d'abord à un rôle dédié. Claude atteint ce que les droits du rôle ouvrent : la page Explorateur et l'accès aux paramètres donnent les outils correspondants.
  • Laisser Allow changes over MCP désactivé en production tant que le travail de mapping n'est pas terminé sur une instance de test ; la Promotion transporte ensuite le résultat.
  • Préférer l'extension pour un serveur interne. Un connecteur claude.ai est appelé depuis Internet ; l'extension appelle l'instance depuis le poste de l'utilisateur.
  • Révoquer sans attendre l'expiration. Un jeton qui ne sert plus se termine depuis le profil en un clic.