OpenCharts MCP

oficial

Conecta tu agente de IA a OpenCharts: crea hojas de cálculo, tableros, música y automatizaciones desde Claude Code, Codex o Cursor sin salir de tu terminal.

GitHub

¿Qué puedes hacer con Open Charts MCP?

Crear y gestionar proyectos — Crea diagramas de flujo, pizarras, notas, presentaciones y más usando herramientas como create_flowchart, create_whiteboard, create_notes y create_presentation.
Trabajar con hojas de cálculo — Inspecciona, lee, crea y edita Theo Sheets con soporte de fórmulas usando inspect_sheet, get_sheet, create_sheet, update_sheet y edit_sheet.
Crear y ejecutar automatizaciones — Crea, configura, activa y ejecuta Theo Agents con build_agent, create_agent, configure_agent_trigger y run_agent.
Gestionar tableros Kanban — Crea tableros, agrega y actualiza tarjetas, y administra listas con create_board, add_board_card, update_board_card y list_board_cards.
Generar sitios web y canciones — Construye sitios web o aplicaciones completas con generate_code_canvas y crea música con create_song, luego consulta el estado con get_code_canvas_status y get_song_status.
Verificar cuenta y créditos — Confirma tu conexión con whoami y monitorea el uso de créditos de IA con get_credits.

Documentación

Servidor MCP de OpenCharts

Crea diagramas de flujo, notas, diapositivas, hojas, tableros, sitios, agentes y canciones en OpenCharts — directamente desde tu cliente de IA.

Sitio web · Documentación · Obtener una clave API · Incidencias

¿Qué es esto?

OpenCharts ejecuta un servidor público y alojado del Protocolo de Contexto de Modelo (MCP) que pone todo el producto OpenCharts dentro de cualquier cliente de IA compatible con MCP. Conéctate una vez con una clave API y tu asistente podrá construir y gestionar proyectos reales de OpenCharts en tu nombre — diagramas de flujo, pizarras, notas, presentaciones, hojas de cálculo (Theo Sheets), tableros Kanban + calendario, sitios web y aplicaciones completos (Code Canvas), automatizaciones (Theo Agents) y canciones (Theo Symphony) — todo impulsado por Theo, la IA de OpenCharts.

Es un servidor remoto sobre HTTP transmitido — no hay nada que instalar o ejecutar localmente. Apunta tu cliente al endpoint, pega tu clave API y listo.

Este repositorio es la documentación pública para ese servidor. El servidor en sí está alojado por OpenCharts; no lo ejecutas tú mismo.

¿Quieres conectarte en menos de un minuto? Usa la guía integrada en opencharts.com/help/mcp-server o la página de configuración en opencharts.com/theo-agents/mcp.

Inicio rápido

Crea una clave API en opencharts.com/theo-agents/mcp. Cópiala inmediatamente — la clave completa se muestra solo una vez.
Añade el servidor a tu cliente de IA usando el fragmento de configuración correspondiente a continuación, reemplazando {{YOUR_API_KEY}} con tu clave.
Verifica la conexión pidiendo a tu asistente que llame a la herramienta whoami — debería devolver tu cuenta de OpenCharts.

Endpoint

https://www.opencharts.com/api/mcp

Transporte: HTTP transmitido (POST)
Autenticación: Authorization: Bearer <API key> (un JWT de una sesión activa de OpenCharts también funciona)

⚠️ Usa siempre el host www.. El host principal opencharts.com emite una redirección 307 que elimina la cabecera Authorization y rompe la autenticación. Usa https://www.opencharts.com/api/mcp exactamente.

Conecta tu cliente de IA

El servidor funciona con cualquier cliente compatible con MCP. Copia el fragmento correspondiente e introduce tu clave API. ¿Prefieres que tu asistente lo configure? La página de ayuda tiene un "aviso de configuración de IA" de un solo pegado para cada cliente a continuación.

Warp

{
  "mcpServers": {
    "opencharts": {
      "type": "http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "opencharts": {
      "type": "streamable-http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "opencharts": {
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

VS Code (GitHub Copilot)

Añadir a .vscode/mcp.json:

{
  "servers": {
    "opencharts": {
      "type": "http",
      "url": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:opencharts-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "opencharts-key",
      "type": "promptString",
      "description": "OpenCharts API key",
      "password": true
    }
  ]
}

Windsurf (Codeium)

{
  "mcpServers": {
    "opencharts": {
      "serverUrl": "https://www.opencharts.com/api/mcp",
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http opencharts https://www.opencharts.com/api/mcp --header "Authorization: Bearer {{YOUR_API_KEY}}"

Codex (OpenAI)

codex mcp add opencharts --url https://www.opencharts.com/api/mcp --header "Authorization: Bearer {{YOUR_API_KEY}}"

Amp

En la extensión de VS Code settings.json:

"amp.mcpServers": {
  "opencharts": {
    "url": "https://www.opencharts.com/api/mcp",
    "headers": {
      "Authorization": "Bearer {{YOUR_API_KEY}}"
    }
  }
}

OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "opencharts": {
      "type": "remote",
      "url": "https://www.opencharts.com/api/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {{YOUR_API_KEY}}"
      }
    }
  }
}

Herramientas

El servidor expone 56 herramientas en 10 grupos. Las herramientas que usan Theo AI o generación consumen créditos de IA.

Proyectos

Herramienta	Descripción
`list_projects`	Lista tus proyectos con paginación y filtros
`get_project`	Obtén datos completos del proyecto por ID
`create_flowchart`	Crea un proyecto de diagrama de flujo con nodos y aristas
`create_whiteboard`	Crea una pizarra con formas y elementos nativos
`create_notes`	Crea un proyecto de notas desde Markdown
`create_presentation`	Crea una presentación de diapositivas desde un esquema
`update_project`	Actualiza metadatos o contenido (notas, diagrama de flujo, pizarra o presentación)
`delete_project`	Elimina de forma reversible un proyecto (recuperación en 30 días)

Code Canvas

Herramienta	Descripción
`generate_code_canvas`	Construye un sitio web o aplicación completo (HTML/React) desde una descripción — devuelve un trabajo para consultar
`get_code_canvas_status`	Consulta una compilación de Code Canvas; devuelve el proyecto + URL abierta cuando esté listo

IA

Herramienta	Descripción
`ask_theo`	Envía un mensaje de IA de un solo turno (modo rápido o pensar)
`extract_flowchart`	Extrae un diagrama de flujo de un documento subido (PDF, imagen, PPTX)

Theo Agents

Herramienta	Descripción
`build_agent`	Construye un Theo Agent desde una descripción — se ejecuta en segundo plano, te notifica cuando está listo
`get_agent_build_status`	Consulta opcional para un trabajo de `build_agent`; devuelve el agente + URL abierta cuando termina
`create_agent`	Crea un Theo Agent determinísticamente a partir de pasos estructurados + disparador
`update_agent`	Modifica el nombre, descripción o lista de pasos de un agente
`configure_agent_trigger`	Establece el disparador de un agente (manual, programación, webhook, evento, telegram)
`activate_agent`	Activa un agente (siembra la primera ejecución programada)
`deactivate_agent`	Desactiva un agente para que los disparadores dejen de activarse
`delete_agent`	Elimina de forma reversible un agente (recuperación en 30 días)
`list_agents`	Lista tus Theo Agents con estado + recuento de pasos
`get_agent`	Obtén la definición completa de un agente (disparador + pasos ordenados)
`run_agent`	Despacha un agente ahora — se ejecuta en segundo plano, te notifica al finalizar
`list_agent_runs`	Lista las ejecuciones recientes de un agente
`get_agent_run_status`	Obtén el estado de una sola ejecución + progreso por nodo

Theo Sheets

Herramienta	Descripción
`list_sheets`	Lista tus proyectos de hojas de cálculo Theo Sheets
`inspect_sheet`	Inspecciona una hoja — dimensiones por pestaña, fila de encabezado, celdas muestreadas + fórmulas, diseño
`get_sheet`	Extrae una hoja de trabajo como filas estructuradas (encabezados + filas de datos)
`read_sheet_range`	Lee los valores de un rango A1 exacto (+ fórmulas opcionales) como cuadrícula + CSV
`create_sheet`	Crea una hoja de cálculo en vivo (cuadrícula de grado Excel + fórmulas) a partir de encabezados y filas
`update_sheet`	Edita una hoja aplicando operaciones estructuradas de edición de hoja de cálculo — guardado como un commit reversible
`apply_sheet_ops`	Aplica operaciones estructuradas de edición de hoja de cálculo — o propón un cambio con control de fusión
`edit_sheet`	Edita una hoja con una instrucción en lenguaje natural (Theo planifica + aplica operaciones)
`list_sheet_commits`	Lista los commits de cambio estilo git de una hoja (aplicados / propuestos / fusionados)
`diff_sheet_commit`	Muestra la diferencia a nivel de celda para un commit o propuesta
`resolve_sheet_proposal`	Fusiona o rechaza una propuesta de cambio pendiente
`rollback_sheet`	Revierte la hoja en vivo a un commit anterior (reversible)

Tableros

Herramienta	Descripción
`create_board`	Crea un tablero de proyecto Kanban + calendario
`list_boards`	Lista tus tableros de proyecto
`get_board`	Obtén las listas (columnas) y tarjetas de un tablero
`update_board`	Actualiza el nombre, descripción o columnas de lista de un tablero
`delete_board`	Elimina de forma reversible un tablero (recuperable)
`duplicate_board`	Duplica un tablero con sus listas, reglas y tarjetas
`add_board_card`	Añade una tarjeta (publicación/tarea/idea/evento) a un tablero
`list_board_cards`	Lista las tarjetas de un tablero, opcionalmente por rango de programación
`update_board_card`	Edita una tarjeta — mover lista, reprogramar, cambiar estado/color
`delete_board_card`	Elimina de forma reversible una tarjeta de un tablero

Theo Symphony

Herramienta	Descripción
`create_song`	Genera una canción con Theo Symphony — devuelve un trabajo para consultar
`get_song_status`	Consulta un trabajo de canción; devuelve versiones de audio + carátula cuando esté completo

Notas

Herramienta	Descripción
`get_note_content`	Extrae el contenido de una nota como Markdown
`append_to_note`	Añade contenido Markdown a una nota existente
`clip_to_note`	Guarda contenido web (URL + HTML) como un recorte dentro de una nota

Plantillas

Herramienta	Descripción
`list_templates`	Explora la galería de plantillas
`use_template`	Crea un nuevo proyecto desde una plantilla

Cuenta

Herramienta	Descripción
`whoami`	Obtén la información del perfil del usuario autenticado
`get_credits`	Verifica el saldo restante de créditos de IA

Recursos

Los recursos proporcionan contexto de solo lectura que un cliente de IA puede recuperar sin llamar a una herramienta.

Recurso	Descripción
`projects`	Lista paginada de tus proyectos recientes
`project`	Datos completos de un solo proyecto por ID
`templates`	Catálogo de plantillas navegable

Cómo funciona

┌────────────────────┐   Streamable HTTP    ┌────────────────────────────┐
│   Your AI client    │   + Bearer API key   │   OpenCharts MCP (hosted)  │
│  Warp · Claude ·    │ ───────────────────► │                            │
│  Cursor · VS Code · │                      │  Projects · Code Canvas ·  │
│  Windsurf · Codex · │ ◄─────────────────── │  Agents · Sheets · Boards ·│
│  Amp · OpenCode     │      tool results    │  Symphony · Notes · AI     │
└────────────────────┘                      └────────────────────────────┘

Cada solicitud es autenticada por tu clave API y actúa en tu propia cuenta de OpenCharts. Como el servidor está alojado, la superficie de herramientas se mantiene actualizada automáticamente — no se requieren actualizaciones del cliente. Las herramientas que usan Theo AI o generación (por ejemplo ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song) consumen créditos de IA de tu plan.

Límites de tasa y créditos

120 solicitudes por minuto por usuario.
Las herramientas de IA y generación consumen créditos de IA — verifica tu saldo en cualquier momento con la herramienta get_credits.

Descubrimiento y registro

Se publican metadatos legibles por máquina para clientes, rastreadores y registros (sin secretos):

https://www.opencharts.com/.well-known/mcp — manifiesto de descubrimiento
https://www.opencharts.com/.well-known/mcp/server-card.json — tarjeta del servidor
https://www.opencharts.com/.well-known/oauth-protected-resource — metadatos de recursos protegidos
Documentos: opencharts.com/help/mcp-server

Solución de problemas

Redirección 307 / "sin soporte de autorización" / 401 — asegúrate de que la URL sea exactamente https://www.opencharts.com/api/mcp (con www.). El host principal elimina la cabecera Authorization en la redirección. También confirma que tu clave esté activa y se envíe con el prefijo Bearer .
429 Too Many Requests — has alcanzado el límite de 120 solicitudes/min; espera y reintenta.
Faltan herramientas en tu cliente — reinicia completamente el cliente (o desactiva y vuelve a activar el servidor OpenCharts) para que vuelva a obtener la lista de herramientas. Confirma que tu clave tenga los ámbitos read, write y ai (las claves predeterminadas incluyen los tres).
JWT expirado a mitad de sesión — los JWT de sesión expiran después de ~15 minutos; usa una clave API persistente para integraciones de larga duración.

Clientes compatibles

Funciona con cualquier cliente que soporte el Protocolo de Contexto de Modelo, incluyendo:

Warp — entorno de desarrollo agéntico
Claude Desktop y Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

Enlaces

🌐 Sitio web: opencharts.com
📖 Documentos MCP: opencharts.com/help/mcp-server
🔑 Obtener una clave API: opencharts.com/theo-agents/mcp
💬 Comunidad: opencharts.com/community
🐛 Incidencias: Incidencias en GitHub

Licencia

Esta documentación está licenciada bajo CC-BY-4.0. El servidor MCP de OpenCharts es un producto alojado — consulta opencharts.com para términos y precios.