Tabellum

Tabellum — Configuração do MCP

Permita que seu assistente de IA trabalhe com seus bancos de dados através do Tabellum, um cliente de banco de dados para desktop para PostgreSQL, MySQL/MariaDB, SQL Server e BigQuery. O servidor MCP é hospedado pelo aplicativo em execução na sua máquina; este pacote é um pequeno shim stdio que encaminha para ele. As consultas que o assistente escreve aparecem ao vivo no editor, e nada que altere dados é executado sem o seu clique no aplicativo.

• Servidor: tabellum
• Transporte: stdio (processo local)
• Pacote: @dudko.dev/tabellum-mcp — Node.js 24+
• Autenticação: um token por instalação gerado pelo aplicativo; o shim o lê para você de ~/.tabellum/mcp.json.

O que você pode fazer

Com o aplicativo Tabellum aberto, o assistente pode:

Ferramenta	O que ela faz
list_connections	Nomes de conexões, drivers, sinalizadores somente leitura.
describe_schema	Nomes de objetos por esquema.
describe_object	Colunas, índices, restrições, DDL.
list_users	Usuários e papéis do banco de dados.
sample_rows	Até N linhas — apenas onde a conexão permite compartilhar linhas.
run_read	Executa uma instrução que o mecanismo classifica como leitura.
propose_write	Envia uma escrita/DDL para sua aprovação no aplicativo (timeout de 10 minutos).
explain	EXPLAIN no dialeto da conexão.
draft_to_editor	Transmite SQL ao vivo para uma aba do editor.
open_editor_tab	Abre uma aba vinculada a uma conexão.

---

Instalar no Claude Code (plugin)

/plugin marketplace add dudko-dev/tabellum-mcp-setup
/plugin install tabellum@tabellum
/reload-plugins

Inicie o aplicativo Tabellum primeiro (macOS, Windows ou Linux). O shim lê a porta local e o token do aplicativo de ~/.tabellum/mcp.json, gravados enquanto o aplicativo está em execução; com o aplicativo fechado, toda chamada responde "Tabellum is not running".

Prefere não usar o marketplace? Adicione o servidor diretamente:

claude mcp add tabellum -- npx -y @dudko.dev/tabellum-mcp

---

Conectar de outros clientes

Claude Desktop

claude_desktop_config.json (Configurações → Desenvolvedor → Editar Config):

{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json ou .cursor/mcp.json:

{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

VS Code (GitHub Copilot / MCP) e outros clientes

{
  "servers": {
    "tabellum": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

---

Segurança

• O mecanismo classifica, você aprova. Cada instrução é classificada pelo parser do aplicativo; qualquer coisa que não seja uma leitura passa por propose_write e aguarda o seu clique. Um rótulo reivindicado pelo modelo nunca o substitui.
• Somente loopback. O aplicativo escuta em 127.0.0.1 com um token bearer por instalação (Configurações → Agentes mostra e pode regenerá-lo).
• Dados de linhas são opcionais por conexão. sample_rows retorna linhas apenas onde você habilitou o compartilhamento para essa conexão.

---

Solução de problemas

• "Tabellum is not running" — abra o aplicativo e tente novamente.
• Não autorizado após regenerar o token — reinicie o servidor MCP no seu cliente para que o shim releia ~/.tabellum/mcp.json.
• Uma escrita parece travada — ela está aguardando aprovação no aplicativo; após 10 minutos, retorna declined: timeout.

Suporte

• Site: https://tabellum.dudko.dev
• Contato: siarhei@dudko.dev