Pathrule Remote MCP

Verbinde einen gehosteten MCP-Client mit https://cloud.pathrule.io/mcp, um Wissen in einem Pathrule Cloud Workspace zu lesen und zu schreiben. Die Verbindung nutzt Streamable HTTP und OAuth 2.1 mit PKCE. Du brauchst ein Pathrule-Konto und Zugriff auf den Workspace, den du freigibst.

Verbinden

Lege unter https://app.pathrule.io ein Konto an oder melde dich an. Verbinde dann deinen MCP-Client:

claude mcp add --transport http pathrule https://cloud.pathrule.io/mcp
codex mcp add pathrule --url https://cloud.pathrule.io/mcp

Für Claude.ai oder einen anderen HTTP-MCP-Client verwendest du denselben Endpunkt. Schließe den Autorisierungsablauf ab und gib den Workspace und die Scopes frei, die der Client anfordert.

Discovery

• MCP: https://cloud.pathrule.io/mcp
• Autorisierungsserver: https://cloud.pathrule.io/.well-known/oauth-authorization-server
• Geschützte Ressource: https://cloud.pathrule.io/.well-known/oauth-protected-resource/mcp

Tools und Freigaben

Eine Lesefreigabe stellt pathrule_get_context sowie Listen- und Lese-Tools für Memories, Regeln und Skills bereit. Eine Schreibfreigabe ergänzt Anlegen, Aktualisieren, Löschen und den Verlauf pro Eintrag. Der Zugriff ist auf den Workspace der Freigabe beschränkt; die Angabe einer anderen Workspace-ID kann ihn nicht erweitern.

Schreibvorgänge über Remote MCP verwenden title, body und einen kanonischen path. Aktualisierungen verwenden die id eines Eintrags und eine numerische expectedVersion. Änderungen brauchen eine stabile operation_id oder einen Idempotenzschlüssel, damit ein wiederholter Vorgang keine zweite Kopie erzeugt. Das sind Remote-Schemas, nicht die Schemas content_edit und expected_version_id des lokalen Servers. Frage den verbundenen Server per tools/list ab, bevor du sie verwendest.

Der Autorisierungsserver kennt pathrule:read, pathrule:write, pathrule:refresh und pathrule:activity. Dass ein Scope bekannt ist, heißt nicht, dass es ein passendes Tool gibt: Der aktuelle Remote-Katalog deckt Wissen und Kontext ab. Organisationsverwaltung, das Anlegen von Workspaces, Snapshots, lokales Projektlernen, Pattern-Importe, Aktivitätsprotokollierung und Refresh-Abläufe laufen über die CLI, die lokalen MCP-Tools oder die Cloud-Konsole.

Berechtigungen bleiben aktuell

Der Server prüft deine Session, den Zustand des Workspace und deine Mitgliedschaft, wenn er den Zugriff autorisiert und wenn er ein Tool ausführt. Wirst du aus einem Workspace entfernt oder wird er archiviert oder gelöscht, werden seine Freigaben widerrufen. Wird der Workspace wiederhergestellt, leben diese Freigaben nicht wieder auf; verbinde dich erneut und gib den Zugriff noch einmal frei. Refresh-Tokens rotieren, und wer ein bereits rotiertes Token erneut einsetzt, widerruft damit dessen gesamte Token-Familie.

Lokale Bereitstellung

Remote MCP kann weder dein Dateisystem lesen noch Hooks installieren, Begleitdateien schreiben oder lokale persönliche Präferenzen senden. Ein Agent muss die Tools aufrufen, um Kontext zu bekommen. Nutze die CLI oder VS Code, wenn du repository-bezogenen Kontext und Hooks schon vor dem Handeln des Agents haben willst.