TL;DR Conecta la fuente en claude.ai (Customize > Connectors) y pide en Claude Code "haz un dashboard de … con mi connector de X". Luego abre Sources y pulsa un número: ves su consulta, su resultado y cuándo se actualizó. Lo que venga de un MCP local, de
gho de un CSV se publica como archivo y no se actualiza solo.
Cuando le pides a Claude Code un dashboard (o una página de métricas, un KPI tracker, un scorecard) y tu cuenta tiene Claude Dashboards, todavía en beta, Claude no escribe una página HTML a mano como en un artifact normal. Crea el artifact desde el tipo Dashboard, cuya regla central es que ninguna cifra se escribe en la página (solo una constante que tú elijas, como una línea de objetivo). Cada cifra, gráfico y tabla sale de una fuente con nombre, y si la fuente es una consulta en vivo, se repite cuando alguien abre, refresca o filtra el dashboard.
Cómo llega Claude al tipo Dashboard
La herramienta Artifact de Claude Code consulta primero qué tipos ofrece tu cuenta. En esta sesión, con la v2.1.318, la cuenta ofrecía cinco (Dashboard, Design, Design System, Docs y Slides), y el primer paso de la herramienta para una página nueva empieza con estas líneas:
For a dashboard, metrics page, KPI tracker or scorecard, start from the
Dashboard type: publish with `type_url`:
"https://claude.ai/artifact/GZLZthZ2sQjn7T16skfdeF",
a `title`, no files and `auto_open: "after_first_write"`, then follow the
instructions that result carries.
A partir de ahí Claude no publica un .html de tu carpeta. Escribe las fuentes (una consulta o un archivo cada una) en el almacén del dashboard, aparte de la página, cuyo HTML lleva marcas donde van los números.
Un número de la página es un hueco con data-source y data-field que un script rellena desde su fuente; si lo que enseña no coincide con los datos, el tipo se lo reporta a Claude. Lo que una sola consulta no puede calcular (cruzar dos connectors, o una consulta con un archivo) es un cálculo con nombre, y quien abre el dashboard puede leer su fórmula.
Las dos clases de fuente
| Consulta en vivo | Archivo adjunto | |
|---|---|---|
| Qué es | Una llamada a un connector de claude.ai: connector, herramienta y argumentos | Un CSV, TSV o JSON subido al dashboard |
| Cuándo se actualiza | Cuando alguien abre, refresca o filtra el dashboard | Cuando alguien sube otra versión, o lo hace una tarea programada |
| Con qué permisos | Por defecto, los de cada lector: dos personas pueden ver datos distintos. Si alguien comparte el connector, todos ven sus resultados | Los de nadie: todo el que abre el dashboard puede leerlo |
| Si falta algo | Al lector sin ese connector, el dashboard le avisa y le ofrece conectarlo | Con un plazo (staleAfterHours), al pasarlo sale como desactualizado |
Quien abre un enlace público sin sesión en claude.ai, o es de fuera de tu organización, ve la página sin sus partes en vivo. Y la segunda columna es el aviso que conviene leer dos veces. Un CSV con datos de clientes adjunto a un dashboard compartido con toda tu organización lo lee toda tu organización, aunque nadie tenga acceso al sistema del que salió.
La trampa de Claude Code: tu MCP local no llega
En la terminal, Claude lee datos de muchos sitios que la página publicada no alcanza. La documentación lo dice claro: la página solo puede llamar a connectors de tu cuenta de claude.ai, y los servidores de tu .mcp.json le dan datos a Claude mientras construye, pero no al dashboard después. Lo mismo vale para gh, psql o un script de tu repositorio.
Cuando los datos salen de ahí, el tipo Dashboard no se inventa una consulta: guarda las filas como archivo y le pide a Claude que te diga por qué no es en vivo. Para que sea una consulta en vivo, el servidor tiene que existir como connector en claude.ai (/mcp lo lista como claude.ai <nombre>); si no, una tarea programada puede mantener el archivo al día.
Lo que ves en Sources
Sources es el panel lateral del dashboard. Una fila por fuente, con su título, y al pasar por encima, hace cuánto se cargó (y el connector, si es una consulta). Al pulsar un número marcado, se abre su fuente con la cifra pulsada:
- Consulta: Query (cada argumento, con los filtros como chips con su valor actual, y el connector y la herramienta), Transform (si la respuesta necesitó convertirse en filas) y Result, las filas con la celda que pulsaste resaltada.
- Cálculo: Formula (sus entradas y el texto de la función) y Result.
- Archivo: File.
Así guarda el tipo un archivo adjunto. Es la fuente del dashboard de ejemplo de la ilustración, con 32 filas inventadas de PRs por repositorio:
{
"title": "Sample PR review times",
"description": "Invented by Claude for a demo: weekly PRs merged and median review hours for four fictional repos, Sep 7 to Oct 26, 2026. No real team or data.",
"source": { "kind": "file", "name": "pr-review-times.json", "url": "/_blob/59262aba..." },
"fixed": true,
"updated": { "at": "2026-11-01T17:30:00Z", "by": "Claude" }
}
El fixed: true le dice a Sources que no ofrezca conectarlo a datos en vivo, y el título empieza por "Sample" porque Claude las inventó: el tipo exige que lo diga.
Pedir el tuyo
1. Conecta la fuente en claude.ai
En Customize > Connectors: BigQuery, Snowflake, Databricks, Redshift, ClickHouse o la app donde vivan los datos (Salesforce, GitHub). Si necesita volver a iniciar sesión, Claude te lo pedirá antes de usar otros datos.
2. Pide la pregunta, no el gráfico
Haz un dashboard de cuántas horas tarda en revisarse un PR en cada repo,
semana a semana desde septiembre, con mi connector de GitHub.
Nombra el connector y, si lo sabes, la tabla. "¿Cómo comparan los registros de este mes por canal con los del anterior?" da mejor resultado que "un gráfico de registros".
3. Lee la entrega
Claude cierra diciendo qué supuso, qué connector necesita cada lector, que un archivo adjunto lo lee todo el que abre el dashboard y, si inventó filas de muestra, qué números son. Ahí sabes si algo se quedó sin conexión en vivo.
4. Comprueba un número en Sources
Pulsa la cifra que más te importe y lee su Query. Si no cuenta lo que querías, díselo a Claude en la misma sesión. Desde Sources también descargas las filas de una fuente en CSV y, si eres editor, cambias la consulta, la pruebas y vuelves a una versión anterior. Para retomarlo otro día, está en tu lista de /artifacts como cualquier artifact tuyo, y Enter lo adjunta.
Página a mano o dashboard
| Artifact normal | Dashboard | |
|---|---|---|
| Dónde están los números | Dentro del HTML, o los trae el código de la página | En sus fuentes, nunca escritos en la página |
| Cuándo cambian | Cuando Claude vuelve a publicar, o al cargar si la página llama a connectors | Al abrir, refrescar o filtrar |
| Cómo se comprueban | Leyendo el código de la página o preguntándole a Claude | En Sources, número a número |
| Para qué | Recorrer un PR, comparar opciones, explicar | Preguntas que vuelves a hacer con datos |
Si lo que quieres es entender un cambio antes de delegarlo, sigue siendo un artifact esculpido a mano.
Documentación oficial: Share session output as artifacts · Get started with Claude Dashboards
Requisitos
- Claude Dashboards está en beta en Pro, Max, Ultra, Team y Enterprise. En Enterprise viene apagado hasta que un Owner lo activa en Organization settings > Artifacts. Gasta de tu límite de uso como cualquier otro trabajo.
- Sesión con
/loginy la API de Anthropic, Claude Code v2.1.281 o posterior y fuera del modo-p: con API key, gateway, Bedrock, Vertex o Foundry no hay artifacts. La documentación tampoco los da en organizaciones con CMEK, HIPAA o Zero Data Retention. - En Team y Enterprise, las consultas en vivo necesitan además el interruptor Enable artifact connectors en la configuración de la organización.
- Salidas de la herramienta Artifact en Claude Code v2.1.318, el 5 de noviembre de 2026.
