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.

Inputs: name (required), pipelineId (required), props, status, +1 more.

roiq_add_columnC

Añade una columna/estado a un tablero.

Inputs: key (required), pipelineId (required), color.

roiq_add_propertyC

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

Inputs: label (required), pipelineId (required), key, type, +1 more.

roiq_create_dbB

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

Inputs: space (required), title (required), kind, props, +1 more.

roiq_create_embedC

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

Inputs: url (required), space (required), title (required).

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.

Inputs: guion (required), space (required), title (required), montaje, +1 more.

roiq_create_pageC

Crea una página dentro de un espacio, con contenido opcional (texto/markdown ligero: #, ##, ###, >, -, 1., - [ ]).

Inputs: space (required), title (required), content.

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.

Inputs: name (required), icon, kind.

roiq_create_whiteboardB

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

Inputs: space (required), title (required).

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.

Inputs: id (required).

roiq_get_proposalC

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

Inputs: id (required).

roiq_list_cardsB

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

Inputs: pipelineId (required).

roiq_list_itemsA

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

Inputs: type, space.

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

Inputs: all.

roiq_list_skillsA

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

Inputs: no named parameters.

roiq_list_spacesA

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

Inputs: no named 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.

Inputs: id (required).

roiq_montaje_correctC

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

Inputs: id (required), correccion (required).

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

Inputs: inputs (required), title, receta.

roiq_montaje_listA

Lista los montajes de la zona de montaje (jobs del editor de vídeo) con su estado y video_key.

Inputs: no named parameters.

roiq_montaje_list_sourcesB

Lista las tomas disponibles para montar, agrupadas por proyecto y en el orden del guion (skill montaje_listar_fuentes).

Inputs: proyecto.

roiq_montaje_statusA

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

Inputs: id (required).

roiq_move_cardC

Mueve una tarjeta a otra columna/estado.

Inputs: code (required), status (required).

roiq_overviewA

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

Inputs: no named 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.

Inputs: html (required), title (required).

roiq_rename_itemC

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

Inputs: id (required), title (required).

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.

Inputs: name (required), args.

roiq_set_page_contentC

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

Inputs: pageId (required), content (required).

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.

Inputs: no named 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.

Inputs: path, merge, value.

roiq_update_cardC

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

Inputs: code (required), name, props, status, +1 more.

roiq_update_proposalA

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

Inputs: id (required), status (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    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,360 npm
      MIT