Nous venons de livrer la fonctionnalité qui m'enthousiasme le plus : un serveur MCP qui vous permet d'interroger et de modifier votre documentation d'architecture directement depuis Claude Code, Cursor ou tout assistant IA compatible MCP. Voici pourquoi ça change tout.

Serveur MCP : Dialoguez avec votre Architecture depuis vos Outils IA Favoris

J'utilise des assistants IA de codage quotidiennement depuis plus d'un an maintenant. Claude Code pour les refactorisations complexes, Cursor pour les modifications rapides, GitHub Copilot pour l'autocomplétion. Mais il y avait toujours une lacune frustrante : ces outils ne pouvaient pas voir ma documentation d'architecture.

Chaque fois que je demandais à Claude d'"ajouter un nouvel endpoint au service de paiement", il devinait. Il ne savait pas que notre service de paiement communique avec Stripe, utilise Redis pour le cache, et a des exigences de sécurité spécifiques documentées dans nos ADRs. Je passais plus de temps à corriger l'IA qu'à écrire du code moi-même.

Aujourd'hui, nous comblons cette lacune. Archyl expose désormais un serveur MCP (Model Context Protocol) complet avec 56 outils qui donnent aux assistants IA une visibilité totale sur votre architecture.

Qu'est-ce que le MCP ?

Le Model Context Protocol est le standard ouvert d'Anthropic pour connecter les assistants IA à des outils et sources de données externes. Pensez-y comme un adaptateur universel entre les LLMs et les systèmes avec lesquels ils doivent interagir.

Au lieu de copier-coller du contexte dans les prompts, le MCP permet aux assistants IA d'interroger directement vos outils. Ils peuvent lire des données, effectuer des actions et rester synchronisés avec vos systèmes réels.

Et le serveur MCP d'Archyl signifie que votre documentation d'architecture devient une source de données de premier ordre pour tout assistant IA.

Que pouvez-vous faire avec ?

C'est là que ça devient excitant. Avec le serveur MCP d'Archyl, votre assistant IA peut :

Interroger votre Architecture

Posez des questions naturelles et obtenez des réponses réelles :

"Quels éléments sont liés au système Payment Processor ?"
"De quels conteneurs dépend le User Service ?"
"Montre-moi tous les systèmes qui interagissent avec notre base PostgreSQL"
"Quels ADRs affectent le flux d'authentification ?"

L'IA ne devine pas. Elle interroge votre architecture réellement documentée et renvoie des informations précises et structurées.

Claude Code interrogeant l'architecture via MCP

Naviguer dans le Modèle C4

Votre IA comprend la hiérarchie complète :

Lister tous les projets de votre organisation
Descendre des systèmes aux conteneurs jusqu'aux composants
Explorer les relations et dépendances
Comprendre la stack technique à chaque niveau

Quand vous demandez "quelles technologies utilise le Order Service ?", l'IA renvoie la stack réellement documentée, pas une supposition hallucinée.

Modifier la Documentation

C'est la fonctionnalité phare. Le serveur MCP supporte les opérations d'écriture :

Créer de nouveaux systèmes, conteneurs et composants
Ajouter des relations entre éléments
Créer et mettre à jour des ADRs
Rédiger de la documentation projet
Définir des user flows

Demandez à Claude de "documenter le nouveau service de notifications qu'on vient de construire" et il peut créer les éléments C4, les lier aux systèmes existants, et même rédiger un ADR expliquant la décision de conception.

Rester Synchronisé

L'IA voit toujours le dernier état. Pas de contexte périmé, pas de documentation obsolète. Quand votre collègue met à jour l'architecture, votre assistant IA le voit immédiatement.

56 Outils, Une Seule Intégration

Nous n'avons pas construit une preuve de concept minimale. Le serveur MCP expose des fonctionnalités complètes :

Projets & Paramètres : Lister, obtenir et gérer les projets. Configurer les fournisseurs IA et les paramètres de découverte.

Modèle C4 (Les 4 Niveaux) : CRUD complet pour les systèmes, conteneurs, composants et éléments de code. Créer des relations, gérer les overlays, manipuler la hiérarchie complète du modèle.

Documentation : Créer et mettre à jour la documentation d'architecture. Lier les docs à des éléments C4 spécifiques.

ADRs : Gestion complète des Architecture Decision Records. Créer, mettre à jour, lister et lier les ADRs aux éléments qu'ils concernent.

User Flows : Définir et visualiser les parcours utilisateurs à travers votre système.

Découverte : Déclencher la découverte d'architecture alimentée par l'IA sur vos dépôts connectés.

Équipes : Interroger la structure des équipes et l'accès aux projets.

Chaque outil renvoie des données structurées sur lesquelles les assistants IA peuvent raisonner. Pas de parsing HTML, pas de scraping d'UI, pas d'intégrations fragiles.

Démarrage en 2 Minutes

Voici comment connecter Claude Code (ou tout outil compatible MCP) :

Étape 1 : Créer une Clé API

Allez dans votre profil Archyl, cliquez sur "Clés API", et créez une nouvelle clé. Donnez-lui un nom descriptif comme "Claude Code" et sélectionnez les scopes dont vous avez besoin (lecture seule ou accès complet).

Copiez la clé immédiatement — vous ne la reverrez plus.

Étape 2 : Configurer votre Client MCP

Ajoutez Archyl à votre configuration MCP. Pour Claude Code, ajoutez ceci à vos paramètres :

{
  "mcpServers": {
    "archyl": {
      "url": "https://api.archyl.com/mcp",
      "transport": "http",
      "headers": {
        "X-API-Key": "votre_cle_api_ici"
      }
    }
  }
}

Étape 3 : Commencez à Dialoguer avec votre Architecture

C'est tout. Posez des questions à votre assistant IA sur votre architecture et regardez-le récupérer des données réelles depuis Archyl.

Essayez ces prompts :

"Liste tous mes projets Archyl"
"Quels systèmes existent dans le projet E-commerce Platform ?"
"Montre-moi les relations du Payment Gateway"
"Crée un nouvel ADR expliquant pourquoi nous avons choisi PostgreSQL"

Pourquoi c'est Important

La documentation d'architecture a toujours eu un problème de découvrabilité. Vous l'écrivez, elle vit dans un wiki ou un diagramme quelque part, et puis personne ne la lit. Les ingénieurs posent des questions sur Slack au lieu de consulter la doc.

Le MCP change le modèle d'interaction. La documentation n'est plus quelque chose que vous allez lire — c'est quelque chose que votre assistant IA connaît. Quand vous demandez "comment fonctionne le traitement des paiements ?", la réponse vient de votre architecture réelle, pas des données d'entraînement de l'IA.

Cela a des implications profondes :

L'onboarding devient instantané. Les nouveaux ingénieurs demandent à leur IA l'architecture du système et obtiennent des réponses précises dès le premier jour.

Le contexte est toujours disponible. En écrivant du code, l'IA sait exactement quels services existent, comment ils se connectent, et quelles décisions les ont façonnés.

La documentation reste à jour. Parce qu'elle est activement utilisée, les inexactitudes sont remarquées et corrigées. Une documentation morte est une documentation que personne ne lit.

Les suggestions IA sont ancrées dans la réalité. Quand Claude suggère un design, il est informé par votre architecture réelle, pas par des patterns génériques.

La Vision Globale

Nous entrons dans une ère où les assistants IA sont de véritables collaborateurs dans le développement logiciel. Mais ils ne sont aussi bons que le contexte auquel ils ont accès.

La plupart des interactions IA aujourd'hui sont pauvres en contexte. Vous collez du code, ajoutez une brève description, et espérez que l'IA comprenne le reste. Les résultats sont médiocres parce que l'IA travaille à l'aveugle.

Les intégrations MCP inversent ce modèle. Votre IA a un accès persistant et interrogeable à tout ce dont elle a besoin : votre code (via l'intégration dépôt), votre architecture (via Archyl), vos tickets (via les intégrations Jira/Linear), votre documentation (via les intégrations Notion/Confluence).

L'IA devient un vrai membre de l'équipe avec accès à la connaissance collective.

Le serveur MCP d'Archyl est notre contribution à cette vision. Votre architecture ne devrait pas être enfermée dans un outil de diagramme. Elle devrait être accessible à tous les outils que votre équipe utilise, y compris vos assistants IA.

Et Ensuite ?

C'est la version 1. Voici ce que nous construisons ensuite :

Suggestions proactives : Le serveur MCP pourrait surveiller les changements d'architecture et suggérer des mises à jour de documentation.

Liens croisés : Connecter les ADRs à des commits spécifiques, lier la documentation aux événements CI/CD, créer un réseau de connaissances interconnectées.

Requêtes personnalisées : Définir des requêtes spécifiques à l'organisation comme "montre-moi tous les services gérés par l'équipe paiements."

Journalisation d'audit : Tracer chaque interaction MCP pour la conformité et le débogage.

Essayez Maintenant

Le serveur MCP est disponible dès aujourd'hui sur tous les plans Archyl. Si vous utilisez déjà Claude Code, Cursor ou un autre outil compatible MCP, vous pouvez vous connecter en quelques minutes.

Créez une clé API, ajoutez la configuration, et commencez à dialoguer avec votre architecture.

Et si vous n'utilisez pas encore Archyl, inscrivez-vous gratuitement et découvrez comment fonctionne la documentation d'architecture alimentée par l'IA. Connectez un dépôt, lancez une découverte, puis connectez votre assistant IA préféré.

Votre architecture est trop importante pour être enfermée dans des diagrammes statiques. Laissez vos assistants IA l'explorer.

Vous voulez en savoir plus sur les capacités IA d'Archyl ? Consultez notre article sur la Découverte d'Architecture par l'IA, ou commencez par les bases avec notre Introduction au Modèle C4.

Serveur MCP : Dialoguez avec votre Architecture depuis vos Outils IA Favoris - Archyl Blog