Connecter Claude à votre cartographie SI avec MCP (tutoriel)

Vous voulez interroger votre système d'information en langage naturel — savoir quelles applications dépendent d'un serveur, quels processus passent par un outil donné, ou obtenir un résumé de votre paysage applicatif en quelques secondes. Avec le Model Context Protocol (MCP) et UrbaHive, cette capacité est accessible en moins d'une heure. Ce tutoriel vous guide pas-à-pas, de la génération du token à votre première question posée à Claude.

Prérequis : un compte UrbaHive actif (plan Starter ou supérieur), Claude Desktop installé sur votre machine, et une cartographie SI même partielle dans UrbaHive. Si vous n'avez pas encore de compte, commencez par app.urbahive.com/signup.

Pour comprendre ce qu'est MCP avant de vous lancer, consultez Qu'est-ce que le Model Context Protocol ? Définition simple et exemples.

Étape 1 — Vérifier que votre cartographie SI contient des données

Avant de configurer MCP, assurez-vous que votre espace UrbaHive contient au moins quelques éléments : des applications, des serveurs ou des processus métier. Le connecteur MCP n'a de valeur que si la source de données qu'il expose est renseignée.

Si vous débutez, importez ou créez une dizaine d'applications représentatives de votre SI, avec leurs dépendances principales. C'est suffisant pour un premier test concluant. Pour structurer votre cartographie, vous pouvez vous appuyer sur notre guide Cartographie du système d'information : définition et guide complet.

Étape 2 — Générer un Personal Access Token (PAT) dans UrbaHive

Connectez-vous à votre espace UrbaHive sur app.urbahive.com.
Accédez aux Paramètres de l'organisation (icône engrenage en haut à droite, puis « Organisation »).
Dans la section Connecteurs / API, cliquez sur Générer un nouveau token.
Donnez un nom explicite à votre token — par exemple « Claude-Desktop-MCP » — pour le retrouver facilement dans l'audit log.
Copiez immédiatement le token généré. Il ne sera affiché qu'une seule fois.

Note de sécurité : un token PAT donne un accès en lecture seule à toutes les données de votre organisation dans UrbaHive. Traitez-le comme un mot de passe : ne le partagez pas dans un email non chiffré, ne le commitez pas dans un dépôt de code. Si vous pensez qu'il a été compromis, révoquez-le depuis le même écran et générez-en un nouveau.

Étape 3 — Installer Claude Desktop

Si Claude Desktop n'est pas encore installé sur votre poste, téléchargez-le depuis claude.ai/download. L'application est disponible pour macOS et Windows. Une fois installée, connectez-vous avec votre compte Anthropic (ou créez-en un).

Claude Desktop est requis pour cette configuration. La version web de claude.ai supporte également MCP, mais la procédure de configuration est légèrement différente — elle est décrite dans la documentation UrbaHive.

Étape 4 — Configurer le serveur MCP dans Claude Desktop

Claude Desktop lit sa configuration MCP depuis un fichier JSON. Voici comment le modifier :

Ouvrez Claude Desktop.
Allez dans Paramètres (menu Claude > Paramètres sur macOS, ou icône engrenage sur Windows).
Dans l'onglet Développeur, cliquez sur Modifier la configuration.
Un fichier claude_desktop_config.json s'ouvre dans votre éditeur de texte.
Ajoutez le bloc suivant dans la section mcpServers (créez la section si elle n'existe pas) :

`json

{

"mcpServers": {

"urbahive": {

"command": "npx",

"args": ["-y", "@urbahive/mcp-server"],

"env": {

"URBAHIVETOKEN": "votretokenPATici",

"URBAHIVEORG": "votreidentifiant_organisation"

}

Remplacez votre_token_PAT_ici par le token copié à l'étape 2, et votre_identifiant_organisation par le slug de votre organisation UrbaHive (visible dans l'URL de votre espace, par exemple acme-corp).

Enregistrez le fichier et redémarrez Claude Desktop.

Note technique : cette commande utilise npx, qui nécessite Node.js installé sur votre machine. Si Node.js n'est pas présent, téléchargez-le depuis nodejs.org. La version 18 ou supérieure est recommandée.

Étape 5 — Vérifier la connexion

Après le redémarrage de Claude Desktop :

Ouvrez une nouvelle conversation.
Cliquez sur l'icône Outils (ou MCP) en bas du champ de saisie. Vous devez voir « urbahive » dans la liste des serveurs connectés, avec un indicateur vert.
Si le serveur apparaît en rouge ou n'est pas listé, vérifiez que le token est correctement collé (sans espace en début ou fin), que l'identifiant d'organisation est exact, et que Node.js est bien installé.

Étape 6 — Poser vos premières questions à Claude sur votre SI

Votre connexion est active. Voici quelques questions pour commencer :

« Quelles applications composent mon système d'information ? »
« Quelles applications dépendent du serveur [nom du serveur] ? »
« Résume mon paysage SI en cinq points. »
« Quels processus métier utilisent [nom de l'application] ? »
« Y a-t-il des applications sans processus métier associé ? »

Claude interroge le serveur MCP UrbaHive en temps réel et formule ses réponses à partir des données de votre cartographie. Chaque appel est journalisé dans l'audit log de votre espace UrbaHive — accessible dans Paramètres > Logs d'audit.

Gestion des accès et révocation

Plusieurs membres de votre équipe peuvent configurer MCP avec leur propre token PAT. Chaque token est individuel et lié à un seul compte utilisateur, ce qui permet de tracer précisément les accès dans l'audit log.

Pour révoquer un token : Paramètres > Connecteurs / API > icône corbeille à côté du token concerné. La révocation est instantanée.

Si vous travaillez avec plusieurs organisations dans UrbaHive (multi-tenant), créez un token distinct pour chaque organisation. Un token ne donne accès qu'à l'organisation pour laquelle il a été généré.

Ce que vous pouvez (et ne pouvez pas) faire via MCP

Le serveur MCP UrbaHive est conçu en lecture seule. Cela signifie :

Ce que Claude peut faire :

Lister, décrire et résumer les applications, serveurs, flux de données, processus.
Croiser des informations (ex. : applications liées à un serveur donné).
Produire des synthèses et des analyses à partir des données de votre cartographie.

Ce que Claude ne peut pas faire :

Créer, modifier ou supprimer des éléments dans UrbaHive.
Accéder aux données d'une autre organisation.
Exporter des données en masse.

Cette contrainte est délibérée et documentée — elle fait partie des garanties de sécurité du connecteur. Pour une analyse complète des enjeux de sécurité, consultez Cartographie SI et cybersécurité : le guide du RSSI.

Aller plus loin

Une fois la connexion établie, l'étape suivante consiste à enrichir votre cartographie SI pour tirer le meilleur parti du connecteur MCP. Plus votre cartographie est complète — processus métier rattachés aux applications, dépendances serveur renseignées, périmètre DORA/NIS2 identifié — plus les réponses de Claude seront précises et actionnables.

Consultez notre guide complet Model Context Protocol : connecter l'IA à votre système d'information pour une vue stratégique sur ce que MCP apporte à votre gouvernance SI. Et pour structurer votre cartographie, notre article Urbanisation SI : guide complet pour PME/ETI est un bon point de départ.

Commencez gratuitement sur app.urbahive.com/signup et explorez le connecteur sur urbahive.com/connectors.

FAQ — Configuration MCP avec UrbaHive

Faut-il être développeur pour configurer MCP ?

Non. La configuration se limite à copier un token et à modifier un fichier JSON. La procédure décrite dans ce tutoriel est réalisable par tout professionnel IT à l'aise avec les outils de base. Aucun développement n'est nécessaire.

Claude Desktop est-il le seul client compatible ?

Non. claude.ai (version web) et Claude Code supportent également MCP. La procédure de configuration varie légèrement selon le client — consultez la documentation UrbaHive pour les détails propres à chaque environnement.

Mon token PAT a expiré — que faire ?

Les tokens PAT UrbaHive n'ont pas de date d'expiration automatique, mais vous pouvez les révoquer manuellement à tout moment. Si vous perdez un token, révoquez-le et créez-en un nouveau : la mise à jour dans le fichier de configuration Claude prend moins d'une minute.

Le connecteur MCP fonctionne-t-il en déconnecté ?

Non. Le serveur MCP UrbaHive est en ligne et nécessite une connexion Internet active pour répondre aux requêtes de Claude Desktop.

Peut-on restreindre ce que Claude voit dans UrbaHive via MCP ?

Le token PAT donne accès à l'ensemble des données de l'organisation en lecture. Des options de périmétrage plus fin (par domaine applicatif ou par périmètre) sont prévues dans la roadmap Enterprise. Consultez la page Connecteurs ou contactez l'équipe UrbaHive pour plus d'informations.