cnvs-whiteboard-skills

Agent Skills + descubrimiento del servidor MCP para cnvs.app — la pizarra colaborativa en tiempo real gratuita y sin registro. Cualquier agente de IA puede leer, escribir, dibujar, diagramar y suscribirse a ediciones humanas en vivo en un lienzo compartido, ya sea a través del servidor MCP alojado o del respaldo REST.

Funciona con Claude Code, Claude Desktop, Cursor, OpenCode / OpenAI Codex, Aider (con el plugin de MCP), cualquier otro cliente que hable MCP y agentes de la familia Hermes.

Servidor MCP

Endpoint: https://cnvs.app/mcp (Streamable HTTP, protocolo 2025-06-18, sin autenticación — el ID de la pizarra es la clave de acceso).

Registrado en el MCP Registry oficial como app.cnvs/whiteboard.

Capacidades

• Herramientas (25): creación e inspección de pizarras; vistas previas visuales; edición de texto, enlaces, imágenes y trazos; movimiento y eliminación; esperas de actualizaciones en vivo; y flujos de trabajo completos de columnas, carriles, tareas, consultas y exportación de kanban. La lista exacta de producción se publica en /.well-known/mcp.json. Las operaciones que cambian el estado también tienen réplicas REST en https://cnvs.app/api/boards/<id>/… para entornos de ejecución que no pueden hablar MCP.

• Recursos (3): cnvs://board/{id}/state.json (instantánea completa), cnvs://board/{id}/preview.svg (renderizado visual) y cnvs://board/{id}/tasks.json (estado kanban). Los tres son suscribibles.

• Suscripciones: se admite resources/subscribe con notifications/resources/updated enviadas por SSE, con rebote de ~3 s después de que la actividad se asiente.

• Manifiestos legibles por máquina en vivo: /quotas.json, /openapi.json, /llms.txt, /.well-known/mcp.json, /.well-known/mcp/server.json.

Related MCP server: Excalidraw MCP Server

Instalación

Paquetes para Codex / ChatGPT y Cursor

Este repositorio es el paquete fuente público para ambas integraciones de marketplace:

• .codex-plugin/plugin.json y .mcp.json describen el plugin de Codex / ChatGPT.

• .cursor-plugin/plugin.json y mcp.json describen el plugin de Cursor.

• SUBMISSION.md y CURSOR-MARKETPLACE.md contienen el texto de listado preparado, las divulgaciones, los flujos de revisión y las listas de verificación de envío.

Ambos paquetes se conectan únicamente al endpoint de producción alojado; no hay ningún proceso de servidor local ni secreto que configurar.

Claude Desktop / Cursor / cualquier cliente MCP

Configuración de una línea — añade esto al objeto mcpServers de tu cliente:

{
  "mcpServers": {
    "cnvs": {
      "type": "http",
      "url": "https://cnvs.app/mcp"
    }
  }
}

CLI de Claude Code

claude mcp add --transport http cnvs https://cnvs.app/mcp

Solo REST (sin cliente MCP)

# Create a board
curl -X POST https://cnvs.app/api/boards

# Add text
curl -X POST https://cnvs.app/api/boards/<id>/texts \
  -H 'Content-Type: application/json' \
  -d '{"x":100,"y":200,"content":"# Hello","author":"ai:myagent"}'

# Long-poll for live changes
curl "https://cnvs.app/api/boards/<id>/wait?timeout_ms=25000"

Referencia REST completa: /llms.txt, /openapi.json.

Modelo de acceso

No hay cuenta ni flujo OAuth. Una URL de pizarra o un ID de pizarra es una credencial de acceso de tipo bearer: cualquiera que conozca una URL de pizarra desbloqueada puede abrirla. Las pizarras pueden requerir opcionalmente una clave de acceso alfanumérica en minúsculas de 8 caracteres para escrituras o para lecturas y escrituras; las claves heredadas de 6 caracteres siguen siendo aceptadas. Pasa una clave solo a través del argumento access_key de la herramienta MCP o de la cabecera HTTP X-Board-Key.

No pegues URLs de pizarras privadas ni claves de acceso en issues, registros o repositorios públicos.

Prompts útiles

• Crea una pizarra nueva para nuestra sesión de lluvia de ideas y devuelve su URL.

• Abre esta pizarra de cnvs.app, inspecciona su vista previa y resume el diseño.

• Convierte esta lista en un tablero kanban compartido con prioridades y responsables.

Skills incluidos

Dos Agent Skills relacionadas viven en este repositorio, publicadas bajo el estándar abierto agentskills.io para que funcionen en cualquier entorno de ejecución compatible. Instálalas en ~/.claude/skills/ para enseñar al agente a usar bien el servidor MCP (vista previa antes del JSON, REST sobre MCP para escrituras, convenciones de etiqueta de autor, bucle de suscripción y reacción).

cnvs-whiteboard/ — PRINCIPAL

Enseña a un agente de IA a colaborar en tiempo real en una pizarra de cnvs.app:

• Leer el estado del lienzo compartido

• Dibujar / diagramar / crear diagramas de flujo / anotar: añadir, actualizar, mover y eliminar texto, enlaces, notas adhesivas, trazos, imágenes y diagramas de Mermaid (diagramas de flujo, diagramas de secuencia / clases / ER, mapas mentales, diagramas de Gantt, mapas conceptuales)

• Renderizar la vista previa SVG cuando la pizarra contiene dibujos

• Suscribirse a ediciones humanas en vivo mediante MCP, reaccionar mediante REST

Se activa con cualquier referencia a una pizarra de cnvs.app (URL https://cnvs.app/#<id>, cnvs://board/<id>/... o un ID de pizarra simple) o con frases como "collaborate on / draw / diagram / annotate / watch a shared whiteboard or canvas".

mcp-listen/ — AYUDANTE (v0.3.0)

Bomba push-to-model para servidores MCP Streamable-HTTP con capabilities.resources.subscribe: true. Abre una sesión, se suscribe a los URI de recursos que el llamador le entrega y emite una línea JSON por cada evento notifications/resources/updated en stdout — diseñado para ser envuelto por la herramienta Monitor de Claude Code, de modo que cada push del servidor se convierta en una notificación dentro del chat (sin polling, sin seguimiento de logs).

Activación solo como ayudante desde v0.3. Se activa únicamente cuando el llamador — un usuario u otra skill — ha proporcionado tanto una URL de servidor MCP como al menos un URI de recurso. NO se autoactiva con frases genéricas como "watch this file" o "stay in the loop". cnvs-whiteboard es el llamador canónico y delega aquí su canal de push.

Separación de salida desde v0.3. Solo el evento accionable resource_updated llega a stdout por defecto. Los eventos de conexión, suscripción, heartbeat y errores transitorios van a stderr para que un Monitor envolvente no se dispare con la contabilidad interna del listener. Pasa --verbose (o -v) para fusionar todo en stdout para depuración o registro de un solo canal (comportamiento heredado de v0.2).

Estado en el registro. Intencionadamente no listada todavía en los registros centralizados de skills. Los pipelines de registro actuales (p. ej. majiayu000/claude-skill-registry-core a fecha de 2026-05-03) archivan solo SKILL.md + metadatos generados; no reflejan los scripts/** empaquetados ni package.json, por lo que una entrada para mcp-listen publicaría una skill rota. Se (re)enviará una vez que los registros principales admitan el archivado de skills en formato directorio con reflejo de archivos empaquetados y escaneo de seguridad — consulta el PR majiayu000/claude-skill-registry-core#40 para ver la primitiva de archivo de directorio que acaba de aterrizar y la cuestión abierta sobre el escaneo de scripts empaquetados. Hasta entonces, instálala mediante curl desde cnvs.app (abajo) o git clone de este repositorio.

Instalar las skills

# cnvs-whiteboard (SKILL.md only — no deps)
mkdir -p ~/.claude/skills/cnvs-whiteboard && cd ~/.claude/skills/cnvs-whiteboard
curl -O https://cnvs.app/cnvs-whiteboard/SKILL.md

# mcp-listen (SKILL.md + scripts/ + npm install)
mkdir -p ~/.claude/skills/mcp-listen && cd ~/.claude/skills/mcp-listen
curl -O https://cnvs.app/mcp-listen/SKILL.md \
     -O https://cnvs.app/mcp-listen/package.json \
     --create-dirs -o scripts/listen.mjs https://cnvs.app/mcp-listen/scripts/listen.mjs
npm install

Alternativamente, haz git clone de este repositorio y cp -r .claude/skills/* ~/.claude/skills/ — el directorio .claude/skills/ contiene enlaces simbólicos a cnvs-whiteboard/ y mcp-listen/ para la estructura esperada por Claude Code.

Cumplimiento de la especificación

Ambas skills siguen la especificación de agentskills.io:

• name coincide con el nombre del directorio contenedor

• description de menos de 1024 caracteres, redacción imperativa, palabras clave de activación explícitas

• subdirectorio scripts/ para el código empaquetado (mcp-listen)

• license: MIT, campo compatibility declarado, referencias cruzadas en la sección "Related skills" de cada skill para evitar solapamiento de activación

Por qué dos skills

Las versiones anteriores tenían una sola página (/skill-cnvs.md en cnvs.app — ahora una redirección heredada). Dividirlas en dos unidades coherentes sigue la buena práctica de "design coherent units" de la especificación:

• cnvs-whiteboard posee el flujo de trabajo específico de cnvs.app (leer / escribir / renderizar / gotchas).

• mcp-listen posee el patrón