Initialiser sa cartographie SI depuis le code avec un agent IA (MCP)

Jusqu'ici, le connecteur MCP d'UrbaHive servait surtout à interroger votre système d'information en langage naturel. Il fait désormais bien plus : un agent IA peut créer et mettre à jour votre cartographie. Concrètement, vous pouvez pointer un agent sur votre code ou vos documents d'architecture et le laisser initialiser votre cartographie SI — applications, flux, serveurs, processus, capacités — en quelques minutes, depuis Claude Code, Cursor, Codex, Windsurf, Devin ou tout autre client MCP.

Pour découvrir le protocole avant de vous lancer, lisez Qu'est-ce que le Model Context Protocol ?. Pour une première connexion guidée avec Claude Desktop, voyez Connecter Claude à votre cartographie SI avec MCP.

Ce qui a changé : lecture et écriture

Le serveur MCP d'UrbaHive expose aujourd'hui 65 outils : des outils de lecture (list_*, get_*, search_architecture, get_architecture_summary) et des outils d'écriture (create_*, update_*, set_*).

Le modèle reste sûr par construction :

• Lecture par défaut. Un jeton est en lecture seule sauf si vous activez explicitement l'écriture à sa création (scope « write »).
• Double barrière. Écrire exige à la fois le scope « write » du jeton et un rôle suffisant : Owner ou Editor pour les typologies, Owner/Editor/Member pour les éléments. Les Viewers restent en lecture.
• Aucune suppression. Le protocole n'expose aucun outil de suppression. Les corrections se font dans l'interface.
• Cloisonné et tracé. Un jeton ne donne accès qu'à une seule organisation, chaque appel est journalisé dans votre audit log et limité en débit.

Pour le détail sécurité et RGPD, voyez MCP et sécurité : modèle d'accès, RGPD et conformité SI.

Étape 1 — Générer un jeton avec le scope « write »

1. Connectez-vous à app.urbahive.com et ouvrez Réglages → Connectors.
2. Créez un nouveau jeton, choisissez l'organisation cible et activez l'option write.
3. Copiez le jeton immédiatement : il n'est affiché qu'une seule fois. Les jetons ont une durée de vie (90 jours par défaut) et sont révocables à tout moment depuis le même écran.

L'endpoint du serveur est : https://app.urbahive.com/api/mcp. Tous les clients ci-dessous s'y connectent avec l'en-tête Authorization: Bearer <PAT>.

Étape 2 — Brancher votre agent

Remplacez <PAT> par votre jeton. Quand le format le permet, stockez le jeton dans une variable d'environnement (par exemple URBAHIVE_PAT) plutôt qu'en clair.

Claude Code

`bash

claude mcp add --transport http urbahive \

https://app.urbahive.com/api/mcp \

--header "Authorization: Bearer <PAT>"

`

Vérifiez ensuite avec claude mcp list.

Claude Desktop / claude.ai

La configuration prête à coller se trouve directement dans Réglages → Connectors d'UrbaHive : Claude Desktop passe par le pont mcp-remote, et claude.ai accepte l'URL via *Add custom connector* (URL + Bearer PAT).

Cursor — ~/.cursor/mcp.json

`json

{

"mcpServers": {

"urbahive": {

"url": "https://app.urbahive.com/api/mcp",

"headers": { "Authorization": "Bearer ${env:URBAHIVE_PAT}" }

}

}

}

`

Windsurf — ~/.codeium/windsurf/mcp_config.json

`json

{

"mcpServers": {

"urbahive": {

"serverUrl": "https://app.urbahive.com/api/mcp",

"headers": { "Authorization": "Bearer ${env:URBAHIVE_PAT}" }

}

}

}

`

Codex CLI — ~/.codex/config.toml

`toml

[mcp_servers.urbahive]

url = "https://app.urbahive.com/api/mcp"

bearertokenenvvar = "URBAHIVEPAT"

`

Devin

Dans les réglages MCP de Devin, ajoutez un serveur Streamable HTTP avec l'URL https://app.urbahive.com/api/mcp et l'en-tête Authorization: Bearer <PAT>.

Tout autre client (stdio uniquement)

Les clients qui ne parlent que stdio peuvent passer par le pont mcp-remote :

`bash

npx -y mcp-remote https://app.urbahive.com/api/mcp \

--header "Authorization: Bearer <PAT>"

`

Étape 3 — Initialiser votre cartographie depuis le code

Avec un jeton « write », confiez à l'agent votre dépôt ou vos documents d'architecture et laissez-le créer les éléments dans le bon ordre de dépendance :

1. Typologies — create_editor, create_infrastructure, create_flow_type, create_project_advancement_status, create_dat_version_status, create_organization_role.
2. Programmes — create_program.
3. Applications, serveurs, flux — create_application, create_server, create_flow.
4. Objets de données — create_dat_object, create_dat_version.
5. Processus — create_process_domain, create_process, create_process_step, puis set_process_step_actors, set_process_step_applications, set_process_relations.
6. Capacités — create_capability, puis set_capability_applications.

Exemple de prompt : *« Lis ce dépôt, déduis les applications, les flux de données et les serveurs, puis crée-les dans UrbaHive via les outils MCP, en respectant l'ordre typologie → programme → application → flux. »*

Quelques garde-fous :

• La création de typologies demande un rôle Owner ou Editor ; un Member peut créer des éléments mais pas des typologies.
• Comme aucun outil de suppression n'est exposé, corrigez les erreurs éventuelles dans l'interface.
• Demandez à l'agent de procéder par lots et de vérifier après chaque étape (via les outils list_*) pour éviter les doublons.

Une fois la base initialisée, vous bénéficiez de tout UrbaHive : matrice de couverture, analyse d'impact, détection des risques. Pour structurer la suite, voyez Urbanisation SI : guide complet pour PME/ETI et Lier processus métier et cartographie applicative.

FAQ

Faut-il savoir coder pour initialiser sa cartographie depuis le code ?

Non. C'est l'agent IA qui lit le code et appelle les outils. Votre rôle est de fournir le contexte (dépôt, schémas, inventaire) et de relire le résultat dans UrbaHive.

Quels clients sont compatibles ?

Tout client MCP « streamable HTTP » : Claude (Desktop, Code, claude.ai), Cursor, Windsurf, Codex, Devin, et les autres via mcp-remote.

Un agent peut-il supprimer des données par erreur ?

Non. Aucun outil de suppression n'est exposé, et l'écriture exige un jeton « write » plus un rôle adéquat. En cas de doute, gardez un jeton en lecture seule.

Les données quittent-elles l'UE ?

Non. Le serveur MCP est hébergé en Europe et chaque appel est journalisé. Voir MCP et sécurité.

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