Pathrule Remote

Contexto de codificação de IA para Claude Code, Cursor e Codex

GitHub
1
Experimente este MCPPatrocinado

Documentação

Pathrule Remote MCP

O Pathrule Remote MCP expõe memória do workspace Pathrule, regras, skills, configuração, snapshots e registro de atividades através do Model Context Protocol.

Endpoint público:

https://mcp.pathrule.io/mcp

Manifesto de registro:

https://mcp.pathrule.io/server.json

O Que Ele Faz

O Pathrule fornece a agentes de IA de codificação contexto de projeto com escopo por caminho. O servidor MCP remoto permite que clientes MCP na nuvem usem os mesmos dados de workspace do Pathrule sem instalar o Pathrule Desktop ou o CLI local no host do cliente.

O MCP remoto é intencionalmente somente nuvem. Ele pode ler e gravar registros na nuvem do Pathrule, mas não pode ler arquivos locais, instalar hooks, renderizar AGENTS.md / CLAUDE.md ou materializar skills locais. Para esses recursos de runtime local, use o Pathrule Desktop ou @pathrule/cli.

Usando o Pathrule Remote MCP

O Pathrule Remote MCP é o endpoint MCP para workspaces do Pathrule Web. Não é um serviço de memória hospedado de propósito geral que funciona sem o Pathrule.

Para usá-lo:

  1. Crie ou entre em uma conta Pathrule:
https://app.pathrule.io

  1. Crie ou selecione um workspace Pathrule no aplicativo.

  2. Conecte seu cliente MCP a:

https://mcp.pathrule.io/mcp

Quando um cliente MCP se conecta, ele inicia um fluxo OAuth através do Pathrule Web. Após a aprovação, o cliente pode acessar apenas os workspaces Pathrule visíveis para aquela conta conectada, usando os escopos que você aprovou.

Este repositório é a fonte pública e o alvo de listagem de diretório para o endpoint MCP remoto do Pathrule. Não é um banco de dados de memória local independente e não cria um workspace Pathrule utilizável sem uma conta Pathrule.

Ferramentas

Workspace e contexto:

  • pathrule_list_workspaces
  • pathrule_get_context
  • pathrule_goto
  • pathrule_get_tree
  • pathrule_get_node
  • pathrule_list_memories
  • pathrule_read_memory
  • pathrule_read_rule
  • pathrule_read_skill
  • pathrule_ping

Configuração do workspace:

  • pathrule_list_organizations
  • pathrule_create_workspace
  • pathrule_setup

Gravações:

  • pathrule_write_memory
  • pathrule_update_memory
  • pathrule_delete_memory
  • pathrule_write_rule
  • pathrule_update_rule
  • pathrule_delete_rule
  • pathrule_write_skill
  • pathrule_update_skill
  • pathrule_delete_skill

Snapshots, atualizações e atividades:

  • pathrule_take_snapshot
  • pathrule_list_snapshots
  • pathrule_read_snapshot
  • pathrule_list_pending_refreshes
  • pathrule_get_refresh_brief
  • pathrule_resolve_refresh
  • pathrule_log_activity
  • pathrule_get_local_runtime_upgrade

Modelo de Segurança

  • Os escopos OAuth determinam a superfície das ferramentas. Ferramentas de leitura exigem pathrule:read; ferramentas de gravação exigem pathrule:write; ferramentas de atualização/atividade exigem pathrule:activity.
  • Cada operação de workspace passa pelo JWT Supabase do usuário autenticado e pelas políticas RLS do banco de dados.
  • O conector não usa chaves de administrador Supabase para ampliar o acesso do usuário.
  • Ferramentas de gravação também são limitadas pelo status de assinatura do workspace e por limites de taxa por usuário/workspace.
  • A telemetria de eventos MCP contém apenas metadados: nome da ferramenta, identificadores de usuário/workspace/cliente, status/código de erro e faixa de latência. Entradas de ferramentas e corpos de conteúdo não são registrados.
  • O servidor remoto nunca acessa o sistema de arquivos do usuário e nunca grava arquivos complementares locais.

Notas do Operador

O serviço mcp.pathrule.io é operado pela Pathrule. As variáveis de ambiente abaixo são para operadores da Pathrule que implantam o serviço contra o backend da Pathrule. Elas não são necessárias para conectar um cliente MCP ao Pathrule Remote MCP.

Segredos de produção obrigatórios são apenas variáveis de ambiente. Não faça commit de valores para:

SUPABASE_URL
SUPABASE_ANON_KEY
SUPABASE_JWT_SECRET
PATHRULE_CONNECTOR_TOKEN_ENCRYPTION_KEY
PATHRULE_CONNECTOR_TOKEN_ENCRYPTION_KEY_VERSION
PATHRULE_CONNECTOR_TOKEN_ENCRYPTION_PREVIOUS_KEYS
PATHRULE_WEB_ORIGIN

SUPABASE_JWT_SECRET é usado para assinar JWTs de usuário de curta duração com função autenticada para RLS do Supabase. Trate-o como material de segredo de infraestrutura de produção e armazene-o apenas no gerenciador de segredos do provedor de hospedagem.

Executando o Servidor

O repositório público pathrule/mcp é preparado a partir do monorepo Pathrule e contém um servidor Node.js empacotado para transparência e reprodutibilidade de implantação. Executá-lo você mesmo exige as variáveis de ambiente acima e o backend compatível da Pathrule; não é o caminho de configuração recomendado para usuários.

npm install
npm start

O servidor escuta em PORT e HOST:

PORT=8787
HOST=0.0.0.0

Saúde e metadados:

curl -fsS http://localhost:8787/healthz
curl -fsS http://localhost:8787/server.json

Inspeção de Registro

O repositório público inclui um Dockerfile para scanners de registro MCP, como o Glama. O contêiner define PATHRULE_MCP_PUBLIC_INTROSPECTION=1, que expõe introspecção de esquema MCP sem token de portador, para que registros possam verificar a forma do servidor.

Esse modo não concede acesso a dados do Pathrule. Chamadas de ferramentas ainda exigem um contexto Pathrule autenticado e retornam erros de autenticação sem OAuth.

O executor de build Docker do Glama inicia servidores MCP via stdio. Use este comando no formulário de administração do Dockerfile do Glama:

["node", "dist/glama-stdio.js"]

Envio para Diretório MCP

Use estes campos para diretórios MCP:

GitHub Repository URL: https://github.com/pathrule/mcp
npm Package: leave blank unless @pathrule/mcp is published
Short Description: Path-scoped team memories, rules and skills for AI coding agents.
Server URL: https://mcp.pathrule.io/mcp

Licença

MIT