Claude Dashboards · kit en español

Pregúntale a Claude y obtén un panel en vivo

Un kit de prompts y un plan por fases para armar paneles que se actualizan solos: uno para tu negocio y otro para ver qué hace tu Claude Code, cuánto falla y cuánto costaría.

Banner Panel en Vivo: Dashboards de Claude para tu negocio y para tu Claude Code
En resumen

CC Dashboard es un kit en español para usar los Dashboards de Claude, paneles que guardan las consultas y rehacen las cuentas cada vez que los abres. Sirve para dueños de pequeños negocios y para quienes usan Claude Code todos los días. Trae prompts listos para armar paneles del negocio (dinero, atrasos, fugas) y un plan para medir tu propio Claude Code (costo estimado, herramientas, fallas). Para usarlo necesitas un plan de pago de Claude y, en las partes con base de datos, una cuenta gratuita en Supabase.

Qué es

Un panel que guarda la pregunta, no solo la respuesta

Un panel antiguo era una foto tomada una sola vez. El Dashboard de Claude guarda las consultas y las ejecuta de nuevo sobre tus datos cada vez que se abre.

Conectores, preguntas, verificación, Supabase, telemetría y programación

💼 Panel del negocio

Dónde está el dinero, qué está atrasado, dónde pierdes ingresos. Empieza con una app y crece hasta una base central que cruza varias.

🔭 Panel de Claude Code

Sesiones, tokens, caché, costo estimado, herramientas y servidores MCP que más fallan, skills más usadas y la salud del recolector.

🔍 Número verificable

Cada tarjeta muestra la consulta y la hora de la última actualización. El kit enseña a leer la consulta y a verificar un número en su origen antes de actuar.

Cómo funciona

Dos caminos, el mismo principio

El panel solo muestra lo que Claude logra leer. En el negocio, la lectura viene de los conectores; en Claude Code, viene de la telemetría que él mismo envía.

Negocio

Apps (CRM, hoja de cálculo, base de datos)→ Conector en Claude→ Base central en Supabase (cuando cruza apps)→ Dashboard→ Copia programada

Claude Code

Claude Code (OpenTelemetry)→ Recolector en Supabase (filtra campos)→ Tablas en bruto (7 días)→ Resumen diario (cada 10 min)→ Dashboard

🔒 Qué guarda el recolector

Nombre del modelo, de la herramienta, de la skill y del servidor MCP, conteo de tokens, costo estimado, duración, éxito o falla, tipo de error y nombre de la máquina.

🗑️ Qué descarta

Texto de los prompts y de las respuestas, comandos completos, rutas de archivos, entradas y salidas de herramientas, texto de error y correo electrónico. Del shell solo queda el nombre del programa.

⏱️ Cuatro relojes

Claude Code envía cada pocos segundos, el resumen se recalcula cada 10 min, el panel rehace las consultas al abrirse, y las otras apps solo están tan actualizadas como la última copia.

Requisitos previos

Lo que necesitas tener

La función está en beta y cuenta en el uso de tu plan.

Plan de pago de Claude

Pro, Max, Team o Enterprise. En Enterprise, un administrador activa los Dashboards en la configuración de la organización, en Artifacts.

Cuenta en Supabase

Gratis para empezar (500 MB). El proyecto gratuito se pausa tras una semana sin uso. Solo se necesita en las fases con base central y en el panel de Claude Code.

Claude Code

Solo para el panel de observabilidad. Las variables sirven para Mac, Linux y Windows; pruébalo en tu sistema antes de confiar.

# dónde va la configuración
~/.claude/settings.json
Guía de uso · paso a paso

Del primer panel al panel de Claude Code

Los prompts están en la carpeta prompts/ del repositorio (en portugués). Cópialos, cambia lo que está entre corchetes y pégalos en un chat de Claude.

1

Activa el conector

En Customize → Connectors, agrega la app donde está la respuesta. Para Supabase de solo lectura y restringido a un proyecto, usa un conector personalizado con esta dirección:

https://mcp.supabase.com/mcp?project_ref=SEU_PROJECT_REF&read_only=true
2

Pide el panel diciendo qué quieres saber

"¿Qué facturas están atrasadas y desde hace cuánto?" rinde más que "un gráfico de facturas". Da las definiciones y prohíbe modificar datos. Modelo completo en prompts/01-dashboard-negocio.md.

Arma un Dashboard de Claude usando mi conexión con [app].
Pregunta: [lo que cambia lo que haré mañana].
Definiciones: [saldo = total − pagado; pagado vacío = 0].
# Usa consultas guardadas, no modifiques datos, pregunta si falta algo.
3

Verifica un número antes de actuar

Haz clic en el número y lee la consulta: fecha de referencia, qué registros entran, si descuenta pagos parciales y dónde quedan los bordes de los tramos. Después compara un número con la app de origen (prompts/02-conferir-numero.md).

# la consulta muestra cómo se calculó — no garantiza que esté correcto
4

Cruza apps en una base central

Horas × facturas, suscripciones × cobros, utilidad × dinero en el banco: esto exige copiar los registros a Supabase. Empieza con una pregunta, dos tablas y un piloto de 90 días (prompts/03-base-central.md).

Quiero responder: ¿qué trabajo se entregó y nunca se facturó?
# Claude propone el schema y el piloto y espera tu OK
5

Programa la actualización

Sin copia programada, el panel lee datos viejos. Pide una tarea diaria o semanal y una tarjeta "Última actualización" (prompts/05-agendar-atualizacao.md).

Crea una tarea programada que, todos los días a las 6h, vuelva a copiar [app] al schema [nombre].
6

Arma el panel de Claude Code

Con el conector de Supabase con escritura (solo para el armado), pega prompts/04-observabilidade-claude-code.md en un chat nuevo. Claude pregunta el proyecto, la zona horaria y el nombre de la máquina, lista los pasos y espera tu OK.

# crea: schema cc_obs, función cc-coletor, resumen cada 10 min, limpieza diaria
7

Activa la telemetría y reinicia

Pega el bloque env en ~/.claude/settings.json (modelo en config/claude-code-otel.example.json). Cierra Claude Code por completo y ábrelo de nuevo: solo lee esas variables al iniciar.

{ "env": {
  "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
  "OTEL_EXPORTER_OTLP_PROTOCOL": "http/json",
  "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "https://<ref>.supabase.co/functions/v1/cc-coletor/v1/logs",
  "OTEL_EXPORTER_OTLP_HEADERS": "x-cc-key=<clave>",
  … (bloque completo en el archivo de ejemplo)
} }
8

Prueba y abre el panel

En una sesión nueva, envía un prompt simple y avisa a Claude en el chat. Él verifica que el recolector recibió los datos y arma las cinco pestañas. Dale un día de uso antes de juzgar los gráficos.

claude --debug-file /tmp/cc.log  # si no llega nada, busca líneas [3P telemetry]
Ejemplos

Preguntas que se vuelven paneles

Lo que funciona bien: una pregunta que cambia una decisión, con una definición clara.

💰 Facturas atrasadas

Saldo pendiente por tramo (por vencer, 1–30, 31–60, 61–90, 90+ días), por cliente, con la fecha de referencia explícita.

🧾 Trabajo no facturado

Horas registradas que no aparecen en ninguna línea de factura — exige una base central con las dos fuentes.

🏦 Utilidad × caja

Resultado contable del mes frente al dinero que realmente entró y salió del banco.

🛠️ Herramienta que más falla

Llamadas, % de falla y duración p50/p95 por herramienta y por servidor MCP en los últimos 7 días.

🧠 Caché que no pega

Tokens de caché leídos frente a creados por día — un caché que se reconstruye a cada rato aparece aquí.

🧩 Costo por skill

Uso y costo estimado por skill y por tipo de subagente, para saber qué vale la pena mantener.

Antes de confiar

Límites que debes conocer

Muestra, no avisa

El panel no envía alertas. Para recibir un aviso cuando un número pasa del límite, crea una rutina programada aparte.

El costo es una estimación

El valor es lo que costaría el uso a precio de API. En Pro o Max, lo que se paga es la suscripción.

Cada persona con su conexión

Quien recibe el panel necesita acceso propio al mismo proyecto de Supabase; sin eso las tarjetas quedan vacías.

Los nombres también cuentan

Los nombres de skills, repositorios y servidores MCP quedan guardados. Piensa en quién lo va a ver.

Solo Claude Code

El chat de la app y Cowork no entran en este panel de observabilidad.

Espacio en la base

500 MB en el plan gratuito. Los datos en bruto duran 7 días, el resumen se queda para siempre. Vigila la tarjeta de tamaño.

Plan

Fases para construir el sistema

El plan completo está en PLANO.md (en portugués). Orden sugerido: primero el panel de Claude Code (una tarde), después el del negocio.

B0–B1
Proyecto y base de datosSchema cc_obs, filtro por lista de campos permitidos, resumen diario, limpieza de 7 días, rol de solo lectura.
B2–B3
Recolector y telemetríaFunción cc-coletor con clave por máquina; bloque env en Claude Code; reiniciar y probar.
B4
Panel de cinco pestañasVisión general, gasto y caché, herramientas y MCP, skills y subagentes, salud del recolector.
A1–A2
Panel del negocio directo desde la appPregunta + definiciones + verificación de un número en el origen.
A3–A4
Base central y copia programadaUna pregunta que cruza dos apps, piloto de 90 días, actualización diaria o semanal.
A5
Diagnóstico y seguimientoBarrido de solo lectura, problemas que se suman, plan priorizado y, con tu sí, un panel que marca cada ítem como hecho.
B5–B7
Más máquinas, historial y alertasUna clave por máquina, importación del historial local de sesiones y avisos por mensaje.