Pathrule Remote MCP

Collega un client MCP ospitato a https://cloud.pathrule.io/mcp per leggere e scrivere conoscenza in un workspace di Pathrule Cloud. Usa Streamable HTTP e OAuth 2.1 con PKCE. Ti servono un account Pathrule e l'accesso al workspace che approvi.

Connessione

Crea il tuo account o accedi su https://app.pathrule.io, poi collega il tuo client MCP:

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

Per Claude.ai o un altro client MCP HTTP usa lo stesso endpoint. Completa il flusso di autorizzazione e approva il workspace e gli scope richiesti dal client.

Discovery

• MCP: https://cloud.pathrule.io/mcp
• Server di autorizzazione: https://cloud.pathrule.io/.well-known/oauth-authorization-server
• Risorsa protetta: https://cloud.pathrule.io/.well-known/oauth-protected-resource/mcp

Strumenti e autorizzazioni

Un'autorizzazione di lettura espone pathrule_get_context e gli strumenti di elenco e lettura per memorie, regole e skill. Un'autorizzazione di scrittura espone anche creazione, aggiornamento, eliminazione e cronologia per singolo elemento. L'accesso è limitato al workspace dell'autorizzazione; indicare l'id di un altro workspace non lo amplia.

Le scritture remote usano title, body e un path canonico. Gli aggiornamenti usano l'id di un elemento e un expectedVersion numerico. Le modifiche richiedono un operation_id stabile o una chiave di idempotenza, così ripetere un'operazione non crea una seconda copia. Questi sono schemi remoti, non gli schemi content_edit ed expected_version_id del server locale. Prima di usarli, chiedi tools/list al server connesso.

Il server di autorizzazione riconosce pathrule:read, pathrule:write, pathrule:refresh e pathrule:activity. Uno scope riconosciuto non implica che esista uno strumento corrispondente: il catalogo remoto attuale copre conoscenza e contesto. Amministrazione dell'organizzazione, creazione di workspace, snapshot, apprendimento locale del progetto, importazione di pattern, registrazione delle attività e flussi di aggiornamento passano dalla CLI, dagli strumenti MCP locali o dalla console Cloud.

I permessi restano aggiornati

Il server verifica la tua sessione, lo stato del workspace e la tua appartenenza sia quando autorizza l'accesso sia quando esegue uno strumento. La rimozione da un workspace, la sua archiviazione o la sua eliminazione ne revocano le autorizzazioni. Ripristinare il workspace non riattiva quelle autorizzazioni: ricollegati e approva di nuovo l'accesso. I refresh token ruotano, e riutilizzare un token già ruotato revoca l'intera famiglia di token.

Distribuzione locale

Remote MCP non può leggere il tuo filesystem, installare hook, scrivere file di supporto né inviare preferenze personali locali. Per ottenere il contesto, un agente deve chiamarne gli strumenti. Usa la CLI o VS Code quando vuoi contesto consapevole del repository e hook prima che l'agente agisca.