Pathrule Remote

Contexto de codificación de IA para Claude Code, Cursor y Codex

Documentación

Pathrule Remote MCP

Pathrule Remote MCP expone la memoria del espacio de trabajo de Pathrule, reglas, habilidades, configuración, instantáneas y registro de actividad a través del Model Context Protocol.

Endpoint público:

https://mcp.pathrule.io/mcp

Manifiesto del registro:

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

Qué Hace

Pathrule proporciona a los agentes de codificación de IA contexto de proyecto con alcance por ruta. El servidor MCP remoto permite que los clientes MCP en la nube usen los mismos datos del espacio de trabajo de Pathrule sin instalar Pathrule Desktop ni la CLI local en el host del cliente.

Remote MCP es intencionalmente solo en la nube. Puede leer y escribir registros en la nube de Pathrule, pero no puede leer archivos locales, instalar hooks, renderizar AGENTS.md / CLAUDE.md ni materializar habilidades locales. Para esas funciones de tiempo de ejecución local, use Pathrule Desktop o @pathrule/cli.

Uso de Pathrule Remote MCP

Pathrule Remote MCP es el endpoint MCP para los espacios de trabajo de Pathrule Web. No es un servicio de memoria alojado de propósito general que funcione sin Pathrule.

Para usarlo:

  1. Cree o inicie sesión en una cuenta de Pathrule:
https://app.pathrule.io
  1. Cree o seleccione un espacio de trabajo de Pathrule en la aplicación.

  2. Conecte su cliente MCP a:

https://mcp.pathrule.io/mcp

Cuando un cliente MCP se conecta, inicia un flujo OAuth a través de Pathrule Web. Después de la aprobación, el cliente solo puede acceder a los espacios de trabajo de Pathrule visibles para esa cuenta con sesión iniciada, utilizando los alcances que usted aprobó.

Este repositorio es la fuente pública y el destino de listado de directorio para el endpoint Remote MCP de Pathrule. No es una base de datos de memoria local independiente y no crea un espacio de trabajo de Pathrule utilizable sin una cuenta de Pathrule.

Herramientas

Espacio de trabajo y 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

Configuración del espacio de trabajo:

  • pathrule_list_organizations
  • pathrule_create_workspace
  • pathrule_setup

Escrituras:

  • 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

Instantáneas, actualizaciones y actividad:

  • 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 Seguridad

  • Los alcances de OAuth determinan la superficie de herramientas. Las herramientas de lectura requieren pathrule:read; las herramientas de escritura requieren pathrule:write; las herramientas de actualización/actividad requieren pathrule:activity.
  • Cada operación del espacio de trabajo se ejecuta a través del JWT de Supabase del usuario autenticado y las políticas RLS de la base de datos.
  • El conector no utiliza claves de administrador de Supabase para ampliar el acceso de los usuarios.
  • Las herramientas de escritura también están limitadas por el estado de suscripción del espacio de trabajo y los límites de velocidad por usuario/por espacio de trabajo.
  • La telemetría de eventos MCP es solo de metadatos: nombre de la herramienta, identificadores de usuario/espacio de trabajo/cliente, código de estado/error y rango de latencia. Las entradas de herramientas y los cuerpos de contenido no se registran.
  • El servidor remoto nunca accede al sistema de archivos del usuario y nunca escribe archivos complementarios locales.

Notas del Operador

El servicio mcp.pathrule.io es operado por Pathrule. Las variables de entorno a continuación son para los operadores de Pathrule que implementan el servicio contra el backend de Pathrule. No son necesarias para conectar un cliente MCP a Pathrule Remote MCP.

Los secretos de producción requeridos son solo variables de entorno. No confirme 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 se utiliza para firmar JWT de usuario con rol autenticado de corta duración para Supabase RLS. Trátelo como material secreto de infraestructura de producción y guárdelo únicamente en el administrador de secretos del proveedor de alojamiento.

Ejecución del Servidor

El repositorio público pathrule/mcp se prepara a partir del monorepo de Pathrule y contiene un servidor Node.js empaquetado para transparencia y reproducibilidad de implementación. Ejecutarlo usted mismo requiere las variables de entorno anteriores y el backend compatible de Pathrule; no es la ruta de configuración de usuario recomendada.

npm install
npm start

El servidor escucha en PORT y HOST:

PORT=8787
HOST=0.0.0.0

Salud y metadatos:

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

Inspección del Registro

El repositorio público incluye un Dockerfile para escáneres de registro MCP como Glama. El contenedor establece PATHRULE_MCP_PUBLIC_INTROSPECTION=1, que expone la introspección del esquema MCP sin un token de portador para que los registros puedan verificar la forma del servidor.

Ese modo no otorga acceso a los datos de Pathrule. Las llamadas a herramientas aún requieren un contexto de Pathrule autenticado y devuelven errores de autenticación sin OAuth.

El ejecutor de compilación Docker de Glama inicia servidores MCP a través de stdio. Use este comando en el formulario de administración del Dockerfile de Glama:

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

Envío al Directorio MCP

Use estos campos para los directorios 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

Licencia

MIT