# Turso — Base de dades gratuïta controlada per Claude

> Turso és un servei de base de dades SQLite en el núvol. **Totalment gratuït per a ús docent.**  
> No cal saber SQL: Claude s'encarrega de tot.

---

## Per què Turso per a docents?

| Característica | Detall |
|----------------|--------|
| **Gratis** | 500 BD · 9 GB bandwidth · sense targeta de crèdit |
| **SQLite** | La BD més simple del món: un sol fitxer, zero configuració |
| **Núvol** | Les dades accessibles des de qualsevol lloc |
| **Claude-friendly** | Claude pot crear taules, inserir i consultar dades per tu |
| **API senzilla** | Connectar-se des d'HTML+JS és tan simple com 3 línies |

---

## Compte gratuït (5 min)

1. Ves a **https://app.turso.tech**
2. Registra't amb GitHub o Google (no cal targeta)
3. Crea una base de dades → **"New database"**
4. Copia la **URL** (`libsql://nom-organitzacio.turso.io`) i el **token** ("Generate Token")

---

## Com connectar Claude a la teua base de dades

Dóna-li a Claude la URL i el token i demana-li el que necessites:

```
Tinc una base de dades Turso:
- URL: libsql://el-meu-registre.organitzacio.turso.io
- Token: eyJhbGci...

Crea una taula "resultats" amb columnes: alumne (text), data (text),
puntuació (integer), matèria (text).
Afegeix les notes del test d'avui:
- Maria: 8 a Matemàtiques
- Joan: 6 a Matemàtiques
- Laia: 9 a Matemàtiques
```

Claude farà tot sol: instal·la `@libsql/client`, escriu el codi, executa les consultes.

---

## Casos d'ús per a docents

### 1. Guardar resultats de quizz
```
Afegeix una columna "resultat" al quizz HTML que guarde cada intent
a la meua base de dades Turso. Que registre: alumne (el que escriu),
data/hora, puntuació i número de preguntes correctes.
```

### 2. Rànquing en temps real
```
Crea una pàgina web que mostre el rànquing dels 10 millors resultats
de la taula "resultats" de la meua base de dades Turso.
```

### 3. Registre d'assistència
```
Crea un formulari simple on els alumnes puguen marcar l'assistència
(nom + grup + data). Que guarde cada entrada a Turso i que jo puga
descarregar el registre complet en CSV.
```

### 4. Biblioteca de recursos
```
Crea una taula "recursos" a Turso amb: títol, URL, matèria, nivell, tags.
Afegeix els recursos que t'indicaré i crea una pàgina de cerca.
```

### 5. Sistema de torns
```
Crea una app que gestione els torns d'exposicions orals. Els alumnes
s'apunten a un torn disponible i queda registrat a Turso.
```

---

## CLI de Turso (opcional, per a usuaris avançats)

```bash
# Instal·lació (una vegada)
npm install -g @turso/cli

# Autenticació
turso auth login

# Crear una BD
turso db create el-meu-registre

# Obrir la consola SQL
turso db shell el-meu-registre

# Generar un token per a Claude
turso db tokens create el-meu-registre
```

---

## MCP de Turso (avançat — Claude accedeix directament)

Amb el MCP, Claude pot consultar la BD des del xat sense que tu escrigues cap comanda:

```bash
# Configurar el MCP de libSQL a Claude Code
# A la configuració de Claude, afegir:
{
  "mcpServers": {
    "turso": {
      "command": "npx",
      "args": [
        "-y",
        "@turso/mcp-server-libsql",
        "--url", "libsql://la-teua-bd.turso.io",
        "--auth-token", "el-teu-token"
      ]
    }
  }
}
```

Una vegada configurat, pots dir a Claude: *"Mostra'm els alumnes que han suspès el darrer test"* i consultarà la BD directament.

---

## Límits del pla gratuït

| Recurs | Límit gratuït |
|--------|--------------|
| Bases de dades | 500 |
| Emmagatzematge | 1 GB per BD |
| Bandwidth | 9 GB/mes |
| Operacions | Il·limitades |

Per a ús docent típic (registres de classe, quizzes, torns) és més que suficient.

---

## Alternatives a Turso

| Servei | Tipus | Gratis |
|--------|-------|--------|
| **Turso** | SQLite núvol | ✅ Sí |
| **Supabase** | PostgreSQL | ✅ Sí (500 MB) |
| **PocketBase** | SQLite local | ✅ Sí (auto-allotjat) |
| **Firebase Firestore** | NoSQL | ✅ Sí (quota diària) |
| **Airtable** | Spreadsheet-BD | ✅ Sí (1.000 files/BD) |

---

> Referència: https://turso.tech/docs · https://app.turso.tech