MCP-Server: Sprechen Sie mit Ihrer Architektur aus Ihren Lieblings-KI-Tools - Archyl Blog

Wir haben gerade das Feature veröffentlicht, das mich am meisten begeistert: Ein MCP-Server, mit dem Sie Ihre Architekturdokumentation direkt aus Claude Code, Cursor oder jedem MCP-kompatiblen KI-Assistenten abfragen und ändern können. Hier erfahren Sie, warum das alles verändert.

MCP-Server: Sprechen Sie mit Ihrer Architektur aus Ihren Lieblings-KI-Tools

Ich nutze KI-Codierassistenten seit über einem Jahr täglich. Claude Code für komplexe Refaktorisierungen, Cursor für schnelle Änderungen, GitHub Copilot für Autovervollständigung. Aber es gab immer eine frustrierende Lücke: Diese Tools konnten meine Architekturdokumentation nicht sehen.

Jedes Mal, wenn ich Claude bat, "einen neuen Endpoint zum Payment-Service hinzuzufügen", riet er. Er wusste nicht, dass unser Payment-Service mit Stripe kommuniziert, Redis für Caching verwendet und spezifische Sicherheitsanforderungen hat, die in unseren ADRs dokumentiert sind. Ich verbrachte mehr Zeit damit, die KI zu korrigieren, als selbst Code zu schreiben.

Heute schließen wir diese Lücke. Archyl stellt jetzt einen vollständigen MCP-Server (Model Context Protocol) mit 56 Tools bereit, die KI-Assistenten vollständige Sichtbarkeit auf Ihre Architektur geben.

Was ist MCP?

Das Model Context Protocol ist Anthropics offener Standard zur Verbindung von KI-Assistenten mit externen Tools und Datenquellen. Denken Sie daran wie einen universellen Adapter zwischen LLMs und den Systemen, mit denen sie interagieren müssen.

Anstatt Kontext in Prompts zu kopieren, ermöglicht MCP KI-Assistenten, Ihre Tools direkt abzufragen. Sie können Daten lesen, Aktionen ausführen und mit Ihren tatsächlichen Systemen synchronisiert bleiben.

Und der MCP-Server von Archyl bedeutet, dass Ihre Architekturdokumentation zu einer erstklassigen Datenquelle für jeden KI-Assistenten wird.

Was Können Sie Damit Machen?

Hier wird es spannend. Mit dem Archyl MCP-Server kann Ihr KI-Assistent:

Ihre Architektur Abfragen

Stellen Sie natürliche Fragen und erhalten Sie echte Antworten:

  • "Welche Elemente sind mit dem Payment Processor System verbunden?"
  • "Von welchen Containern hängt der User Service ab?"
  • "Zeige mir alle Systeme, die mit unserer PostgreSQL-Datenbank interagieren"
  • "Welche ADRs betreffen den Authentifizierungsfluss?"

Die KI rät nicht. Sie fragt Ihre tatsächlich dokumentierte Architektur ab und liefert präzise, strukturierte Informationen.

Claude Code fragt Architektur über MCP ab

Das C4-Modell Navigieren

Ihre KI versteht die vollständige Hierarchie:

  • Alle Projekte in Ihrer Organisation auflisten
  • Von Systemen zu Containern zu Komponenten hinuntersteigen
  • Beziehungen und Abhängigkeiten erkunden
  • Den Technologie-Stack auf jeder Ebene verstehen

Wenn Sie fragen "welche Technologien verwendet der Order Service?", gibt die KI den tatsächlich dokumentierten Stack zurück, keine halluzinierte Vermutung.

Dokumentation Ändern

Das ist das Killer-Feature. Der MCP-Server unterstützt Schreiboperationen:

  • Neue Systeme, Container und Komponenten erstellen
  • Beziehungen zwischen Elementen hinzufügen
  • ADRs erstellen und aktualisieren
  • Projektdokumentation schreiben
  • Benutzerflüsse definieren

Bitten Sie Claude, "den neuen Benachrichtigungsdienst zu dokumentieren, den wir gerade gebaut haben" und er kann die C4-Elemente erstellen, sie mit bestehenden Systemen verknüpfen und sogar einen ADR entwerfen, der die Designentscheidung erklärt.

Synchron Bleiben

Die KI sieht immer den neuesten Stand. Kein veralteter Kontext, keine überholte Dokumentation. Wenn Ihr Teamkollege die Architektur aktualisiert, sieht Ihr KI-Assistent es sofort.

56 Tools, Eine Integration

Wir haben keinen minimalen Proof-of-Concept gebaut. Der MCP-Server bietet umfassende Funktionalität:

Projekte & Einstellungen: Projekte auflisten, abrufen und verwalten. KI-Anbieter und Discovery-Einstellungen konfigurieren.

C4-Modell (Alle 4 Ebenen): Vollständiges CRUD für Systeme, Container, Komponenten und Code-Elemente. Beziehungen erstellen, Overlays verwalten, die vollständige Modellhierarchie handhaben.

Dokumentation: Architekturdokumentation erstellen und aktualisieren. Docs mit spezifischen C4-Elementen verknüpfen.

ADRs: Vollständiges Architecture Decision Record Management. ADRs erstellen, aktualisieren, auflisten und mit den betroffenen Elementen verknüpfen.

Benutzerflüsse: Benutzerreisen durch Ihr System definieren und visualisieren.

Discovery: KI-gestützte Architekturentdeckung auf Ihren verbundenen Repositories auslösen.

Teams: Teamstruktur und Projektzugriff abfragen.

Jedes Tool gibt strukturierte Daten zurück, über die KI-Assistenten nachdenken können. Kein HTML-Parsing, kein UI-Scraping, keine fragilen Integrationen.

In 2 Minuten Starten

So verbinden Sie Claude Code (oder jedes MCP-kompatible Tool):

Schritt 1: API-Schlüssel Erstellen

Gehen Sie zu Ihrem Archyl-Profil, klicken Sie auf "API-Schlüssel" und erstellen Sie einen neuen Schlüssel. Geben Sie ihm einen beschreibenden Namen wie "Claude Code" und wählen Sie die benötigten Scopes (nur Lesen oder Vollzugriff).

Kopieren Sie den Schlüssel sofort — Sie werden ihn nicht wieder sehen.

Schritt 2: Ihren MCP-Client Konfigurieren

Fügen Sie Archyl zu Ihrer MCP-Konfiguration hinzu. Für Claude Code fügen Sie dies zu Ihren Einstellungen hinzu:

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

Schritt 3: Beginnen Sie, mit Ihrer Architektur zu Sprechen

Das war's. Fragen Sie Ihren KI-Assistenten nach Ihrer Architektur und beobachten Sie, wie er echte Daten von Archyl abruft.

Probieren Sie diese Prompts:

  • "Liste alle meine Archyl-Projekte"
  • "Welche Systeme existieren im E-commerce Platform Projekt?"
  • "Zeige mir die Beziehungen für das Payment Gateway"
  • "Erstelle einen neuen ADR, der erklärt, warum wir PostgreSQL gewählt haben"

Warum Das Wichtig Ist

Architekturdokumentation hatte immer ein Auffindbarkeits-Problem. Sie schreiben sie, sie lebt irgendwo in einem Wiki oder einem Diagramm, und dann liest sie niemand. Ingenieure stellen Fragen in Slack, anstatt die Dokumentation zu prüfen.

MCP ändert das Interaktionsmodell. Dokumentation ist nicht etwas, das Sie lesen gehen — es ist etwas, das Ihr KI-Assistent kennt. Wenn Sie fragen "wie funktioniert die Zahlungsverarbeitung?", kommt die Antwort von Ihrer tatsächlichen Architektur, nicht aus den Trainingsdaten der KI.

Das hat tiefgreifende Implikationen:

Onboarding wird sofort. Neue Ingenieure fragen ihre KI nach der Systemarchitektur und bekommen vom ersten Tag an genaue Antworten.

Kontext ist immer verfügbar. Beim Schreiben von Code weiß die KI genau, welche Services existieren, wie sie verbunden sind und welche Entscheidungen sie geprägt haben.

Dokumentation bleibt aktuell. Weil sie aktiv genutzt wird, werden Ungenauigkeiten bemerkt und behoben. Tote Dokumentation ist Dokumentation, die niemand liest.

KI-Vorschläge sind fundiert. Wenn Claude ein Design vorschlägt, ist es durch Ihre tatsächliche Architektur informiert, nicht durch generische Muster.

Das Größere Bild

Wir betreten eine Ära, in der KI-Assistenten echte Mitarbeiter in der Softwareentwicklung sind. Aber sie sind nur so gut wie der Kontext, auf den sie Zugriff haben.

Die meisten KI-Interaktionen heute sind kontextarm. Sie fügen etwas Code ein, fügen eine kurze Beschreibung hinzu und hoffen, dass die KI den Rest herausfindet. Die Ergebnisse sind mittelmäßig, weil die KI blind arbeitet.

MCP-gestützte Integrationen kehren dieses Modell um. Ihre KI hat persistenten, abfragbaren Zugriff auf alles, was sie braucht: Ihren Code (über Repository-Integration), Ihre Architektur (über Archyl), Ihre Issues (über Jira/Linear-Integrationen), Ihre Dokumentation (über Notion/Confluence-Integrationen).

Die KI wird ein echtes Teammitglied mit Zugriff auf das Teamwissen.

Der MCP-Server von Archyl ist unser Beitrag zu dieser Vision. Ihre Architektur sollte nicht in einem Diagramm-Tool eingeschlossen sein. Sie sollte für jedes Tool zugänglich sein, das Ihr Team nutzt, einschließlich Ihrer KI-Assistenten.

Was Kommt Als Nächstes?

Das ist Version 1. Hier ist, was wir als Nächstes bauen:

Proaktive Vorschläge: Der MCP-Server könnte Architekturänderungen überwachen und Dokumentationsaktualisierungen vorschlagen.

Querverweise: ADRs mit spezifischen Commits verbinden, Dokumentation mit CI/CD-Events verknüpfen, ein Netz von vernetztem Wissen erstellen.

Benutzerdefinierte Abfragen: Organisationsspezifische Abfragen definieren wie "zeige mir alle Services, die dem Zahlungsteam gehören."

Audit-Logging: Jede MCP-Interaktion für Compliance und Debugging verfolgen.

Jetzt Ausprobieren

Der MCP-Server ist heute in allen Archyl-Plänen verfügbar. Wenn Sie bereits Claude Code, Cursor oder ein anderes MCP-kompatibles Tool verwenden, können Sie sich in Minuten verbinden.

Erstellen Sie einen API-Schlüssel, fügen Sie die Konfiguration hinzu und beginnen Sie, mit Ihrer Architektur zu sprechen.

Und wenn Sie Archyl noch nicht nutzen, registrieren Sie sich kostenlos und sehen Sie, wie KI-gestützte Architekturdokumentation funktioniert. Verbinden Sie ein Repository, führen Sie die Entdeckung aus und verbinden Sie dann Ihren bevorzugten KI-Assistenten.

Ihre Architektur ist zu wichtig, um in statischen Diagrammen eingeschlossen zu sein. Lassen Sie Ihre KI-Assistenten sie erkunden.

Möchten Sie mehr über die KI-Fähigkeiten von Archyl erfahren? Lesen Sie unseren Beitrag über KI-gestützte Architekturentdeckung oder beginnen Sie mit den Grundlagen in unserer Einführung in das C4-Modell.