Tabellum

Tabellum — Configuración de MCP

Permite que tu asistente de IA trabaje con tus bases de datos a través de Tabellum, un cliente de bases de datos de escritorio para PostgreSQL, MySQL/MariaDB, SQL Server y BigQuery. El servidor MCP está alojado por la aplicación en ejecución en tu máquina; este paquete es un pequeño shim de stdio que reenvía hacia él. Las consultas que escribe el asistente aparecen en vivo en el editor, y nada que cambie datos se ejecuta sin tu clic en la aplicación.

• Servidor: tabellum
• Transporte: stdio (proceso local)
• Paquete: @dudko.dev/tabellum-mcp — Node.js 24+
• Autenticación: un token por instalación que genera la aplicación; el shim lo lee por ti desde ~/.tabellum/mcp.json.

Lo que puedes hacer

Con la aplicación Tabellum abierta, el asistente puede:

Herramienta	Qué hace
list_connections	Nombres de conexiones, controladores, indicadores de solo lectura.
describe_schema	Nombres de objetos por esquema.
describe_object	Columnas, índices, restricciones, DDL.
list_users	Usuarios y roles de la base de datos.
sample_rows	Hasta N filas — solo donde la conexión permite compartir filas.
run_read	Ejecutar una sentencia que el motor clasifica como lectura.
propose_write	Enviar una escritura/DDL para tu aprobación en la aplicación (tiempo de espera de 10 minutos).
explain	EXPLAIN en el dialecto de la conexión.
draft_to_editor	Transmitir SQL en vivo a una pestaña del editor.
open_editor_tab	Abrir una pestaña vinculada a una conexión.

---

Instalar en Claude Code (plugin)

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

Inicia primero la aplicación Tabellum (macOS, Windows o Linux). El shim lee el puerto local y el token de la aplicación desde ~/.tabellum/mcp.json, escrito mientras la aplicación se ejecuta; con la aplicación cerrada, cada llamada responde "Tabellum no está en ejecución".

¿Prefieres no usar el marketplace? Añade el servidor directamente:

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

---

Conectar desde otros clientes

Claude Desktop

claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

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

Cursor

~/.cursor/mcp.json o .cursor/mcp.json:

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

VS Code (GitHub Copilot / MCP) y otros clientes

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

---

Seguridad

• El motor clasifica, tú apruebas. Cada sentencia es clasificada por el analizador de la aplicación; cualquier cosa que no sea una lectura pasa por propose_write y espera tu clic. Una etiqueta reclamada por el modelo nunca la anula.
• Solo bucle local. La aplicación escucha en 127.0.0.1 con un token de portador por instalación (Configuración → Agentes lo muestra y puede regenerarlo).
• Los datos de filas son opcionales por conexión. sample_rows devuelve filas solo donde habilitaste compartir para esa conexión.

---

Solución de problemas

• "Tabellum no está en ejecución" — abre la aplicación y vuelve a intentarlo.
• No autorizado después de regenerar el token — reinicia el servidor MCP en tu cliente para que el shim vuelva a leer ~/.tabellum/mcp.json.
• Una escritura parece atascada — está esperando aprobación en la aplicación; después de 10 minutos devuelve declined: timeout.

Soporte

• Sitio web: https://tabellum.dudko.dev
• Contacto: siarhei@dudko.dev