Table Charts

# @tablecharts/mcp-server

Servidor MCP para TableCharts — transforme tabelas (CSV, JSON, Notion, Google Sheets, Salesforce) em dashboards interativos compartilháveis, diretamente do Claude, Cursor, VS Code ou qualquer outro cliente MCP.

Por quê

LLMs são ótimos em produzir dados estruturados, mas péssimos em produzir gráficos reais. Este servidor oferece a qualquer assistente compatível com MCP uma ferramenta de uma única etapa para converter dados tabulares em um dashboard hospedado e incorporável com uma URL pública.

Instalação

npm i -g @tablecharts/mcp-server

Ou execute sob demanda com npx -y @tablecharts/mcp-server — sem necessidade de instalação.

Obtenha uma chave de API

1. Cadastre-se em https://tablecharts.co
2. Abra https://tablecharts.co/api-keys
3. Crie uma chave começando com tc_live_…

Configure seu cliente MCP

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tablecharts": {
      "command": "npx",
      "args": ["-y", "@tablecharts/mcp-server"],
      "env": {
        "TABLECHARTS_API_KEY": "tc_live_..."
      }
    }
  }
}

Reinicie o Claude Desktop. A ferramenta generate_dashboard aparecerá no menu de ferramentas.

Cursor

Adicione a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tablecharts": {
      "command": "npx",
      "args": ["-y", "@tablecharts/mcp-server"],
      "env": { "TABLECHARTS_API_KEY": "tc_live_..." }
    }
  }
}

VS Code (com extensão MCP)

{
  "mcp.servers": {
    "tablecharts": {
      "command": "npx",
      "args": ["-y", "@tablecharts/mcp-server"],
      "env": { "TABLECHARTS_API_KEY": "tc_live_..." }
    }
  }
}

Ferramentas

Ferramenta	Descrição
generate_dashboard	Crie um dashboard a partir de data (linhas JSON), csv (string) ou source_url (Notion / Google Sheets / Salesforce). Retorna dashboard_url, embed_url, iframe_code.
list_chart_types	Retorna os 6 tipos de gráfico suportados: bar, line, area, pie, scatter, radar.

Exemplos de prompts

• "Crie um gráfico da minha receita mensal: Jan 12k, Fev 15k, Mar 18k, Abr 22k. Use TableCharts."
• "Puxe este banco de dados do Notion e crie um dashboard: https://notion.so/…"
• "Pegue este CSV e escolha automaticamente o melhor tipo de gráfico."

Variáveis de ambiente

Variável	Obrigatória	Descrição
TABLECHARTS_API_KEY	sim	Sua chave tc_live_… de https://tablecharts.co/api-keys
TABLECHARTS_API_BASE	não	Substitua a base da API (padrão https://tablecharts.co)

Limites

• Plano gratuito: 3 gráficos salvos, 30 solicitações/minuto.
• Plano Pro: gráficos ilimitados, limpeza por IA, recomendação de gráficos por IA, cores personalizadas, sem marca d'água.

Licença

MIT