Panoramica di MCP

Pathrule parla il Model Context Protocol, il protocollo con cui il tuo assistente di programmazione IA richiama strumenti esterni e legge stato esterno. Per l'assistente, Pathrule è un normale server MCP, quindi qualsiasi client che parli MCP può usarlo.

Ci sono due modi per collegarsi. Il server locale è incluso in Pathrule CLI e nell'estensione Pathrule per VS Code: l'assistente comunica con lui su stdio e, in un workspace Cloud, il runtime comunica con Pathrule Cloud su HTTPS. Per i client che si collegano a server ospitati, Remote MCP accetta una connessione diretta su Streamable HTTP con accesso tramite OAuth e un accesso limitato al tuo workspace. Lo stdio locale e Remote MCP hanno cataloghi di strumenti e schemi diversi: controlla tools/list sul server a cui sei collegato. Pathrule non carica automaticamente il codice sorgente del tuo repository; gli strumenti locali di apprendimento del progetto possono esaminare i file allegati a una conclusione per validarla.

Cosa espone il server

La superficie MCP di Pathrule è tipizzata e organizzata attorno al modello dei dati. Gli strumenti principali qui sotto coprono i flussi quotidiani di contesto, contenuti e attività; l'inventario di riferimento è il riferimento degli strumenti.

Il server locale annuncia l'intero set di strumenti, di lettura e di scrittura, fin dalla prima tools/list: non c'è nulla da sbloccare prima della prima scrittura e l'elenco non cambia a metà sessione. Come opzione è disponibile una modalità lazy che tiene da parte gli strumenti di scrittura finché non servono; vedi Controllo locale della scrittura lazy.

Strumenti di lettura

• pathrule_get_context. Il punto di ingresso principale. A partire dalla directory di lavoro corrente e dall'intento dell'utente, restituisce la porzione giusta di memorie, regole e skill per quel percorso. La risposta contiene la panoramica del workspace, le regole e le memorie già pertinenti e un suggerimento su cosa leggere dopo.
• pathrule_read_memory, pathrule_read_rule, pathrule_read_skill. Recuperano tramite id il contenuto completo di un nodo specifico, quando l'assistente vuole citarlo o seguirlo.
• pathrule_get_tree, pathrule_get_node. Esaminano la struttura del workspace o un nodo specifico.
• pathrule_list_memories. Elenca le memorie sotto un percorso, utile per i prompt di esplorazione.

Strumenti di scrittura

• pathrule_write_memory, pathrule_write_rule, pathrule_write_skill. Creano contenuti in un percorso del workspace. I nodi mancanti lungo il percorso vengono creati al momento.
• pathrule_update_memory, pathrule_update_rule, pathrule_update_skill. Modificano un record esistente. La concorrenza ottimistica è garantita da un id di versione.
• pathrule_delete_memory, pathrule_delete_rule, pathrule_delete_skill. Eliminazione logica con una finestra di trenta giorni per annullarla.

Attività e manutenzione

• pathrule_log_activity. Viene chiamato dopo ogni risposta che modifica file, così il team può vedere cosa ha fatto l'assistente e dove.
• pathrule_goto. Sposta il nodo di lavoro dell'assistente quando l'utente chiede contenuti da un ambito diverso.
• pathrule_ping. Un controllo di stato che conferma che il server è collegato correttamente e mostra la directory di lavoro vista dal runtime.

Il ruolo degli hook

Sui client che supportano gli hook, sono proprio gli hook a mantenere rapido l'assistente. All'avvio della sessione e attorno alle chiamate agli strumenti, il supervisore degli hook legge una porzione in cache per la directory di lavoro corrente e la passa all'agente come contesto. Nel caso comune si evita così un round trip MCP sincrono. L'hook di avvio sessione consegna anche il protocollo Pathrule stesso, quindi su un client che supporta gli hook il file di istruzioni nel tuo repo resta una breve nota.

Non tutti i client vengono raggiunti allo stesso modo:

• Claude Code e Codex hanno hook che includono un hook all'invio del prompt, quindi la conoscenza pertinente arriva con ogni prompt, prima che l'agente agisca.
• Cursor e GitHub Copilot hanno hook di sessione e degli strumenti, ma nessun hook all'invio del prompt. Il contesto arriva all'avvio della sessione e attorno alle chiamate agli strumenti.
• Windsurf non ha hook. Legge un file di regole Pathrule all'avvio della sessione e usa gli strumenti MCP per tutto ciò che richiede più profondità.

Quando l'hook basta, l'assistente non ha bisogno di chiamare pathrule_get_context: ha già la porzione giusta. Gli strumenti MCP sono riservati a due scenari.

1. L'assistente vuole più di quanto ha fatto emergere l'hook. Per esempio, un prompt di esplorazione che richiede il contenuto completo di una memoria, o un refactoring che tocca un percorso che l'hook non aveva previsto.
2. C'è qualcosa che vale la pena conservare. L'assistente propone una memoria, una regola o una skill e la scrive dopo la tua conferma, oppure sei tu a chiedergli di scriverla direttamente. Le scritture passano dagli strumenti di scrittura e ognuna viene contrassegnata come scritta dall'assistente e versionata, così puoi rivederla o annullarla.

Per i meccanismi sottostanti, vedi Come funzionano gli hook.

Integrazioni con gli agenti

Pathrule è il livello di intelligenza; il tuo agente di programmazione resta il motore di esecuzione e mantiene il proprio fornitore di modelli. La CLI e l'estensione per VS Code collegano gli agenti che già usi allo stesso workspace tramite gli hook, i file di istruzioni e MCP supportati da ciascun client.

• Claude Code e Codex: hook che includono un hook all'invio del prompt, file di istruzioni e il server MCP locale. Entrambi possono collegarsi anche a Remote MCP.
• Cursor e GitHub Copilot: hook di sessione e degli strumenti, file di istruzioni e il server MCP locale. L'estensione per VS Code registra il server per la modalità agente di Copilot.
• Windsurf: un file di regole Pathrule e il server MCP locale, senza hook.
• Qualsiasi altro client MCP: si collega su stdio. Aggiungi il comando MCP di Pathrule alla configurazione del tuo client e vedrà la stessa superficie di strumenti.
• Client che si collegano a server ospitati: puntali a Remote MCP su Streamable HTTP e accedi con OAuth. Remote MCP non installa hook e non scrive file locali.

Cosa leggere dopo

• Come funzionano gli hook per capire cosa succede tra la cache e l'editor.
• Concetti fondamentali per il modello dei dati su cui operano gli strumenti.
• Installazione della CLI per configurare il runtime che ospita il server.