Cor-Works

CLI y servidor MCP para la API de COR. Gestiona autenticación, tareas, horas, proyectos y clientes desde la terminal o desde cualquier agente de IA compatible con el protocolo MCP.

Instalación

pip install cor-works

Requiere Python 3.10+ y acceso a la API de COR. El paquete instala dos ejecutables: cor (CLI) y cor-mcp (servidor MCP stdio).

Visión general

cor-works
├── cor              # CLI interactiva
│   ├── auth         # Login, sesión y tokens
│   ├── task         # Búsqueda y creación de tareas
│   ├── hours        # Registro y consulta de horas
│   ├── projects     # Gestión de proyectos
│   └── client       # Consulta de clientes
└── cor-mcp          # Servidor MCP (stdio)
    └── 13 tools     # Listos para agentes de IA

Referencia CLI

cor auth — Autenticación y sesión

Gestiona el ciclo completo de autenticación: login, refresco de tokens y limpieza de credenciales locales. Las credenciales se almacenan de forma segura usando keyring + cryptography.

cor auth login --email admin@empresa.com --password ••••••••
cor auth refresh-token

cor task — Tareas

Permite buscar tareas con múltiples filtros encadenados y crear nuevas tareas en un proyecto específico.

cor task search --filter title=WorldArd --filter status=nueva
cor task create --title "Revisión de diseño" --project-id 12345

cor hours — Horas

Registra y consulta horas trabajadas asociadas a tareas. Soporta filtros por fecha, tarea y proyecto.

cor hours add --task-id 142 --date 2026-03-02 --start 08:00 --hours 8h
cor hours get --filter dateStart=2026-03-01 --filter dateDeadline=2026-03-31
cor hours get-all --filter task_title=WorldArd

cor projects — Proyectos

Lista proyectos existentes y crea nuevos con parámetros configurables como estado y facturación.

cor projects get --filter project_name=WorldArd
cor projects create --name "Proyecto X" --client-id 77 --param status=active --param billable=true

cor client — Clientes

Consulta los clientes disponibles en la cuenta con soporte de filtros.

cor client get --filter client_name=Acme

Servidor MCP

cor-mcp implementa el protocolo MCP sobre stdio, permitiendo que agentes de IA (Claude, Cursor, etc.) ejecuten operaciones de COR de forma estructurada.

cor-mcp 

Herramientas disponibles (13 tools)

Confirmación obligatoria en operaciones sensibles. Las tools de tipo create, update y delete requieren que el agente obtenga confirmación explícita del usuario antes de ejecutar. Esto se indica pasando user_confirmed=true en el payload de la llamada.