Pathrule Remote MCP

Conecte um cliente MCP hospedado a https://cloud.pathrule.io/mcp para ler e escrever conhecimento em um espaço de trabalho do Pathrule Cloud. A conexão usa Streamable HTTP e OAuth 2.1 com PKCE. Você precisa de uma conta Pathrule e de acesso ao espaço de trabalho que for aprovar.

Conectar

Crie sua conta ou entre em https://app.pathrule.io e depois conecte seu cliente MCP:

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

No Claude.ai ou em outro cliente MCP via HTTP, use o mesmo endpoint. Conclua o fluxo de autorização e aprove o espaço de trabalho e os escopos que o cliente solicitar.

Descoberta

• MCP: https://cloud.pathrule.io/mcp
• Servidor de autorização: https://cloud.pathrule.io/.well-known/oauth-authorization-server
• Recurso protegido: https://cloud.pathrule.io/.well-known/oauth-protected-resource/mcp

Ferramentas e concessões

Uma concessão de leitura expõe pathrule_get_context e as ferramentas de listagem e leitura de memórias, regras e skills. Uma concessão de escrita também expõe criação, atualização, exclusão e histórico por item. O acesso fica restrito ao espaço de trabalho da concessão; informar o id de outro espaço de trabalho não amplia esse acesso.

As escritas remotas usam title, body e um path canônico. As atualizações usam o id do item e um expectedVersion numérico. Mutações exigem um operation_id estável ou uma chave de idempotência, para que repetir uma operação não crie uma segunda cópia. Esses são schemas remotos, e não os schemas content_edit e expected_version_id do servidor local. Peça tools/list ao servidor conectado antes de usá-los.

O servidor de autorização reconhece pathrule:read, pathrule:write, pathrule:refresh e pathrule:activity. Um escopo reconhecido não significa que exista uma ferramenta correspondente: o catálogo remoto atual cobre conhecimento e contexto. Administração da organização, criação de espaços de trabalho, snapshots, aprendizado local de projetos, importação de padrões, registro de atividades e fluxos de atualização usam o CLI, as ferramentas MCP locais ou o console do Cloud.

As permissões continuam atualizadas

O servidor verifica sua sessão, o estado do espaço de trabalho e sua participação nele tanto ao autorizar o acesso quanto ao executar uma ferramenta. Ser removido de um espaço de trabalho, ou arquivá-lo ou excluí-lo, revoga as concessões dele. Restaurar o espaço de trabalho não reativa essas concessões; conecte-se de novo e aprove o acesso outra vez. Os refresh tokens são rotacionados, e reutilizar um token que já foi rotacionado revoga toda a família desse token.

Entrega local

O Remote MCP não consegue ler seu sistema de arquivos, instalar hooks, escrever arquivos complementares nem enviar preferências pessoais locais. Um agente precisa chamar as ferramentas dele para obter contexto. Use o CLI ou o VS Code quando quiser contexto ciente do repositório e hooks antes que o agente aja.