szum

Servidor MCP

Conecta ChatGPT, Claude, Cursor, VS Code y otros agentes de IA al sistema de diseño de gráficos Szum.

El servidor MCP de Szum proporciona a los agentes de IA los tipos de gráficos actuales, temas seleccionados, ejemplos, validación, renderizado y herramientas de gráficos guardados que necesitan para producir gráficos considerados de manera confiable.

Inicio rápido

Conecta tu cliente MCP a:

https://szum.io/mcp

Las herramientas públicas de descubrimiento, validación y vista previa funcionan sin autenticación. Las herramientas de gráficos guardados requieren OAuth o una clave API Bearer.

Después de conectarte, solicita un gráfico en lenguaje ordinario:

Muestra los ingresos trimestrales por región como un gráfico de columnas editorial. Cita la fuente, previsualízalo y guarda el gráfico final después de que lo apruebe.

El agente puede descubrir los tipos de gráficos compatibles, construir y validar una solicitud, renderizar una vista previa temporal en clientes compatibles, o guardar un documento permanente con enlaces estables de imagen y de inserción.

Conectar desde ChatGPT

1. Habilita el Modo desarrollador en ChatGPT en Configuración → Seguridad e inicio de sesión.
2. Abre ChatGPT Plugins y usa el botón de más para añadir una conexión.
3. Dale un nombre y una descripción, e ingresa https://szum.io/mcp en Conexión.
4. Crea la conexión, revisa las herramientas descubiertas y completa la autorización cuando se te solicite.
5. Añade la conexión desde el menú de herramientas en una nueva conversación.

La disponibilidad depende de la cuenta y la política del espacio de trabajo. Consulta la guía de conexión de OpenAI para conocer el flujo actual.

Conectar desde Claude

Abre Charts by Szum en el Directorio de Conectores de Claude y sigue las indicaciones de conexión.

Claude puede pedirte que autorices Szum cuando uses herramientas que acceden a gráficos guardados. Las vistas previas anónimas funcionan sin una cuenta de Szum.

Conectar desde Claude Code

1. Elige un nombre de servidor, reemplaza SERVER_NAME en el comando a continuación y ejecútalo en tu terminal.
2. Abre Claude Code e ingresa /mcp.
3. Selecciona el servidor que añadiste y completa el flujo de autenticación en el navegador.

claude mcp add --transport http SERVER_NAME https://szum.io/mcp

Consulta la guía MCP de Claude Code para conocer las opciones de conexión y autenticación.

Conectar desde Cursor

1. Abre tu ~/.cursor/mcp.json global, o el .cursor/mcp.json de un proyecto.
2. Reemplaza SERVER_NAME con el nombre de servidor que elijas, añade la configuración a continuación y guarda el archivo.
3. Reinicia Cursor y completa la autenticación cuando se te solicite.

{
  "mcpServers": {
    "SERVER_NAME": {
      "url": "https://szum.io/mcp"
    }
  }
}

Consulta la guía de configuración MCP de Cursor para conocer las opciones de configuración actuales.

Conectar desde VS Code

1. Abre la Paleta de Comandos y ejecuta MCP: Add Server.
2. Elige HTTP, pega el endpoint y establece el nombre del servidor.
3. Elige si instalarlo globalmente o en el espacio de trabajo actual.
4. Inicia el servidor, confirma que confías en él y completa la autorización cuando se te solicite.

{
  "servers": {
    "SERVER_NAME": {
      "type": "http",
      "url": "https://szum.io/mcp"
    }
  }
}

La guía de servidores MCP de VS Code cubre la configuración del espacio de trabajo y del perfil de usuario.

Descubre gráficos compatibles

• list_chart_types devuelve las seis familias actuales más los campos compartidos y específicos de cada familia.
• list_themes devuelve los temas seleccionados y sus usos previstos.
• get_examples({ chart_type?, purpose?, features?, example_id? }) devuelve documentos actuales completos con IDs estables, una explicación de use_when y metadatos de propósito/características. Sin filtros devuelve seis puntos de partida; cualquier filtro busca en el catálogo completo. Todos los filtros suministrados se cruzan, y cada característica solicitada debe coincidir.
• validate_chart({ chart }) valida un documento JSON o una configuración compatible de 2026-03-20 sin renderizar ni guardar.

Usa list_chart_types para descubrir los tipos de gráficos compatibles, sus roles de datos y sus campos.

Los valores de filtro de ejemplo se anuncian directamente en el esquema de entrada de la herramienta. El propósito describe la pregunta del gráfico; las características describen técnicas como anotaciones, referencias, intervalos, normalización y datos anchos. distribution significa frecuencias categóricas, no agrupación automática en histogramas. Usa un example_id devuelto por un resultado anterior para una recuperación exacta.

get_examples({ features: ["annotations"] });
get_examples({ chart_type: "scatter", features: ["intervals", "annotations"] });
get_examples({ purpose: "composition", features: ["normalized"] });
get_examples({ example_id: "grouped-wide" });

Un resultado vacío significa que ningún ejemplo satisface todos los filtros; elimina uno para ampliar la búsqueda. Los ejemplos usan datos ilustrativos. El libro de recetas muestra el mismo catálogo. Su ejemplo de datos faltantes produce intencionalmente una advertencia de brecha.

El recurso szum://schema expone el ChartConfig JSON Schema actual sin datos. szum://llms-txt documenta el documento de gráfico completo, los resultados de validación, el renderizado y las operaciones de gráficos guardados.

Trabaja con gráficos

Necesidad	Herramienta	Resultado
Descubre familias de gráficos	list_chart_types	Roles actuales y campos específicos de familia
Encuentra un punto de partida	get_examples	Documentos actuales listos para usar
Verifica solo la entrada	validate_chart	Hallazgos estructurados sin efectos de imagen o almacenamiento
Previsualiza un gráfico	render_chart	Vista previa interactiva de App, URLs de imagen públicas temporales y estado de entrada duradera
Conserva y comparte un gráfico	save_chart	URLs permanentes de imagen, inserción, editor y Studio
Encuentra gráficos guardados	list_charts	Metadatos de gráficos paginados y URLs
Abre un gráfico guardado	get_chart	Metadatos, URLs y visualización en línea cuando está publicado
Lee su definición	get_chart_document	Documento publicado completo para inspección o reutilización
Reemplaza un gráfico guardado	update_chart	Nueva publicación con el mismo id y URLs
Renombra un gráfico guardado	rename_chart	Título de biblioteca actualizado sin cambiar el documento
Elimina un gráfico guardado	delete_chart	Eliminación permanente y segura para reintentos
Restaura el estado de la App	get_preview_state	Si una vista previa de App sigue siendo transitoria o fue guardada

Las herramientas de gráficos guardados requieren autenticación. get_chart devuelve metadatos y URLs, no el documento en la salida visible del modelo. get_chart_document devuelve el documento publicado y nunca sustituye un borrador de Studio más reciente. update_chart rechaza actualizaciones Bearer/MCP mientras existan cambios de editor no publicados, por lo que no puede descartar silenciosamente trabajo más reciente.

Valida, previsualiza y luego guarda

Valida cada entrada generada o modificada una vez antes de su siguiente renderizado, guardado o actualización. La validación se aplica a ese valor exacto y no debe repetirse mientras permanezca sin cambios. Un renderizado exitoso devuelve la entrada duradera exacta a usar a continuación cuando no queda pérdida de compatibilidad.

Los errores bloquean. Las advertencias deben mostrarse al usuario y requieren acknowledgeWarnings: true solo después de la aprobación de la entrada exacta. Las sugerencias nunca bloquean y nunca se aplican automáticamente. Un suggestedDocument es un reemplazo completo y validado. Revisa los cambios propuestos antes de usarlo; valida nuevamente solo si lo modificas.

render_chart({ request, acknowledgeWarnings? }) acepta una cadena JSON que contiene un documento actual o una configuración compatible de 2026-03-20. Almacena una vista previa de 1 hora y devuelve URLs de imagen temporales. Su durableInput es ready con el documento actual, o loss_acceptance_required con cada código de pérdida de compatibilidad y sin documento que pueda eludir la aceptación.

Después de que el usuario apruebe la vista previa finalizada, guarda durableInput.document cuando su estado sea ready. Para loss_acceptance_required, muestra cada código de pérdida, obtén aprobación explícita y luego llama a save_chart con la configuración anterior original y la lista completa de acceptLosses. Una App compatible ofrece su acción de guardado directo solo para entrada ready. save_chart puede reutilizar la identidad de la vista previa de la App; de lo contrario, envía un idempotencyKey estable para el gráfico previsto y reutilízalo en los reintentos. La misma clave y documento devuelven el mismo gráfico. La misma clave con contenido diferente entra en conflicto.

Privacidad y retención de vistas previas

Las URLs de imagen temporales son capacidades públicas: cualquiera que tenga la URL imposible de adivinar puede obtener el gráfico durante la ventana de retención. Obtén consentimiento explícito del usuario antes de renderizar datos sensibles, privados o no públicos.

En clientes que admiten MCP Apps, la vista previa interactiva puede renderizar desde metadatos de resultados ocultos sin obtener una imagen estática pública. PNG, SVG y las acciones de respaldo/apertura usan URLs de /r/{id} que permanecen disponibles durante 1 hora; cada imagen producida puede almacenarse en caché durante 1 hora.

Una vista previa autenticada consume un renderizado de cuenta. Cada imagen posterior producida desde una URL devuelta es otro renderizado. Una vista previa interactiva anónima es complementaria; sus imágenes estáticas posteriores usan la asignación de imágenes anónimas separada.

Documentos guardados y configuraciones anteriores

save_chart y update_chart aceptan un ChartDocument actual completo o una configuración compatible de 2026-03-20 codificada como una cadena JSON. Usa el documento actual validado exacto, o la entrada anterior exacta junto con cualquier código de pérdida aprobado explícitamente.

Las configuraciones compatibles de 2026-03-20 se convierten a la forma del documento actual. La validación expone compatibility.classification y sus códigos estables de pérdida o no compatibles. La entrada de exact y normalized puede renderizarse y guardarse. La entrada de lossy puede renderizarse, pero las escrituras duraderas requieren que acceptLosses nombre cada código después de que el usuario los apruebe. La entrada de unsupported permanece sin cambios y no puede renderizarse ni guardarse.

Consulta compatibilidad de configuraciones anteriores para conocer las asignaciones de gráficos compatibles y las listas de códigos completas.

Fallos de herramientas

Los fallos de herramientas usan un sobre de texto JSON estable con status y un error que contiene code, message y retryable. Los resultados de error omiten el structuredContent con forma de éxito. Los errores de revisión incluyen diagnostics y cualquier campo aplicable de compatibility o suggestedDocument en su texto JSON. Las llamadas completadas de validate_chart devuelven la forma de resultado de validación descrita anteriormente.

Usa los códigos de error y la capacidad de reintento para la automatización. No analices mensajes humanos. Un fallo de almacenamiento o credencial reintentable es diferente de un desafío OAuth y debe informarse como temporal en lugar de como una solicitud para reconectarse a ciegas.

Autenticación

No se necesitan credenciales para conectarse, inspeccionar el sistema de diseño, validar entrada o crear una vista previa anónima. Los clientes con capacidad OAuth autorizan el acceso al guardar, listar, abrir, leer, actualizar, renombrar o eliminar gráficos de la biblioteca del usuario.

Si un cliente no admite OAuth, crea una clave API y envíala como token Bearer:

{
  "mcpServers": {
    "SERVER_NAME": {
      "type": "http",
      "url": "https://szum.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Mantén las claves fuera de los archivos de proyecto compartidos. Consulta Autenticación para conocer el modelo completo.

Uso y facturación

El ingreso MCP permite 100 solicitudes por segundo por IP. Las credenciales autenticadas además usan el bucket de credenciales de clave API/OAuth.

Una vista previa autenticada de render_chart cuenta contra el límite del plan del usuario con sesión iniciada. Cada imagen producida posteriormente desde su URL temporal es otro renderizado contra esa cuenta. Las vistas previas interactivas anónimas son complementarias; sus URLs de imagen temporales usan una asignación separada de 250 imágenes por mes, cobradas solo cuando se produce una imagen de origen.

El descubrimiento, los ejemplos, los temas, la validación, las lecturas de metadatos de gráficos guardados y la restauración del estado de vista previa de la App no consumen cuota de renderizado.

[

Qué es Szum

Un sistema de diseño de gráficos construido en torno a tipos de gráficos orientados a propósito, temas seleccionados y salida consistente.

](https://szum.io/docs/what-is-szum)[

Inicio rápido

Crea, personaliza, exporta y publica un gráfico Szum en tu navegador. No se requiere registro para comenzar.

](https://szum.io/docs/editor)