OpenCharts MCP

oficial

Conecte seu agente de IA ao OpenCharts—crie planilhas, quadros, músicas e automações a partir do Claude Code, Codex ou Cursor sem sair do terminal.

GitHub

O que você pode fazer com Open Charts MCP?

Criar e gerenciar projetos — Crie fluxogramas, quadros brancos, notas, apresentações e muito mais usando ferramentas como create_flowchart, create_whiteboard, create_notes e create_presentation.
Trabalhar com planilhas — Inspecione, leia, crie e edite Theo Sheets com suporte a fórmulas usando inspect_sheet, get_sheet, create_sheet, update_sheet e edit_sheet.
Criar e executar automações — Crie, configure, ative e execute Theo Agents com build_agent, create_agent, configure_agent_trigger e run_agent.
Gerenciar quadros Kanban — Crie quadros, adicione e atualize cartões e gerencie listas com create_board, add_board_card, update_board_card e list_board_cards.
Gerar sites e músicas — Construa sites ou aplicativos completos com generate_code_canvas e crie músicas com create_song, depois consulte o status com get_code_canvas_status e get_song_status.
Verificar conta e créditos — Confirme sua conexão com whoami e monitore o uso de créditos de IA com get_credits.

Documentação

Servidor MCP OpenCharts

Crie fluxogramas, notas, slides, planilhas, quadros, sites, agentes e músicas no OpenCharts — diretamente do seu cliente de IA.

Website · Documentação · Obter uma chave de API · Problemas

O que é isso?

O OpenCharts executa um servidor Model Context Protocol (MCP) público e hospedado que coloca todo o produto OpenCharts dentro de qualquer cliente de IA compatível com MCP. Conecte-se uma vez com uma chave de API e seu assistente poderá criar e gerenciar projetos reais do OpenCharts em seu nome — fluxogramas, quadros brancos, notas, apresentações, planilhas (Theo Sheets), quadros Kanban + calendário, sites e aplicativos completos (Code Canvas), automações (Theo Agents) e músicas (Theo Symphony) — tudo com o poder do Theo, a IA do OpenCharts.

É um servidor remoto via HTTP Transmissível — não há nada para instalar ou executar localmente. Aponte seu cliente para o endpoint, cole sua chave de API e pronto.

Este repositório é a documentação pública para esse servidor. O servidor em si é hospedado pelo OpenCharts; você não o executa.

Quer se conectar em menos de um minuto? Use o guia no aplicativo em opencharts.com/help/mcp-server ou a página de configuração em opencharts.com/theo-agents/mcp.

Início rápido

Crie uma chave de API em opencharts.com/theo-agents/mcp. Copie-a imediatamente — a chave completa é exibida apenas uma vez.
Adicione o servidor ao seu cliente de IA usando o trecho de configuração correspondente abaixo, substituindo {{YOUR_API_KEY}} pela sua chave.
Verifique a conexão pedindo ao seu assistente para chamar a ferramenta whoami — ela deve retornar sua conta OpenCharts.

Endpoint

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

Transporte: HTTP Transmissível (POST)
Autenticação: Authorization: Bearer <API key> (um JWT de uma sessão ativa do OpenCharts também funciona)

⚠️ Sempre use o host www.. O apex opencharts.com emite um redirecionamento 307 que remove o cabeçalho Authorization e quebra a autenticação. Use https://www.opencharts.com/api/mcp exatamente.

Conecte seu cliente de IA

O servidor funciona com qualquer cliente compatível com MCP. Copie o trecho correspondente e troque pela sua chave de API. Prefere que seu assistente faça a configuração? A página de ajuda tem um "prompt de configuração de IA" de colagem única para cada cliente abaixo.

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)

Adicione ao .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

Na extensão do 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}}"
      }
    }
  }
}

Ferramentas

O servidor expõe 56 ferramentas em 10 grupos. Ferramentas que usam Theo AI ou geração consomem créditos de IA.

Projetos

Ferramenta	Descrição
`list_projects`	Liste seus projetos com paginação e filtros
`get_project`	Obtenha dados completos do projeto por ID
`create_flowchart`	Crie um projeto de fluxograma com nós e arestas
`create_whiteboard`	Crie um quadro branco com formas e elementos nativos
`create_notes`	Crie um projeto de notas a partir de Markdown
`create_presentation`	Crie uma apresentação de slides a partir de um esboço
`update_project`	Atualize metadados ou conteúdo (notas, fluxograma, quadro branco ou apresentação)
`delete_project`	Excluir temporariamente um projeto (recuperação em 30 dias)

Code Canvas

Ferramenta	Descrição
`generate_code_canvas`	Construa um site ou aplicativo completo (HTML/React) a partir de uma descrição — retorna um job para consultar
`get_code_canvas_status`	Consulte um build do Code Canvas; retorna o projeto + URL aberta quando pronto

IA

Ferramenta	Descrição
`ask_theo`	Envie uma mensagem de IA de turno único (modo rápido ou pensar)
`extract_flowchart`	Extraia um fluxograma de um documento enviado (PDF, imagem, PPTX)

Theo Agents

Ferramenta	Descrição
`build_agent`	Construa um Theo Agent a partir de uma descrição — executa em segundo plano, notifica quando pronto
`get_agent_build_status`	Consulta opcional para um job `build_agent`; retorna o agente + URL aberta quando concluído
`create_agent`	Crie um Theo Agent deterministicamente a partir de etapas estruturadas + gatilho
`update_agent`	Atualize o nome, descrição ou lista de etapas de um agente
`configure_agent_trigger`	Defina o gatilho de um agente (manual, agendamento, webhook, evento, telegram)
`activate_agent`	Ative um agente (inicia a primeira execução agendada)
`deactivate_agent`	Desative um agente para que os gatilhos parem de disparar
`delete_agent`	Excluir temporariamente um agente (recuperação em 30 dias)
`list_agents`	Liste seus Theo Agents com status + contagens de etapas
`get_agent`	Obtenha a definição completa de um agente (gatilho + etapas ordenadas)
`run_agent`	Despache um agente agora — executa em segundo plano, notifica você na conclusão
`list_agent_runs`	Liste as execuções recentes de um agente
`get_agent_run_status`	Obtenha o status de uma única execução + progresso por nó

Theo Sheets

Ferramenta	Descrição
`list_sheets`	Liste seus projetos de planilha Theo Sheets
`inspect_sheet`	Inspecione uma planilha — dimensões por aba, linha de cabeçalho, células e fórmulas amostradas, layout
`get_sheet`	Extraia uma planilha como linhas estruturadas (cabeçalhos + linhas de dados)
`read_sheet_range`	Leia os valores de um intervalo A1 exato (+ fórmulas opcionais) como uma grade + CSV
`create_sheet`	Crie uma planilha ao vivo (grade + fórmulas de nível Excel) a partir de cabeçalhos e linhas
`update_sheet`	Edite uma planilha aplicando operações de edição de planilha estruturadas — salvas como um commit reversível
`apply_sheet_ops`	Aplique operações de edição de planilha estruturadas — ou proponha uma alteração com bloqueio de mesclagem
`edit_sheet`	Edite uma planilha com uma instrução em linguagem natural (Theo planeja + aplica operações)
`list_sheet_commits`	Liste os commits de alteração estilo git de uma planilha (aplicados / propostos / mesclados)
`diff_sheet_commit`	Mostre o diff em nível de célula para um commit ou proposta
`resolve_sheet_proposal`	Mescle ou rejeite uma proposta de alteração pendente
`rollback_sheet`	Reverta a planilha ao vivo para um commit anterior (reversível)

Quadros

Ferramenta	Descrição
`create_board`	Crie um quadro de projeto Kanban + calendário
`list_boards`	Liste seus quadros de projeto
`get_board`	Obtenha as listas (colunas) e cartões de um quadro
`update_board`	Atualize o nome, descrição ou colunas de lista de um quadro
`delete_board`	Excluir temporariamente um quadro (recuperável)
`duplicate_board`	Duplique um quadro com suas listas, regras e cartões
`add_board_card`	Adicione um cartão (post/tarefa/ideia/evento) a um quadro
`list_board_cards`	Liste os cartões de um quadro, opcionalmente por intervalo de agendamento
`update_board_card`	Edite um cartão — mover lista, reagendar, alterar status/cor
`delete_board_card`	Excluir temporariamente um cartão de um quadro

Theo Symphony

Ferramenta	Descrição
`create_song`	Gere uma música com o Theo Symphony — retorna um job para consultar
`get_song_status`	Consulte um job de música; retorna versões de áudio + arte da capa quando concluído

Notas

Ferramenta	Descrição
`get_note_content`	Extraia o conteúdo de uma nota como Markdown
`append_to_note`	Anexe conteúdo Markdown a uma nota existente
`clip_to_note`	Salve conteúdo da web (URL + HTML) como um recorte dentro de uma nota

Modelos

Ferramenta	Descrição
`list_templates`	Navegue pela galeria de modelos
`use_template`	Crie um novo projeto a partir de um modelo

Conta

Ferramenta	Descrição
`whoami`	Obtenha as informações de perfil do usuário autenticado
`get_credits`	Verifique o saldo restante de créditos de IA

Recursos

Recursos fornecem contexto somente leitura que um cliente de IA pode recuperar sem chamar uma ferramenta.

Recurso	Descrição
`projects`	Lista paginada de seus projetos recentes
`project`	Dados completos de um único projeto por ID
`templates`	Catálogo de modelos navegável

Como 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 solicitação é autenticada por sua chave de API e atua em sua própria conta OpenCharts. Como o servidor é hospedado, a superfície de ferramentas permanece atualizada automaticamente — sem necessidade de atualizações do cliente. Ferramentas que usam Theo AI ou geração (por exemplo ask_theo, extract_flowchart, generate_code_canvas, build_agent, create_song) consomem créditos de IA do seu plano.

Limites de taxa e créditos

120 solicitações por minuto por usuário.
Ferramentas de IA e geração consomem créditos de IA — verifique seu saldo a qualquer momento com a ferramenta get_credits.

Descoberta e registro

Metadados legíveis por máquina são publicados para clientes, rastreadores e registros (sem segredos):

https://www.opencharts.com/.well-known/mcp — manifesto de descoberta
https://www.opencharts.com/.well-known/mcp/server-card.json — cartão do servidor
https://www.opencharts.com/.well-known/oauth-protected-resource — metadados de recurso protegido
Documentação: opencharts.com/help/mcp-server

Solução de problemas

Redirecionamento 307 / "sem suporte a autorização" / 401 — certifique-se de que a URL seja exatamente https://www.opencharts.com/api/mcp (com www.). O host apex remove o cabeçalho Authorization no redirecionamento. Confirme também se sua chave está ativa e enviada com o prefixo Bearer .
429 Too Many Requests — você atingiu o limite de 120 req/min; aguarde e tente novamente.
Ferramentas ausentes no seu cliente — reinicie completamente o cliente (ou desative e reative o servidor OpenCharts) para que ele busque novamente a lista de ferramentas. Confirme se sua chave possui os escopos read, write e ai (chaves padrão incluem todos os três).
JWT expirado no meio da sessão — JWTs de sessão expiram após ~15 minutos; use uma chave de API persistente para integrações de longa duração.

Clientes compatíveis

Funciona com qualquer cliente que suporte o Model Context Protocol, incluindo:

Warp — ambiente de desenvolvimento agêntico
Claude Desktop e Claude Code
Cursor
VS Code (GitHub Copilot)
Windsurf (Codeium)
Codex (OpenAI)
Amp
OpenCode

Licença

Esta documentação está licenciada sob CC-BY-4.0. O servidor MCP OpenCharts é um produto hospedado — consulte opencharts.com para termos e preços.