Pathrule Remote MCP

Connectez un client MCP hébergé à https://cloud.pathrule.io/mcp pour lire et écrire des connaissances dans un espace de travail Pathrule Cloud. Le service repose sur Streamable HTTP et OAuth 2.1 avec PKCE. Il vous faut un compte Pathrule et un accès à l'espace de travail que vous approuvez.

Connexion

Créez votre compte ou connectez-vous sur https://app.pathrule.io, puis connectez votre client MCP :

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

Pour Claude.ai ou tout autre client MCP HTTP, utilisez le même endpoint. Suivez le parcours d'autorisation jusqu'au bout et approuvez l'espace de travail ainsi que les scopes demandés par le client.

Découverte

• MCP : https://cloud.pathrule.io/mcp
• Serveur d'autorisation : https://cloud.pathrule.io/.well-known/oauth-authorization-server
• Ressource protégée : https://cloud.pathrule.io/.well-known/oauth-protected-resource/mcp

Outils et autorisations

Une autorisation de lecture expose pathrule_get_context ainsi que des outils de liste et de lecture pour les mémoires, les règles et les skills. Une autorisation d'écriture expose en plus la création, la mise à jour, la suppression et l'historique de chaque élément. L'accès est limité à l'espace de travail de l'autorisation : fournir l'identifiant d'un autre espace de travail ne permet pas de l'étendre.

Les écritures distantes utilisent title, body et un path canonique. Les mises à jour utilisent l'id d'un élément et un expectedVersion numérique. Les mutations exigent un operation_id stable ou une clé d'idempotence, de sorte qu'une nouvelle tentative ne crée pas de doublon. Ce sont des schémas distants, et non les schémas content_edit et expected_version_id du serveur local. Demandez tools/list au serveur connecté avant de les utiliser.

Le serveur d'autorisation reconnaît pathrule:read, pathrule:write, pathrule:refresh et pathrule:activity. Un scope reconnu ne signifie pas qu'un outil correspondant existe : le catalogue distant actuel couvre les connaissances et le contexte. L'administration de l'organisation, la création d'espaces de travail, les snapshots, l'apprentissage local du projet, l'import de patterns, la journalisation de l'activité et les workflows d'actualisation passent par le CLI, les outils MCP locaux ou la console Cloud.

Des permissions toujours à jour

Le serveur vérifie votre session, l'état de l'espace de travail et votre appartenance au moment où il autorise l'accès et lorsqu'il exécute un outil. Le retrait d'un espace de travail, son archivage ou sa suppression révoque ses autorisations. Restaurer l'espace de travail ne les fait pas revivre : reconnectez-vous et approuvez à nouveau l'accès. Les refresh tokens sont renouvelés à chaque utilisation, et la réutilisation d'un token déjà renouvelé révoque toute sa famille de tokens.

Fourniture locale

Remote MCP ne peut pas lire votre système de fichiers, installer des hooks, écrire des fichiers compagnons ni transmettre vos préférences personnelles locales. Un agent doit appeler ses outils pour obtenir du contexte. Utilisez le CLI ou VS Code si vous voulez un contexte adapté au dépôt et des hooks avant que l'agent n'agisse.