Documentación · MCP para agentes

Gráficos mediante MCP

Un creador de gráficos con IA: conecta un asistente como Claude, ChatGPT, Cursor, Codex o cualquiera que use Model Context Protocol y tendrá cinco herramientas compartidas. El servidor local añade render_card, seis en total. Describe los datos y recibe una especificación validada, código para insertar o una imagen terminada.

Dos formas de conectar

Un enlace, sin instalación

Conector de IA En vivo

Ya disponible en ChatGPT y Claude. Busca «Meiku Charts» en las aplicaciones de ChatGPT o los conectores de Claude y conéctalo. No tienes que pegar ninguna URL.

Una dirección para cualquier cliente MCP, sin descargas ni configuración: 

https://meikucharts.com/mcp
  1. Añade un servidor MCP remoto en tu cliente de IA. En Claude y ChatGPT: Settings → Connectors; en Cursor, VS Code, Windsurf y Codex: sus ajustes MCP
  2. Pega la URL
  3. Inicia sesión con Google y pide un gráfico. Free incluye 10 visualizaciones al mes, compartidas por gráficos y tablas.

Inicia sesión en el conector de IA con la cuenta de Google vinculada a tu clave Pro para usar sus límites. Las imágenes SVG gratuitas llevan la marca meikucharts.com. En el conector de IA, render_chart devuelve SVG; PNG sigue disponible mediante el MCP local, descrito debajo.

El MCP local · Pro

Ejecútalo en tu ordenador

Pro incluye acceso al MCP local. Activa tu clave Pro en tu cuenta y descarga meiku-charts-mcp.zip. Instala Node.js 20 o posterior y sigue los pasos de configuración del MCP local. Compara los planes.

El MCP local se ejecuta en tu ordenador mediante stdio. Las imágenes PNG y tarjetas usan Chrome o Edge instalado; no se descarga otro navegador. Para otro navegador basado en Chromium, asigna su ejecutable a MEIKU_BROWSER_PATH. SVG funciona sin navegador.

Pon tu clave Pro en MEIKU_LICENSE_KEY en los ajustes del cliente MCP y reinícialo. El servidor lee la clave al arrancar; reinicia el cliente después de cambiarla. La licencia se comprueba en el primer uso de cada arranque y después una vez al día. Tras una comprobación correcta, funciona sin conexión hasta 7 días.

Pro cubre hasta 3 ordenadores; Team, 20. Para liberar plazas, quita MEIKU_LICENSE_KEY de los ordenadores que ya no uses y elige «Liberar todos los ordenadores…» en tu cuenta.

Tras renovar una suscripción caducada, el MCP local detecta el cambio en una hora; reiniciar no lo acelera. Si vuelves a comprar y recibes una clave Pro nueva, introdúcela primero en tu cuenta para trasladar tus sitios y la clave del sitio; después actualiza MEIKU_LICENSE_KEY y reinicia el cliente. Si cambias la clave en Polar, actualízala en cada ordenador y reinicia cada cliente. Hasta entonces, las herramientas pueden indicar wasn’t accepted o isn’t active. Consulta las respuestas exactas en mensajes del MCP local y ayuda.

Las cinco herramientas compartidas

prepare_visualization

Empieza por tus datos y lo que quieres mostrar. Tu asistente recibe una tabla o gráfico completo, código listo para insertar y una explicación de las funciones elegidas. Las tablas largas incluyen búsqueda y encabezados fijos. Se conservan los ajustes explícitos y las salvedades que proporciones.

prepare_visualization({
  "data": {
    "columns": ["Product", "Monthly cost", "Support"],
    "rows": [["A", 20, "yes"], ["B", 40, "partial"]]
  },
  "title": "Plan comparison"
})

Un resultado ready puede mostrarse inmediatamente. Las preguntas opcionales, como añadir una fuente, no lo bloquean. Un resultado needs_input identifica una corrección necesaria y no contiene código para insertar. Los números ambiguos siguen como texto; los datos ausentes nunca se convierten en ceros inventados. Para celdas con notas completas o una visualización existente, pasa el spec completo en lugar de data.

Para datos numéricos, establece intent en compare, trend, share o point. Usa share solo para partes de un total. Las etiquetas pueden redondear o abreviar; la respuesta avisa si los valores exactos necesitan texto adicional. Pega datos estructurados en lugar de CSV sin procesar para evitar ambigüedad en vacíos y separadores decimales.

create_chart

La especificación se convierte en código para insertar. Primero la valida el analizador del motor, de modo que el agente recibe una especificación validada. Si es incorrecta, devuelve errores {path, message, hint} que el agente puede corregir en otro intento.

create_chart({
  "type": "column",
  "theme": "editorial",
  "data": {
    "labels": ["Q1", "Q2", "Q3", "Q4"],
    "series": [{ "name": "Revenue", "values": [48, 52, 47, 61] }]
  }
})
// -> a validated, paste-ready <live-chart> embed snippet

Para una advertencia con explicación propia, mantén la columna como texto y envía la celda como { "text": "Limited claim", "kind": "warn", "note": "Full explanation" }. El botón ! abre la nota completa, hasta 4000 caracteres Unicode. noteText y detail no son campos compatibles. Comprueba que la especificación normalizada devuelta contenga tu nota antes de insertar. Puedes pegar la especificación completa en el creador de tablas y descargar JSON para conservar los tipos de celda y la estructura.

suggest_chart

La herramienta recibe filas y recomienda una vista: analiza cuántas series y puntos hay y si los números son enteros. Devuelve un tipo de gráfico, la razón y una especificación lista para pasar a las demás herramientas.

list_themes

Diez estilos: cinco temas, cada uno en claro y oscuro, con descripciones para que un agente elija el adecuado para su página. Una prueba de divergencias los mantiene sincronizados con el registro de temas del motor.

render_chart

Todo el proceso en una llamada: especificación de entrada e imagen terminada en la conversación. El conector de IA genera SVG mediante cálculo puro, sin navegador. El MCP local también genera PNG con un navegador sin interfaz al doble de resolución; el PNG alojado está previsto.

render_chart({
  ...the same spec fields...
  "format": "svg"   // hosted renders SVG; the local MCP adds "png"
})
// -> the finished image, straight into the conversation

La sexta herramienta: tarjetas locales

render_card

El MCP local también genera tarjetas infográficas con render_card, usando Chrome o Edge instalado. Esta herramienta solo está disponible en el servidor local, junto a las cinco compartidas.

Límites que conviene conocer

El conector de IA incluye 10 visualizaciones al mes con Free, 500 con Pro y 5000 con Team. Gráficos y tablas comparten una cuota por cuenta, que se restablece el día 1 de cada mes (UTC). Sus gráficos admiten hasta 1000 puntos con Free y 5000 con Pro y Team.

Crear una inserción, preparar una visualización con resultado ready o generar una imagen consume una visualización por acción. Las sugerencias y listas de temas no consumen cuota. Solo cuentan los resultados correctos. Recibes un aviso al 80 %. Crear un gráfico y después generar su imagen son usos separados.

También hay límites de protección para entradas y renderizado: hasta 10.000 valores por llamada, 10.000 puntos dibujados en un diagrama de puntos y 16,8 millones de píxeles por PNG. No aumentan el límite de puntos en la nube ni la cuota mensual de tu plan. Respeta las respuestas que pidan reducir la frecuencia. Los errores tienen la misma estructura que en el resto del producto.

El conector genera SVG; el MCP local también genera PNG. Lee las normas de uso razonable y las condiciones de licencia.