roiq-os-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@roiq-os-mcpcreate a new board called 'Project Alpha'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
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.
Related MCP server: raindrop-mcp-server
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— normalmentehttps://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.
Available Tools
32 toolsroiq_add_cardB
Añade una tarjeta/fila a un tablero o tabla. status por defecto = primera columna.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| props | No | ||
| status | No | ||
| assignee | No | ||
| pipelineId | Yes |
roiq_add_columnC
Añade una columna/estado a un tablero.
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | ||
| color | No | ||
| pipelineId | Yes |
roiq_add_propertyC
Añade una propiedad (columna de datos) a una DB. type ∈ select|person|text|link|number|date.
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | ||
| type | No | ||
| label | Yes | ||
| options | No | ||
| pipelineId | Yes |
roiq_create_dbB
Crea una base de datos (tablero kanban o tabla) en un espacio. Opcional: estados (columnas) y propiedades.
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | board = kanban (por defecto) | table | |
| props | No | ||
| space | Yes | id o nombre del espacio | |
| title | Yes | ||
| statuses | No | columnas/estados |
roiq_create_embedC
Crea un enlace incrustado (iframe: Drive, Docs, cualquier web) en un espacio.
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| space | Yes | ||
| title | Yes |
roiq_create_guionA
Crea la página de un GUION en un espacio y registra una PROPUESTA PENDIENTE de aprobación en el buzón Operador. Cristhyan la aprueba desde la app; tú lo detectas con roiq_list_pending y entonces disparas el montaje.
| Name | Required | Description | Default |
|---|---|---|---|
| guion | Yes | el guion en markdown ligero (### escena, texto, etc.) | |
| space | Yes | id o nombre del espacio (cliente/proyecto) | |
| title | Yes | título del guion | |
| montaje | No | opcional: tomas + receta para el montaje que se disparará al aprobar | |
| summary | No | resumen de una línea para el buzón |
roiq_create_pageC
Crea una página dentro de un espacio, con contenido opcional (texto/markdown ligero: #, ##, ###, >, -, 1., - [ ]).
| Name | Required | Description | Default |
|---|---|---|---|
| space | Yes | id o nombre del espacio | |
| title | Yes | título de la página | |
| content | No | contenido en markdown ligero |
roiq_create_spaceA
Crea un espacio nuevo (equipo, cliente o privado). Nace sin teams asignados → sólo Owner/Admin lo ven hasta asignarlo en Configuraciones.
| Name | Required | Description | Default |
|---|---|---|---|
| icon | No | icono, ej. 'svg:building' o un emoji | |
| kind | No | team (equipo, por defecto) | client | private | |
| name | Yes | nombre del espacio |
roiq_create_whiteboardB
Crea una pizarra (ROIQ Board estilo Miro) en un espacio y la provisiona en el backend del board.
| Name | Required | Description | Default |
|---|---|---|---|
| space | Yes | ||
| title | Yes |
roiq_delete_itemA
Elimina un item por su id (y, si es un tablero/tabla, sus tarjetas). Confirma con el usuario antes de borrar cosas importantes.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
roiq_get_proposalC
Devuelve una propuesta completa (incluye su payload, p.ej. tomas+receta de montaje).
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
roiq_list_cardsB
Lista las tarjetas/filas de un tablero o tabla (por su id de pipeline).
| Name | Required | Description | Default |
|---|---|---|---|
| pipelineId | Yes |
roiq_list_itemsA
Lista los items (páginas, tableros, tablas, pizarras, enlaces) del workspace. Filtra por espacio (spaceId o nombre) y/o tipo.
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | page | pipeline | board | embed | footage | naming | artifact | |
| space | No | id o nombre del espacio para filtrar |
roiq_list_pendingA
Lista las propuestas del buzón Operador. Por defecto sólo las pendientes; pasa all=true para ver todas (incluye las aprobadas por Cristhyan que ya puedes ejecutar).
| Name | Required | Description | Default |
|---|---|---|---|
| all | No |
roiq_list_skillsA
Lista todas las skills del motor de ROIQ OS que puedes ejecutar con roiq_run_skill.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
roiq_list_spacesA
Lista los espacios (equipos, clientes, privados) con su id y tipo.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
roiq_montaje_approveA
APRUEBA un montaje para renderizar (pasa a render_queued; el worker del VPS lo renderiza). Úsalo tras la aprobación de Cristhyan.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
roiq_montaje_correctC
Corrige/reedita un montaje en curso por su id (mjob_…) en lenguaje natural (skill montaje_corregir).
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| correccion | Yes |
roiq_montaje_editA
Monta y edita un vídeo COMPLETO de forma autónoma (Director + render + revisión con visión). Tarda minutos; el resultado se publica en el chat de ROIQ OS (skill montaje_editar).
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | ||
| inputs | Yes | tomas EN ORDEN (usa las key de roiq_montaje_list_sources) | |
| receta | No | cómo editar: {brief, caption_style, ref, retention, images} |
roiq_montaje_listA
Lista los montajes de la zona de montaje (jobs del editor de vídeo) con su estado y video_key.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
roiq_montaje_list_sourcesB
Lista las tomas disponibles para montar, agrupadas por proyecto y en el orden del guion (skill montaje_listar_fuentes).
| Name | Required | Description | Default |
|---|---|---|---|
| proyecto | No |
roiq_montaje_statusA
Consulta el estado de un montaje/edición por su id (mjob_… o ejob_…).
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
roiq_move_cardC
Mueve una tarjeta a otra columna/estado.
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | ||
| status | Yes |
roiq_overviewA
Resumen del workspace de ROIQ OS: espacios, conteo de items por tipo y secciones con datos. Úsala primero para orientarte.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
roiq_publish_htmlB
Publica un HTML autocontenido (artefacto) y devuelve un enlace de sólo lectura no indexado. Confirma con el usuario antes de publicar contenido de cara al exterior.
| Name | Required | Description | Default |
|---|---|---|---|
| html | Yes | ||
| title | Yes |
roiq_rename_itemC
Renombra un item (página/tablero/tabla/pizarra/enlace) por su id.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| title | Yes |
roiq_run_skillB
Ejecuta cualquier skill del motor de ROIQ OS por su nombre (sacar_reporte, analitica_web, ver, escuchar, biblioteca_listar, biblioteca_describir_imagenes, montaje_*…). Pásale sus args.
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | ||
| name | Yes |
roiq_set_page_contentC
Reemplaza el contenido de una página con el texto/markdown dado.
| Name | Required | Description | Default |
|---|---|---|---|
| pageId | Yes | ||
| content | Yes | markdown ligero |
roiq_state_getA
Devuelve el JSON COMPLETO del workspace (puede ser grande). Úsalo sólo cuando necesites inspeccionar algo que las demás tools no cubren.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
roiq_state_patchA
Escape hatch universal: modifica el workspace directamente. O bien set por dot-path (path + value; sufijo '[]' en path = push a un array), o bien merge (deep-merge de un objeto en la raíz). Garantiza que puedes hacer CUALQUIER cosa no cubierta por otra tool. Úsalo con cuidado.
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | dot-path, ej. 'brand.name' o 'automations[]' | |
| merge | No | objeto a fusionar (deep-merge) en la raíz del workspace | |
| value | No | valor a fijar/insertar en path |
roiq_update_cardC
Actualiza campos de una tarjeta por su code (name, status, assignee y/o props).
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | ||
| name | No | ||
| props | No | ||
| status | No | ||
| assignee | No |
roiq_update_proposalA
Cambia el estado de una propuesta (p.ej. 'done' tras ejecutarla, o 'rejected').
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| status | Yes |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
32 tool updates
v1.1.0- First observed
roiq_add_card - First observed
roiq_add_column - First observed
roiq_add_property - First observed
roiq_create_db - First observed
roiq_create_embed - First observed
roiq_create_guion - First observed
roiq_create_page - First observed
roiq_create_space - First observed
roiq_create_whiteboard - First observed
roiq_delete_item - First observed
roiq_get_proposal - First observed
roiq_list_cards - First observed
roiq_list_items - First observed
roiq_list_pending - First observed
roiq_list_skills - First observed
roiq_list_spaces - First observed
roiq_montaje_approve - First observed
roiq_montaje_correct - First observed
roiq_montaje_edit - First observed
roiq_montaje_list - First observed
roiq_montaje_list_sources - First observed
roiq_montaje_status - First observed
roiq_move_card - First observed
roiq_overview - First observed
roiq_publish_html - First observed
roiq_rename_item - First observed
roiq_run_skill - First observed
roiq_set_page_content - First observed
roiq_state_get - First observed
roiq_state_patch - First observed
roiq_update_card - First observed
roiq_update_proposal
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.
Maintenance
Related MCP Connectors
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Create projects, nodes, and tasks in UluP Spaces by conversation with Claude.
Connect AI agents to shared Spaces for context, sourced work, tasks, and runs.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceBridges Claude Code to the Rowan Rose CRM, translating MCP tool calls into REST API requests for contacts, cases, documents, and more.-
- AlicenseAqualityDmaintenanceEnables Claude Code and other MCP clients to manage bookmarks, collections, and tags in Raindrop.io accounts via natural language.152MIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude Code to any ObjectStack deployment, enabling discovery, querying, and updating of objects and records, plus running business actions, all under user permissions and row-level security.Apache 2.0
- AlicenseNot gradedqualityAmaintenanceConnects AI agents and MCP-speaking clients such as Claude, Cursor, VS Code and ChatGPT to Notion using a single token, enabling them to create and edit pages, query databases, append blocks, apply templates, comment, and upload files in plain language. It runs headless for CI and background agents, keeps context usage low by loading only three tools, and supports batched mutations with idempotency and retries.5,011 npmMIT