Skip to main content
Glama

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 — 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.

Available Tools

32 tools
roiq_add_cardB

Añade una tarjeta/fila a un tablero o tabla. status por defecto = primera columna.

NameRequiredDescriptionDefault
nameYes
propsNo
statusNo
assigneeNo
pipelineIdYes
roiq_add_columnC

Añade una columna/estado a un tablero.

NameRequiredDescriptionDefault
keyYes
colorNo
pipelineIdYes
roiq_add_propertyC

Añade una propiedad (columna de datos) a una DB. type ∈ select|person|text|link|number|date.

NameRequiredDescriptionDefault
keyNo
typeNo
labelYes
optionsNo
pipelineIdYes
roiq_create_dbB

Crea una base de datos (tablero kanban o tabla) en un espacio. Opcional: estados (columnas) y propiedades.

NameRequiredDescriptionDefault
kindNoboard = kanban (por defecto) | table
propsNo
spaceYesid o nombre del espacio
titleYes
statusesNocolumnas/estados
roiq_create_embedC

Crea un enlace incrustado (iframe: Drive, Docs, cualquier web) en un espacio.

NameRequiredDescriptionDefault
urlYes
spaceYes
titleYes
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.

NameRequiredDescriptionDefault
guionYesel guion en markdown ligero (### escena, texto, etc.)
spaceYesid o nombre del espacio (cliente/proyecto)
titleYestítulo del guion
montajeNoopcional: tomas + receta para el montaje que se disparará al aprobar
summaryNoresumen 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., - [ ]).

NameRequiredDescriptionDefault
spaceYesid o nombre del espacio
titleYestítulo de la página
contentNocontenido 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.

NameRequiredDescriptionDefault
iconNoicono, ej. 'svg:building' o un emoji
kindNoteam (equipo, por defecto) | client | private
nameYesnombre del espacio
roiq_create_whiteboardB

Crea una pizarra (ROIQ Board estilo Miro) en un espacio y la provisiona en el backend del board.

NameRequiredDescriptionDefault
spaceYes
titleYes
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.

NameRequiredDescriptionDefault
idYes
roiq_get_proposalC

Devuelve una propuesta completa (incluye su payload, p.ej. tomas+receta de montaje).

NameRequiredDescriptionDefault
idYes
roiq_list_cardsB

Lista las tarjetas/filas de un tablero o tabla (por su id de pipeline).

NameRequiredDescriptionDefault
pipelineIdYes
roiq_list_itemsA

Lista los items (páginas, tableros, tablas, pizarras, enlaces) del workspace. Filtra por espacio (spaceId o nombre) y/o tipo.

NameRequiredDescriptionDefault
typeNopage | pipeline | board | embed | footage | naming | artifact
spaceNoid 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).

NameRequiredDescriptionDefault
allNo
roiq_list_skillsA

Lista todas las skills del motor de ROIQ OS que puedes ejecutar con roiq_run_skill.

NameRequiredDescriptionDefault

No parameters

roiq_list_spacesA

Lista los espacios (equipos, clientes, privados) con su id y tipo.

NameRequiredDescriptionDefault

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.

NameRequiredDescriptionDefault
idYes
roiq_montaje_correctC

Corrige/reedita un montaje en curso por su id (mjob_…) en lenguaje natural (skill montaje_corregir).

NameRequiredDescriptionDefault
idYes
correccionYes
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).

NameRequiredDescriptionDefault
titleNo
inputsYestomas EN ORDEN (usa las key de roiq_montaje_list_sources)
recetaNocó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.

NameRequiredDescriptionDefault

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).

NameRequiredDescriptionDefault
proyectoNo
roiq_montaje_statusA

Consulta el estado de un montaje/edición por su id (mjob_… o ejob_…).

NameRequiredDescriptionDefault
idYes
roiq_move_cardC

Mueve una tarjeta a otra columna/estado.

NameRequiredDescriptionDefault
codeYes
statusYes
roiq_overviewA

Resumen del workspace de ROIQ OS: espacios, conteo de items por tipo y secciones con datos. Úsala primero para orientarte.

NameRequiredDescriptionDefault

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.

NameRequiredDescriptionDefault
htmlYes
titleYes
roiq_rename_itemC

Renombra un item (página/tablero/tabla/pizarra/enlace) por su id.

NameRequiredDescriptionDefault
idYes
titleYes
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.

NameRequiredDescriptionDefault
argsNo
nameYes
roiq_set_page_contentC

Reemplaza el contenido de una página con el texto/markdown dado.

NameRequiredDescriptionDefault
pageIdYes
contentYesmarkdown 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.

NameRequiredDescriptionDefault

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.

NameRequiredDescriptionDefault
pathNodot-path, ej. 'brand.name' o 'automations[]'
mergeNoobjeto a fusionar (deep-merge) en la raíz del workspace
valueNovalor a fijar/insertar en path
roiq_update_cardC

Actualiza campos de una tarjeta por su code (name, status, assignee y/o props).

NameRequiredDescriptionDefault
codeYes
nameNo
propsNo
statusNo
assigneeNo
roiq_update_proposalA

Cambia el estado de una propuesta (p.ej. 'done' tras ejecutarla, o 'rejected').

NameRequiredDescriptionDefault
idYes
statusYes

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 32 tool updatesv1.1.0
    • First observedroiq_add_card
    • First observedroiq_add_column
    • First observedroiq_add_property
    • First observedroiq_create_db
    • First observedroiq_create_embed
    • First observedroiq_create_guion
    • First observedroiq_create_page
    • First observedroiq_create_space
    • First observedroiq_create_whiteboard
    • First observedroiq_delete_item
    • First observedroiq_get_proposal
    • First observedroiq_list_cards
    • First observedroiq_list_items
    • First observedroiq_list_pending
    • First observedroiq_list_skills
    • First observedroiq_list_spaces
    • First observedroiq_montaje_approve
    • First observedroiq_montaje_correct
    • First observedroiq_montaje_edit
    • First observedroiq_montaje_list
    • First observedroiq_montaje_list_sources
    • First observedroiq_montaje_status
    • First observedroiq_move_card
    • First observedroiq_overview
    • First observedroiq_publish_html
    • First observedroiq_rename_item
    • First observedroiq_run_skill
    • First observedroiq_set_page_content
    • First observedroiq_state_get
    • First observedroiq_state_patch
    • First observedroiq_update_card
    • First observedroiq_update_proposal

TDQS

A3.5/5.0

Scored across 32 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count4/5

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.

Completeness4/5

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

ActivityInactive
ResponsivenessNo recent community issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Bridges Claude Code to the Rowan Rose CRM, translating MCP tool calls into REST API requests for contacts, cases, documents, and more.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Connects 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
  • A
    license
    Not graded
    quality
    A
    maintenance
    Connects 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 npm
    MIT