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.