Saltar al contenido
Pathrule

documentación

Pathrule Remote MCP

Conecta un cliente MCP por HTTP a tu espacio de trabajo de Cloud en cloud.pathrule.io/mcp. Acceso al conocimiento delimitado por OAuth, sin instalación local y con límites explícitos de herramientas y sistema de archivos.

En esta página

Conecta un cliente MCP alojado a https://cloud.pathrule.io/mcp para leer y escribir conocimiento en un espacio de trabajo de Pathrule Cloud. Usa Streamable HTTP y OAuth 2.1 con PKCE. Necesitas una cuenta de Pathrule y acceso al espacio de trabajo que apruebes.

Conectar

Crea tu cuenta o inicia sesión en https://app.pathrule.io y luego conecta tu cliente MCP:

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

Para Claude.ai u otro cliente MCP por HTTP, usa el mismo endpoint. Completa el flujo de autorización y aprueba el espacio de trabajo y los scopes que solicita el cliente.

Descubrimiento

  • MCP: https://cloud.pathrule.io/mcp
  • Servidor de autorización: https://cloud.pathrule.io/.well-known/oauth-authorization-server
  • Recurso protegido: https://cloud.pathrule.io/.well-known/oauth-protected-resource/mcp

Herramientas y permisos

Un permiso de lectura expone pathrule_get_context y las herramientas de listado y lectura de memorias, reglas y skills. Un permiso de escritura expone además la creación, las actualizaciones, la eliminación y el historial de cada elemento. El acceso se limita al espacio de trabajo del permiso; indicar el id de otro espacio de trabajo no lo amplía.

Las escrituras remotas usan title, body y una path canónica. Las actualizaciones usan el id del elemento y un expectedVersion numérico. Las mutaciones necesitan un operation_id estable o una clave de idempotencia, de modo que reintentar una operación no crea una segunda copia. Estos son esquemas remotos, no los esquemas content_edit y expected_version_id del servidor local. Pide tools/list al servidor conectado antes de usarlos.

El servidor de autorización reconoce pathrule:read, pathrule:write, pathrule:refresh y pathrule:activity. Que un scope se reconozca no implica que exista una herramienta: el catálogo remoto actual cubre conocimiento y contexto. La administración de la organización, la creación de espacios de trabajo, las instantáneas, el aprendizaje local de proyectos, la importación de patrones, el registro de actividad y los flujos de actualización usan la CLI, las herramientas MCP locales o la consola de Cloud.

Los permisos se mantienen al día

El servidor verifica tu sesión, el estado del espacio de trabajo y tu membresía cuando autoriza el acceso y cuando ejecuta una herramienta. Si te quitan de un espacio de trabajo, o si este se archiva o se elimina, se revocan sus permisos. Restaurar el espacio de trabajo no reactiva esos permisos; vuelve a conectarte y aprueba el acceso de nuevo. Los refresh tokens rotan, y reutilizar un token que ya rotó revoca toda su familia de tokens.

Entrega local

Remote MCP no puede leer tu sistema de archivos, instalar hooks, escribir archivos complementarios ni enviar preferencias personales locales. Un agente debe llamar a sus herramientas para obtener contexto. Usa la CLI o VS Code cuando quieras contexto que conozca el repositorio y hooks antes de que el agente actúe.