<div align="center">

<img src="https://raw.githubusercontent.com/vTanco/educa-navarra-mcp/main/assets/icon.png" width="112" alt="">

# Educa Navarra · notas con IA

**Pásale tu Excel de notas a Claude y él las mete en Educa por ti.**
Tú revisas y decides cuándo se guardan.

[![npm](https://img.shields.io/npm/v/educa-navarra-mcp?color=B5121B&label=npm)](https://www.npmjs.com/package/educa-navarra-mcp)
[![Licencia MIT](https://img.shields.io/badge/licencia-MIT-1E8E3E)](LICENSE)
[![Pruebas](https://github.com/vTanco/educa-navarra-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/vTanco/educa-navarra-mcp/actions/workflows/ci.yml)
![Mac · Windows · Linux](https://img.shields.io/badge/Mac%20·%20Windows%20·%20Linux-grey)

[**⬇️ Descargar para Claude Desktop**](https://github.com/vTanco/educa-navarra-mcp/releases/latest/download/educa-navarra-mcp.mcpb) · [Cómo se usa](#-cómo-se-usa) · [Preguntas frecuentes](#-preguntas-frecuentes) · [Aviso legal](AVISO-LEGAL.md)

</div>

> [!IMPORTANT]
> **Herramienta no oficial.** No está hecha ni respaldada por el Gobierno de Navarra ni por el Departamento de Educación. Usas tu propia cuenta de Educa y eres responsable de las notas que guardes. Lee el [aviso legal](AVISO-LEGAL.md) antes de usarla.

---

## ✨ Qué hace

| | |
|---|---|
| 📄 **Lee tu fichero** | Excel (`.xlsx`) o CSV, con las columnas que tengas. Basta con *alumno* y *nota*. |
| 🔎 **Cruza nombres** | Empareja tu lista con la de Educa aunque cambien tildes, mayúsculas o el orden de nombre y apellidos. |
| 👀 **Te enseña una vista previa** | Nota actual, nota nueva y avisos (alumnos que faltan, nombres dudosos, notas fuera de rango) **antes de tocar nada**. |
| ✍️ **Escribe en pantalla** | Rellena las notas en la ventana de Educa, sin guardar, para que las revises con tus ojos. |
| ✅ **Guarda solo si tú lo dices** | Pulsa *Aceptar* únicamente cuando lo confirmas en el chat. |
| 🔒 **Nunca cierra ni firma** | Se niega a pulsar botones de cerrar, firmar, bloquear, borrar o publicar una evaluación. |

Pensado para **ESO** (IN · SU · BI · NT · SB), **Bachillerato** (nota sobre 10) y **FP de Grado Medio y Superior**, según la LOMLOE.

## 🚀 Instalación

### Opción A · Claude Desktop (recomendada, sin saber informática)

1. Instala [Claude Desktop](https://claude.ai/download) si no lo tienes.
2. **[Descarga `educa-navarra-mcp.mcpb`](https://github.com/vTanco/educa-navarra-mcp/releases/latest/download/educa-navarra-mcp.mcpb)**.
3. Haz **doble clic** en el fichero descargado. Claude Desktop se abre y te pregunta si quieres instalarlo: pulsa **Instalar**.
4. Te pedirá tu **usuario y contraseña de Educa**. Son **opcionales**: si los pones, Claude entra solo en Educa; si los dejas vacíos, entras tú en la ventana que se abre. La contraseña se guarda cifrada en tu ordenador.

Y ya está. No hace falta instalar nada más: usa el **Google Chrome** o **Microsoft Edge** que ya tienes. Si no tienes ninguno, descarga un navegador la primera vez (tarda un par de minutos).

> [!TIP]
> Si el doble clic no funciona: en Claude Desktop ve a **Ajustes → Extensiones → Instalar extensión…** y elige el fichero.

### Opción B · Claude Code (una línea)

```bash
claude mcp add educa -- npx -y educa-navarra-mcp
```

### Opción C · Otras aplicaciones de IA (Cursor, VS Code, Windsurf, LM Studio…)

Necesitas [Node.js 20 o superior](https://nodejs.org). Añade esto a la configuración de servidores MCP de tu aplicación:

```json
{
  "mcpServers": {
    "educa": {
      "command": "npx",
      "args": ["-y", "educa-navarra-mcp"]
    }
  }
}
```

<details>
<summary>¿Quieres que entre solo en Educa con las opciones B o C?</summary>

Crea el fichero `credenciales.json` en la carpeta `.educa-mcp` de tu usuario (en Mac: `/Users/tu_usuario/.educa-mcp/`; en Windows: `C:\Users\tu_usuario\.educa-mcp\`):

```json
{ "usuario": "tu_usuario_de_educa", "clave": "tu_contraseña" }
```

No compartas ese fichero ni lo subas a ningún sitio. También vale poner las variables `EDUCA_USER` y `EDUCA_PASSWORD` en el bloque `env` de la configuración.
</details>

## 💬 Cómo se usa

Escríbele a Claude con tus palabras. Por ejemplo:

> *Mete las notas de la 1ª evaluación de 1º de Bachillerato A, TIC, desde el Excel `notas_1BA.xlsx` de mi Escritorio.*

```mermaid
flowchart LR
    A["📄 Tu Excel"] --> B["🔐 Entra en Educa"]
    B --> C["🧭 Va a Calificaciones<br/>grupo · materia · evaluación"]
    C --> D["👀 Vista previa<br/>no cambia nada"]
    D --> E["✍️ Escribe en pantalla<br/>sin guardar"]
    E --> F{"¿Confirmas?"}
    F -- "Sí" --> G["✅ Pulsa Aceptar"]
    F -- "No" --> H["↩️ Cancelar"]
```

Verás una ventana del navegador donde ocurre todo: puedes mirar en cualquier momento qué está haciendo. **El cierre y la firma de la evaluación los haces tú a mano**, como siempre.

### Tu fichero de notas

Vale casi cualquier Excel o CSV con una fila por alumno. Por ejemplo:

| Apellidos | Nombre | Nota |
|---|---|---|
| García López | Ana | 7 |
| Pérez Martínez | Iñigo | 9 |

- Si tus columnas se llaman de otra forma, díselo a Claude: *"la nota está en la columna Media T1"*.
- Los alumnos con la nota en blanco se saltan.
- **No redondea por ti**: si una nota no es válida para esa enseñanza, te avisa y no la escribe.

## 🛡️ Privacidad y seguridad

- **Se ejecuta en tu ordenador.** No hay ningún servidor intermedio: el conector maneja un navegador en tu equipo, como harías tú.
- **Tu contraseña no pasa por el chat.** Se guarda en tu ordenador y solo se escribe en el formulario de acceso de Educa.
- **Solo visita Educa** (`*.navarra.es`). Cualquier otra dirección se bloquea.
- **Ojo:** los nombres y notas que aparecen en la vista previa sí pasan por la conversación con la IA. Consulta la política de tu centro sobre el uso de IA con datos del alumnado. Más detalle en el [aviso legal](AVISO-LEGAL.md).

## ❓ Preguntas frecuentes

<details>
<summary><b>¿Puede guardar algo sin que yo me entere?</b></summary>

No. Guardar exige una confirmación expresa en el chat, y Claude Desktop te pide permiso antes de usar esa herramienta. Además, nunca pulsa botones de cerrar, firmar, bloquear, borrar o publicar.
</details>

<details>
<summary><b>Entro en Educa con Cl@ve o certificado. ¿Funciona?</b></summary>

Sí. Deja usuario y contraseña vacíos y haz tú ese paso en la ventana que se abre. El conector espera a que termines.
</details>

<details>
<summary><b>Me cambio de centro o de etapa el curso que viene.</b></summary>

No tienes que hacer nada: el conector trabaja con los grupos y materias que tengas asignados en Educa en cada momento.
</details>

<details>
<summary><b>Me dice que no encuentra la tabla de notas.</b></summary>

Educa cambia a veces su diseño. Pide a Claude *"haz una captura de la pantalla"* y abre un aviso en [Issues](https://github.com/vTanco/educa-navarra-mcp/issues) **sin datos de alumnos** (tapa los nombres). Los ajustes avanzados están en [docs/CONFIGURACION.md](docs/CONFIGURACION.md).
</details>

<details>
<summary><b>¿Cómo lo desinstalo?</b></summary>

En Claude Desktop: **Ajustes → Extensiones → Educa Navarra → Desinstalar**. Si quieres borrar también la sesión guardada del navegador, elimina la carpeta `.educa-mcp` de tu usuario.
</details>

## 📍 Estado

| Enseñanza | Leer notas | Escribir notas |
|---|---|---|
| ESO | ✅ probado en Educa real | ✅ probado en Educa real |
| Bachillerato | ✅ probado en Educa real | 🧪 en pruebas |
| FP Grado Medio y Superior | 🧪 en pruebas | 🧪 en pruebas |

¿Lo has probado en tu enseñanza? Cuéntalo en [Issues](https://github.com/vTanco/educa-navarra-mcp/issues).

## 🧑‍💻 Para desarrolladores

```bash
git clone https://github.com/vTanco/educa-navarra-mcp.git
cd educa-navarra-mcp
npm install
npm run build
npm test          # ficheros, conversión de notas y emparejamiento de nombres
npm run smoke     # prueba completa contra un Educa simulado
npm run pack:mcpb # genera build/educa-navarra-mcp.mcpb para Claude Desktop
```

Configuración avanzada, variables de entorno y herramientas: [docs/CONFIGURACION.md](docs/CONFIGURACION.md). Cómo publicar una versión: [docs/PUBLICAR.md](docs/PUBLICAR.md).

---

<sub>Licencia [MIT](LICENSE). Proyecto independiente y sin ánimo de lucro, sin relación con el Gobierno de Navarra. "Educa" es el nombre del portal educativo del Gobierno de Navarra y se usa solo para describir con qué funciona esta herramienta.</sub>