MCP-Überblick

Pathrule spricht das Model Context Protocol. Über dieses Protokoll ruft dein KI-Coding-Assistent externe Tools auf und liest externen Zustand. Für den Assistenten erscheint Pathrule als ganz normaler MCP-Server, daher kann jeder Client, der MCP spricht, ihn nutzen.

Es gibt zwei Wege, sich zu verbinden. Der lokale Server kommt mit der Pathrule CLI und der Pathrule VS Code-Erweiterung: Der Assistent kommuniziert mit ihm über stdio, und in einem Cloud-Workspace spricht die Runtime über HTTPS mit Pathrule Cloud. Für Clients, die sich mit gehosteten Servern verbinden, nimmt Remote MCP eine direkte Verbindung über Streamable HTTP an, mit OAuth-Anmeldung und eingeschränktem Zugriff auf deinen Workspace. Lokales stdio und Remote MCP haben unterschiedliche Tool-Kataloge und Schemas. Prüfe tools/list auf dem verbundenen Server. Pathrule lädt den Quellcode deines Repositorys nicht automatisch hoch; lokale Tools zum Lernen aus dem Projekt können Dateien untersuchen, die an eine Erkenntnis angehängt sind, um sie zu validieren.

Was der Server bereitstellt

Die MCP-Oberfläche von Pathrule ist typisiert und am Datenmodell ausgerichtet. Die zentralen Tools unten decken die alltäglichen Abläufe für Kontext, Inhalte und Aktivität ab; die MCP-Tools-Referenz ist das maßgebliche Verzeichnis.

Der lokale Server bietet seinen kompletten Satz, Lese- wie Schreib-Tools, schon beim ersten tools/list an. Vor dem ersten Schreibvorgang muss also nichts freigeschaltet werden, und die Liste ändert sich während der Session nicht. Ein Lazy-Modus, der Schreib-Tools zurückhält, bis sie gebraucht werden, lässt sich optional aktivieren; siehe Lokale Lazy-Write-Steuerung.

Lese-Tools

• pathrule_get_context. Der primäre Einstiegspunkt. Anhand des aktuellen Arbeitsverzeichnisses und der Absicht des Nutzers liefert es den passenden Ausschnitt an Memories, Regeln und Skills für diesen Pfad. Die Antwort enthält den Workspace-Überblick, die bereits passenden Regeln und Memories sowie einen Hinweis, was als Nächstes zu lesen ist.
• pathrule_read_memory, pathrule_read_rule, pathrule_read_skill. Rufen den vollständigen Inhalt eines bestimmten Knotens per ID ab, wenn der Assistent ihn zitieren oder befolgen will.
• pathrule_get_tree, pathrule_get_node. Untersuchen die Workspace-Struktur oder einen bestimmten Knoten.
• pathrule_list_memories. Listet die Memories unter einem Pfad auf, nützlich für explorative Prompts.

Schreib-Tools

• pathrule_write_memory, pathrule_write_rule, pathrule_write_skill. Legen Inhalte an einem Workspace-Pfad an. Fehlende Knoten entlang des Pfads werden bei Bedarf erzeugt.
• pathrule_update_memory, pathrule_update_rule, pathrule_update_skill. Bearbeiten einen bestehenden Eintrag. Optimistische Nebenläufigkeitskontrolle wird über eine Versions-ID durchgesetzt.
• pathrule_delete_memory, pathrule_delete_rule, pathrule_delete_skill. Soft Delete mit einem dreißigtägigen Zeitfenster zum Rückgängigmachen.

Aktivität und Verwaltung

• pathrule_log_activity. Wird nach jeder Antwort aufgerufen, die Dateien verändert, damit das Team sieht, was der Assistent wo getan hat.
• pathrule_goto. Verschiebt den Arbeitsknoten des Assistenten, wenn der Nutzer Inhalte aus einem anderen Bereich anfordert.
• pathrule_ping. Ein Health Check, der bestätigt, dass der Server richtig angebunden ist, und zeigt, wie die Runtime das Arbeitsverzeichnis sieht.

Wie Hooks ins Bild passen

Auf Clients, die Hooks unterstützen, sorgen Hooks dafür, dass der Assistent mit Pathrule schnell bleibt. Beim Start der Session und rund um Tool-Aufrufe liest der Hook-Supervisor einen zwischengespeicherten Ausschnitt für das aktuelle Arbeitsverzeichnis und übergibt ihn dem Agent als Kontext. So entfällt im Normalfall ein synchroner MCP-Roundtrip. Der Session-Start-Hook liefert außerdem das Pathrule-Protokoll selbst aus, sodass die Anweisungsdatei in deinem Repo auf einem Hook-fähigen Client eine kurze Notiz bleibt.

Nicht jeder Client wird auf dieselbe Weise erreicht:

• Claude Code und Codex haben Hooks einschließlich eines Prompt-Submit-Hooks, sodass das relevante Wissen mit jedem Prompt ankommt, bevor der Agent handelt.
• Cursor und GitHub Copilot haben Session- und Tool-Hooks, aber keinen Prompt-Submit-Hook. Kontext kommt beim Start der Session und rund um Tool-Aufrufe an.
• Windsurf hat keine Hooks. Es liest beim Start der Session eine Pathrule-Regeldatei und nutzt für alles Tiefergehende die MCP-Tools.

Wenn der Hook ausreicht, muss der Assistent pathrule_get_context nicht aufrufen. Er hat den passenden Ausschnitt bereits. MCP-Tools sind für zwei Szenarien gedacht.

1. Der Assistent braucht mehr, als der Hook geliefert hat. Zum Beispiel ein explorativer Prompt, der den vollständigen Inhalt einer Memory benötigt, oder ein Refactoring, das einen Pfad berührt, mit dem der Hook nicht gerechnet hat.
2. Etwas ist es wert, festgehalten zu werden. Der Assistent schlägt eine Memory, Regel oder einen Skill vor und schreibt sie, sobald du bestätigst, oder du bittest ihn direkt darum. Schreibvorgänge laufen über die Schreib-Tools, und jeder wird als vom Assistenten geschrieben markiert und versioniert, sodass du ihn prüfen oder rückgängig machen kannst.

Unter So funktionieren Hooks findest du die zugrunde liegende Mechanik.

Agent-Integrationen

Pathrule ist die Intelligenzschicht; dein Coding-Agent bleibt die ausführende Instanz und behält seinen eigenen Modellanbieter. Die CLI und die VS Code-Erweiterung verbinden die Agents, die du bereits nutzt, über die jeweils unterstützten Hooks, Anweisungsdateien und MCP mit demselben Workspace.

• Claude Code und Codex: Hooks einschließlich eines Prompt-Submit-Hooks, Anweisungsdateien und der lokale MCP-Server. Beide können sich zusätzlich mit Remote MCP verbinden.
• Cursor und GitHub Copilot: Session- und Tool-Hooks, Anweisungsdateien und der lokale MCP-Server. Die VS Code-Erweiterung registriert den Server für den Agent-Modus von Copilot.
• Windsurf: eine Pathrule-Regeldatei und der lokale MCP-Server, ohne Hooks.
• Jeder andere MCP-Client: verbindet sich über stdio. Füge den Pathrule MCP-Befehl zur Konfiguration deines Clients hinzu, dann sieht er dieselbe Tool-Oberfläche.
• Clients, die sich mit gehosteten Servern verbinden: Richte sie auf Remote MCP über Streamable HTTP aus und melde dich mit OAuth an. Remote MCP installiert keine Hooks und schreibt keine lokalen Dateien.

Weiterlesen

• So funktionieren Hooks: was zwischen Cache und Editor passiert.
• Kernkonzepte: das Datenmodell, auf dem die Tools arbeiten.
• CLI installieren: die Runtime einrichten, die den Server bereitstellt.