szum

Renderize imagens de gráficos a partir de configurações JSON com seis temas, dez marcas, saída em PNG/SVG.

Ver em szum.ioExperimente este MCPPatrocinado

Documentação

Servidor MCP

Conecte ChatGPT, Claude, Cursor, VS Code e outros agentes de IA ao sistema de design de gráficos Szum.

O servidor MCP Szum fornece aos agentes de IA os tipos de gráficos atuais, temas selecionados, exemplos, validação, renderização e ferramentas de gráficos salvos necessários para produzir gráficos bem elaborados de forma confiável.

Início rápido

Conecte seu cliente MCP a:

https://szum.io/mcp

Ferramentas públicas de descoberta, validação e pré-visualização funcionam sem autenticação. Ferramentas de gráficos salvos exigem OAuth ou uma chave de API Bearer.

Após conectar, peça um gráfico em linguagem comum:

Mostre a receita trimestral por região como um gráfico de colunas editoriais. Cite a fonte, pré-visualize e salve o gráfico finalizado após minha aprovação.

O agente pode descobrir os tipos de gráficos suportados, construir e validar uma solicitação, renderizar uma pré-visualização temporária em clientes compatíveis ou salvar um documento permanente com links estáveis de imagem e incorporação.

Conectar a partir do ChatGPT

Ative o Modo desenvolvedor em Configurações do ChatGPT → Segurança e login.
Abra Plugins do ChatGPT e use o botão de adição para criar uma conexão.
Dê um nome e uma descrição, e insira https://szum.io/mcp em Conexão.
Crie a conexão, revise as ferramentas descobertas e conclua a autorização quando solicitado.
Adicione a conexão pelo menu de ferramentas em uma nova conversa.

A disponibilidade depende da conta e da política do espaço de trabalho. Consulte o guia de conexão da OpenAI para o fluxo atual.

Conectar a partir do Claude

Abra Gráficos por Szum no Diretório de Conectores do Claude e siga os prompts de conexão.

O Claude pode solicitar que você autorize a Szum ao usar ferramentas que acessam gráficos salvos. Pré-visualizações anônimas funcionam sem uma conta Szum.

Conectar a partir do Claude Code

Escolha um nome de servidor, substitua SERVER_NAME no comando abaixo e execute-o no seu terminal.
Abra o Claude Code e digite /mcp.
Selecione o servidor que você adicionou e conclua o fluxo de autenticação no navegador.

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

Consulte o guia MCP do Claude Code para opções de conexão e autenticação.

Conectar a partir do Cursor

Abra seu ~/.cursor/mcp.json global ou o .cursor/mcp.json de um projeto.
Substitua SERVER_NAME pelo nome de servidor escolhido, adicione a configuração abaixo e salve o arquivo.
Reinicie o Cursor e conclua a autenticação quando solicitado.

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

Consulte o guia de configuração MCP do Cursor para as opções atuais de configuração.

Conectar a partir do VS Code

Abra a Paleta de Comandos e execute MCP: Adicionar Servidor.
Escolha HTTP, cole o endpoint e defina o nome do servidor.
Escolha se deseja instalá-lo globalmente ou no espaço de trabalho atual.
Inicie o servidor, confirme que você confia nele e conclua a autorização quando solicitado.

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

O guia de servidor MCP do VS Code cobre a configuração de espaço de trabalho e perfil de usuário.

Descobrir gráficos suportados

list_chart_types retorna as seis famílias atuais, além de campos compartilhados e específicos de cada família.
list_themes retorna os temas selecionados e seus usos pretendidos.
get_examples({ chart_type?, purpose?, features?, example_id? }) retorna documentos atuais completos com IDs estáveis, uma explicação de use_when e metadados de propósito/recursos. Sem filtros, retorna seis pontos de partida; qualquer filtro pesquisa o catálogo completo. Todos os filtros fornecidos se cruzam, e cada recurso solicitado deve corresponder.
validate_chart({ chart }) valida um documento JSON ou uma configuração 2026-03-20 suportada sem renderizar ou salvar.

Use list_chart_types para descobrir os tipos de gráficos suportados, suas funções de dados e seus campos.

Valores de filtro de exemplo são anunciados diretamente no esquema de entrada da ferramenta. Propósito descreve a pergunta do gráfico; recursos descrevem técnicas como anotações, referências, intervalos, normalização e dados amplos. distribution significa frequências categóricas, não agrupamento automático em histograma. Use um example_id retornado por um resultado anterior para recuperação exata.

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

Um resultado vazio significa que nenhum exemplo satisfaz todos os filtros; remova um para ampliar a busca. Os exemplos usam dados ilustrativos. O livro de receitas exibe o mesmo catálogo. Seu exemplo de dados ausentes produz intencionalmente um aviso de lacuna.

O recurso szum://schema expõe o atual ChartConfig JSON Schema sem dados. szum://llms-txt documenta o documento de gráfico completo, resultados de validação, renderização e operações de gráficos salvos.

Trabalhar com gráficos

Necessidade	Ferramenta	Resultado
Descobrir famílias de gráficos	`list_chart_types`	Funções atuais e campos específicos de cada família
Encontrar um ponto de partida	`get_examples`	Documentos atuais prontos para uso
Verificar apenas a entrada	`validate_chart`	Resultados estruturados sem efeitos de imagem ou armazenamento
Pré-visualizar um gráfico	`render_chart`	Pré-visualização interativa do App, URLs públicas temporárias de imagem e status de entrada durável
Manter e compartilhar um gráfico	`save_chart`	URLs permanentes de imagem, incorporação, editor e Studio
Encontrar gráficos salvos	`list_charts`	Metadados e URLs de gráficos paginados
Abrir um gráfico salvo	`get_chart`	Metadados, URLs e exibição inline quando publicado
Ler sua definição	`get_chart_document`	Documento publicado completo para inspeção ou reutilização
Substituir um gráfico salvo	`update_chart`	Nova publicação com o mesmo id e URLs
Renomear um gráfico salvo	`rename_chart`	Título atualizado na biblioteca sem alterar o documento
Excluir um gráfico salvo	`delete_chart`	Exclusão permanente e segura para novas tentativas
Restaurar estado do App	`get_preview_state`	Se uma pré-visualização do App ainda é transitória ou foi salva

Ferramentas de gráficos salvos exigem autenticação. get_chart retorna metadados e URLs, não o documento na saída visível ao modelo. get_chart_document retorna o documento publicado e nunca substitui um rascunho mais recente do Studio. update_chart recusa atualizações Bearer/MCP enquanto existirem alterações não publicadas no editor, portanto não pode descartar silenciosamente trabalho mais recente.

Validar, pré-visualizar e depois salvar

Valide cada entrada gerada ou alterada uma vez antes da próxima renderização, salvamento ou atualização. A validação se aplica a esse valor exato e não deve ser repetida enquanto ele permanecer inalterado. Uma renderização bem-sucedida retorna a entrada durável exata a ser usada em seguida quando não houver mais perda de compatibilidade.

Erros bloqueiam. Avisos devem ser mostrados ao usuário e exigem acknowledgeWarnings: true somente após a aprovação da entrada exata. Sugestões nunca bloqueiam e nunca são aplicadas automaticamente. Um suggestedDocument é uma substituição completa e validada. Revise as alterações propostas antes de usá-lo; valide novamente somente se você o modificar.

render_chart({ request, acknowledgeWarnings? }) aceita uma string JSON contendo um documento atual ou uma configuração 2026-03-20 suportada. Ele armazena uma pré-visualização de 1 hora e retorna URLs temporárias de imagem. Seu durableInput é ready com o documento atual, ou loss_acceptance_required com todos os códigos de perda de compatibilidade e nenhum documento que possa contornar a aceitação.

Após o usuário aprovar a pré-visualização finalizada, salve durableInput.document quando seu status for ready. Para loss_acceptance_required, mostre cada código de perda, obtenha aprovação explícita e então chame save_chart com a configuração antiga original e a lista completa de acceptLosses. Um App compatível oferece sua ação direta de salvamento apenas para entrada ready. save_chart pode reutilizar a identidade da pré-visualização do App; caso contrário, envie um idempotencyKey estável para o gráfico pretendido e reutilize-o em novas tentativas. A mesma chave e documento retornam o mesmo gráfico. A mesma chave com conteúdo diferente gera conflito.

Privacidade e retenção da pré-visualização

URLs temporárias de imagem são capacidades públicas: qualquer pessoa que detenha a URL impossível de adivinhar pode buscar o gráfico durante a janela de retenção. Obtenha consentimento explícito do usuário antes de renderizar dados sensíveis, privados ou não públicos.

Em clientes que suportam MCP Apps, a pré-visualização interativa pode renderizar a partir de metadados ocultos do resultado sem buscar uma imagem estática pública. PNG, SVG e ações de fallback/abertura usam URLs /r/{id} que permanecem disponíveis por 1 hora; cada imagem produzida pode ser armazenada em cache por 1 hora.

Uma pré-visualização autenticada consome uma renderização da conta. Cada imagem posterior produzida a partir de uma URL retornada é outra renderização. Uma pré-visualização interativa anônima é complementar; suas imagens estáticas posteriores usam a cota separada de imagens anônimas.

Documentos salvos e configurações antigas

save_chart e update_chart aceitam um ChartDocument atual completo ou uma configuração 2026-03-20 suportada codificada como string JSON. Use o documento atual validado exato, ou a entrada antiga exata juntamente com quaisquer códigos de perda explicitamente aprovados.

Configurações 2026-03-20 suportadas são convertidas para a forma atual do documento. A validação expõe compatibility.classification e seus códigos estáveis de perda ou não suportados. Entrada exact e normalized pode ser renderizada e salva. Entrada lossy pode renderizar, mas gravações duráveis exigem acceptLosses para nomear cada código após a aprovação do usuário. Entrada unsupported permanece inalterada e não pode ser renderizada ou salva.

Consulte compatibilidade de configurações antigas para os mapeamentos de gráficos suportados e listas completas de códigos.

Falhas de ferramentas

Falhas de ferramentas usam um envelope de texto JSON estável com status e um error contendo code, message e retryable. Resultados de erro omitem structuredContent em formato de sucesso. Resultados de revisão incluem diagnostics e quaisquer campos aplicáveis de compatibility ou suggestedDocument em seu texto JSON. Chamadas concluídas de validate_chart retornam a forma de resultado de validação descrita acima.

Use códigos de erro e capacidade de nova tentativa para automação. Não analise mensagens humanas. Uma falha de armazenamento ou credencial com nova tentativa é diferente de um desafio OAuth e deve ser relatada como temporária, em vez de uma solicitação para reconectar cegamente.

Autenticação

Nenhuma credencial é necessária para conectar, inspecionar o sistema de design, validar entrada ou criar uma pré-visualização anônima. Clientes com capacidade OAuth autorizam o acesso ao salvar, listar, abrir, ler, atualizar, renomear ou excluir gráficos da biblioteca do usuário.

Se um cliente não suportar OAuth, crie uma chave de API e envie-a como token Bearer:

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

Mantenha as chaves fora de arquivos de projeto compartilhados. Consulte Autenticação para o modelo completo.

Uso e cobrança

O ingresso MCP permite 100 solicitações por segundo por IP. Credenciais autenticadas também usam o bucket de credenciais de chave de API/OAuth.

Uma pré-visualização autenticada de render_chart conta contra o limite do plano do usuário conectado. Cada imagem posteriormente produzida a partir de sua URL temporária é outra renderização contra essa conta. Pré-visualizações interativas anônimas são complementares; suas URLs temporárias de imagem usam uma cota separada de 250 imagens por mês, cobrada somente quando uma imagem de origem é produzida.

Descoberta, exemplos, temas, validação, leituras de metadados de gráficos salvos e restauração de estado de pré-visualização do App não consomem cota de renderização.

[

O que é Szum

Um sistema de design de gráficos construído em torno de tipos de gráficos orientados a propósito, temas selecionados e saída consistente.

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

Início rápido

Crie, personalize, exporte e publique um gráfico Szum no seu navegador. Sem necessidade de cadastro para começar.

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