zyta-expedientes-mcp (Clio)

Servidor MCP (stdio) para Clio (Expedientes): portales judiciales (PJN, MEV, CABA) y causas sin portal.

Arquitectura

Componente	Rol
Zyta-be	Login JWT, device flow OAuth, perfil usuario
expedientes-api	Portales, listado, sync, CRUD causas sin portal, actuaciones cursor
Zyta-expedientes (web)	Página /mcp-device para autorizar el agente

El MCP autentica contra Zyta-be y consulta expedientes-api con el mismo Bearer JWT.

Configuración en Cursor

{
  "mcpServers": {
    "zyta-expedientes": {
      "command": "npx",
      "args": ["-y", "zyta-expedientes-mcp@latest"],
      "env": {
        "ZYTA_API_BASE_URL": "http://localhost:3333",
        "EXPEDIENTES_API_BASE_URL": "http://localhost:8788",
        "ZYTA_EXPEDIENTES_APP_URL": "http://localhost:8892"
      }
    }
  }
}

En producción:

ZYTA_API_BASE_URL=https://zyta-be-production.up.railway.app
EXPEDIENTES_API_BASE_URL=https://zyta-expedientes-api-production.up.railway.app
ZYTA_EXPEDIENTES_APP_URL=https://dashboard.zyta.app

Opcional en Railway (Zyta-be): MCP_DEVICE_VERIFICATION_BASE_URL=https://dashboard.zyta.app

Herramientas

Tool	Descripción
zyta_expedientes_login	Device flow / email / token manual
zyta_expedientes_disconnect	Cierra sesión del agente
zyta_expedientes_whoami	Usuario actual
zyta_expedientes_auth_status	Estado + URLs
zyta_expedientes_portales_status	PJN / MEV / CABA / INPI conectados
zyta_expedientes_list	Listar expedientes (filtro por portal)
zyta_expedientes_get	Leer detalle + actuaciones
zyta_expedientes_create	Crear causa sin portal
zyta_expedientes_update	Editar causa sin portal (+ seguimiento opcional)
zyta_expedientes_delete	Borrar causa sin portal
zyta_expedientes_sync	Sincronizar portales (sin credenciales)
zyta_expedientes_registrar_actuacion	Actuación en causa sin portal
zyta_expedientes_honorarios_list	Honorarios del expediente
zyta_expedientes_honorarios_create	Alta de honorarios
zyta_expedientes_honorarios_update	Actualizar honorario
zyta_expedientes_honorarios_delete	Borrar honorario
zyta_expedientes_tareas_list	Vencimientos/tareas
zyta_expedientes_tareas_create	Nueva tarea
zyta_expedientes_tareas_update	Actualizar tarea
zyta_expedientes_tareas_delete	Borrar tarea
zyta_expedientes_alertas_list	Alarmas
zyta_expedientes_alertas_create	Nueva alarma
zyta_expedientes_alertas_update	Actualizar alarma
zyta_expedientes_alertas_delete	Borrar alarma

Token persistido en ~/.zyta-expedientes-mcp/token.

Desarrollo local

cd Zyta/zyta-expedientes-mcp
npm install
npm run build
npm run dev

Smoke test:

1. Levantá Zyta-be, expedientes-api y Zyta-expedientes
2. En Cursor: zyta_expedientes_login → autorizá en http://localhost:8892/mcp-device
3. zyta_expedientes_auth_status → hasToken: true
4. zyta_expedientes_portales_status

Probar el stack completo

Sí, hay que probar los tres servicios juntos:

# Terminal 1 — monolito (auth)
cd BE/Zyta-be && npm run start:dev

# Terminal 2 — microservicio expedientes
cd Zyta/expedientes-api && npm run dev

# Terminal 3 — front
cd Zyta/Zyta-expedientes && npm run dev

# Terminal 4 — MCP (via Cursor o)
cd Zyta/zyta-expedientes-mcp && npm run dev

Sin proxy en Zyta-be todavía, el front y el MCP apuntan directo a cada API por URL.