roiq-os-mcp
# roiq-os-mcp — conector MCP de ROIQ OS
Puente ligero para operar **ROIQ OS** desde **Claude Code**. No contiene código ni secretos de ROIQ OS:
solo llama a su API operadora (`/api/op`) con el **token** que te dé el Owner. Sin un token válido no hace nada.
## Conectar (una sola vez)
No necesitas clonar nada. En tu terminal:
```bash
claude mcp add roiq-os --scope user \
-e ROIQ_BASE_URL=https://roiq-os.pages.dev \
-e ROIQ_OPERATOR_TOKEN=EL_TOKEN_QUE_TE_DIERON \
-- npx -y github:crisglezz/roiq-mcp
```
(En PowerShell, todo en **una línea**, sin las `\`. Si `claude` no se reconoce, usa la ruta completa a
`claude.exe`.)
Reinicia Claude Code y tendrás las herramientas `roiq_*`, limitadas a lo que tu token permita.
## Requisitos
- **Node 18+** y **Claude Code**.
- Un **token** de acceso (lo crea el Owner en ROIQ OS → Configuraciones → Conectar Claude).
## Variables de entorno
- `ROIQ_BASE_URL` — normalmente `https://roiq-os.pages.dev`.
- `ROIQ_OPERATOR_TOKEN` — tu token de acceso (privado; nunca lo pongas en un archivo compartido).
## Qué puede hacer
Crear/editar espacios, páginas, tableros, tablas, tarjetas, guiones; montar y aprobar vídeos; sacar reportes
y analítica; publicar HTML — **dentro del alcance** que el Owner le dio a tu token. Todo lo que dejes montado
queda **pendiente de aprobación** en la sección Operador de ROIQ OS.
## Seguridad
Tu token define a qué espacios accedes y qué permisos tienes; el control se hace **en el servidor** de ROIQ OS.
Si tu token se filtra, avisa al Owner para revocarlo.
MIT.
TDQS
Scored across 32 tools
Each tool targets a distinct entity and action, with clear boundaries (e.g., roiq_create_db vs roiq_add_column, roiq_montage_edit vs roiq_montage_correct). Even the escape hatch roiq_state_patch is explicitly documented as a last resort, not a source of ambiguity.
All tools follow a consistent roiq_verb_noun pattern (e.g., add_card, create_db, list_items). Verbs are uniform (add, create, delete, list, get, update, rename) and nouns correspond to domain entities, making the pattern predictable.
32 tools is relatively high, but each covers a distinct operation in a comprehensive OS platform (kanban, spaces, pages, video montage, skills). The scope justifies the count, though a few tools (e.g., roiq_state_get, roiq_state_patch) are general-purpose and could have been fewer.
The tool surface covers CRUD for core entities (cards, columns, properties, pages, spaces, items) and video montage workflow. Minor gaps exist (e.g., no explicit tool for updating page title separately, but roiq_rename_item works; no user management tools), but the escape hatch roiq_state_patch ensures no dead ends.