---
name: metabase
description: Operações Metabase BI — explorar bases de dados, listar dashboards, gerir collections e questions via bi.descomplicar.pt.
---

# Skill /metabase - Metabase BI Operations

Operações Metabase BI - explorar databases, listar dashboards, gerir collections e questions via bi.descomplicar.pt.

## Sintaxe

```
/metabase [operação] [contexto]
```

**Operações:**
- `explore` - Explorar databases e tabelas disponíveis
- `dashboards` - Listar e inspeccionar dashboards
- `collections` - Gerir collections (pastas)
- `questions` - Listar e inspeccionar questions/cards
- `search [termo]` - Pesquisar conteúdo no Metabase
- `users` - Listar utilizadores e permissões
- `status` - Estado geral da instância

## Quando usar

- Explorar que dados estão disponíveis no Metabase
- Ver dashboards existentes
- Gerir collections e organização
- Verificar estado da instância
- Operações administrativas gerais

---

## Protocolo de execução

### 1. Carregar MCP Metabase

```
ToolSearch("metabase")
```

Verificar que as tools `mcp__metabase__*` estão disponíveis.

### 2. Operação: explore

**Objectivo:** Mapear dados disponíveis.

```
1. Listar databases: mcp__metabase__list_databases
2. Para cada database relevante: mcp__metabase__get_database_tables
3. Para tabelas de interesse: mcp__metabase__get_table_fields
4. Apresentar resumo estruturado
```

**Output esperado:**
```markdown
## Databases disponíveis

| ID | Nome | Engine | Tabelas |
|----|------|--------|---------|
| 1  | ...  | ...    | N       |

### Database: [Nome]
| Tabela | Campos | Registos |
|--------|--------|----------|
| ...    | ...    | ...      |
```

### 3. Operação: dashboards

```
1. Listar dashboards: mcp__metabase__list_dashboards
2. Para cada dashboard: mostrar nome, descrição, cards
3. Se pedido detalhe: mcp__metabase__get_dashboard
```

### 4. Operação: collections

```
1. Listar collections: mcp__metabase__list_collections
2. Mostrar hierarquia de pastas
3. Contar items por collection
```

### 5. Operação: questions

```
1. Listar questions/cards: mcp__metabase__list_cards
2. Mostrar: nome, tipo, database, última execução
```

### 6. Operação: search

```
1. mcp__metabase__search_content com termo fornecido
2. Agrupar resultados por tipo (dashboard, card, table)
```

### 7. Operação: status

```
1. Listar databases e verificar conectividade
2. Contar dashboards, questions, collections
3. Listar utilizadores activos
4. Apresentar resumo
```

## Metabase instance

- **URL**: https://bi.descomplicar.pt/
- **MCP**: metabase (metabase-ai-assistant v4.2.0, 134 tools)
- **Auth**: API key (configurada no MCP)

## Notas

- Todas as operações são **read-only** por defeito
- Para operações de escrita (criar dashboard, etc.), usar `/dashboard`
- Para queries SQL, usar `/query`

---

## Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```

*Adicionar nova linha após cada erro corrigido.*
