educa-navarra-mcp 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +150 -89
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,63 +1,82 @@
1
1
  <div align="center">
2
2
 
3
- <img src="https://raw.githubusercontent.com/vTanco/educa-navarra-mcp/main/assets/icon.png" width="112" alt="">
3
+ <img src="https://raw.githubusercontent.com/vTanco/educa-navarra-mcp/main/assets/icon.png" width="104" alt="">
4
4
 
5
5
  # Educa Navarra · notas con IA
6
6
 
7
- **Pásale tu Excel de notas a Claude y él las mete en Educa por ti.**
8
- Tú revisas y decides cuándo se guardan.
7
+ **Pásale tu Excel de notas a Claude y él las mete en Educa por ti.**<br>
8
+ Tú revisas la pantalla y decides cuándo se guardan.
9
9
 
10
10
  [![npm](https://img.shields.io/npm/v/educa-navarra-mcp?color=B5121B&label=npm)](https://www.npmjs.com/package/educa-navarra-mcp)
11
- [![Licencia MIT](https://img.shields.io/badge/licencia-MIT-1E8E3E)](LICENSE)
11
+ [![Licencia MIT](https://img.shields.io/badge/licencia-MIT-1E8E3E)](https://github.com/vTanco/educa-navarra-mcp/blob/main/LICENSE)
12
12
  [![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)
13
13
  ![Mac · Windows · Linux](https://img.shields.io/badge/Mac%20·%20Windows%20·%20Linux-grey)
14
14
 
15
- [**⬇️ 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) · [Prepara tus Excel](docs/BUENAS-PRACTICAS.md) · [Preguntas frecuentes](#-preguntas-frecuentes) · [Aviso legal](AVISO-LEGAL.md)
15
+ **[Descargar para Claude Desktop](https://github.com/vTanco/educa-navarra-mcp/releases/latest/download/educa-navarra-mcp.mcpb)** ·
16
+ [Instalación](#instalación) ·
17
+ [Primeros pasos](#primeros-pasos) ·
18
+ [Preparar el Excel](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/BUENAS-PRACTICAS.md) ·
19
+ [Qué se ha probado](#qué-se-ha-probado) ·
20
+ [Preguntas](#preguntas-frecuentes)
16
21
 
17
22
  </div>
18
23
 
19
- > [!IMPORTANT]
20
- > **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.
24
+ > **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](https://github.com/vTanco/educa-navarra-mcp/blob/main/AVISO-LEGAL.md) antes de usarla.
21
25
 
22
- ---
26
+ <p align="center">
27
+ <img src="https://raw.githubusercontent.com/vTanco/educa-navarra-mcp/main/assets/flujo.svg" width="100%" alt="Cinco pasos: tu Excel, vista previa, escribe en pantalla sin guardar, tú revisas y pulsa Aceptar solo si lo confirmas.">
28
+ </p>
23
29
 
24
- ## ✨ Qué hace
30
+ ## Qué hace
25
31
 
26
32
  | | |
27
33
  |---|---|
28
- | 📄 **Lee tu fichero** | Excel (`.xlsx`) o CSV, con las columnas que tengas. Basta con *alumno* y *nota*. |
29
- | 🔎 **Cruza nombres** | Empareja tu lista con la de Educa aunque cambien tildes, mayúsculas o el orden de nombre y apellidos. |
30
- | 👀 **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**. |
31
- | ✍️ **Escribe en pantalla** | Rellena las notas en la ventana de Educa, sin guardar, para que las revises con tus ojos. |
32
- | ✅ **Guarda solo si tú lo dices** | Pulsa *Aceptar* únicamente cuando lo confirmas en el chat. |
33
- | 🔒 **Nunca cierra ni firma** | Se niega a pulsar botones de cerrar, firmar, bloquear, borrar o publicar una evaluación. |
34
+ | **Conoce tus grupos** | Lee de Educa tus grupos, agrupamientos, asignaturas y evaluaciones. No hay que escribirlos en ningún ajuste. |
35
+ | **Va directo a la pantalla** | *"Abre 1ºCD, 2ª evaluación"* y abre Calificaciones con el grupo, la materia y la evaluación elegidos. Basta con parte del nombre. |
36
+ | **Encuentra tu fichero** | Busca el Excel o CSV en tu carpeta de notas por evaluación, grupo y materia. También vale adjuntarlo en el chat. |
37
+ | **Cruza los nombres** | Empareja tu lista con la de Educa aunque cambien tildes, mayúsculas o el orden de nombre y apellidos. |
38
+ | **Enseña una vista previa** | Nota actual, nota nueva y avisos, antes de tocar nada. |
39
+ | **Escribe sin guardar** | Rellena las notas en la ventana de Educa para que las revises. |
40
+ | **Guarda solo si lo dices** | Pulsa *Aceptar* únicamente cuando lo confirmas en el chat. |
41
+
42
+ Sirve para **ESO** (IN, SU, BI, NT, SB), **Bachillerato** (nota sobre 10) y **FP de Grado Medio y Superior**: lee la escala de cada pantalla en vez de suponerla.
43
+
44
+ ## Instalación
34
45
 
35
- Pensado para **ESO** (IN · SU · BI · NT · SB), **Bachillerato** (nota sobre 10) y **FP de Grado Medio y Superior**, según la LOMLOE.
46
+ Elige una opción. Las tres instalan lo mismo.
36
47
 
37
- ## 🚀 Instalación
48
+ | | Para quién | Qué necesitas |
49
+ |---|---|---|
50
+ | **A · Claude Desktop** | La mayoría de docentes | Claude Desktop. Doble clic y listo |
51
+ | **B · Claude Code** | Si ya usas la terminal | Node.js 20 o superior |
52
+ | **C · Otras aplicaciones** | Cursor, VS Code, Windsurf, LM Studio… | Node.js 20 o superior |
38
53
 
39
- ### Opción A · Claude Desktop (recomendada, sin saber informática)
54
+ ### A · Claude Desktop (recomendada)
40
55
 
41
56
  1. Instala [Claude Desktop](https://claude.ai/download) si no lo tienes.
42
57
  2. **[Descarga `educa-navarra-mcp.mcpb`](https://github.com/vTanco/educa-navarra-mcp/releases/latest/download/educa-navarra-mcp.mcpb)**.
43
- 3. Haz **doble clic** en el fichero descargado. Claude Desktop se abre y te pregunta si quieres instalarlo: pulsa **Instalar**.
44
- 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. También puedes indicar los **grupos en los que no pones notas** (por ejemplo, si compartes docencia): el conector se negará a escribir en ellos.
45
- 5. Te preguntará también por tu **carpeta de notas**. Deja la que sale (*Documentos/Notas Educa*) y créala si no la tienes: ahí guardarás tus Excel.
58
+ 3. Haz **doble clic** en el fichero. Claude Desktop se abre y pregunta si quieres instalarlo: pulsa **Instalar**.
59
+ 4. Rellena los ajustes. Todos son opcionales:
60
+
61
+ | Ajuste | Para qué |
62
+ |---|---|
63
+ | Usuario y contraseña de Educa | Para que Claude entre solo. Si los dejas vacíos, entras tú en la ventana que se abre. La contraseña se guarda cifrada en tu ordenador. |
64
+ | Grupos en los que no pongo notas | Por ejemplo, si compartes docencia: `ESO 2º D, ESO 2º E`. Podrás consultarlos, pero el conector se negará a escribir en ellos. |
65
+ | Carpeta de notas | Donde guardas tus Excel. Deja la que sale (*Documentos/Notas Educa*) y créala si no existe. |
46
66
 
47
- 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).
67
+ No hace falta instalar nada más: usa el **Google Chrome** o **Microsoft Edge** que ya tienes. Si no hay ninguno, descarga un navegador la primera vez (un par de minutos).
48
68
 
49
- > [!TIP]
50
- > Si el doble clic no funciona: en Claude Desktop ve a **Ajustes → Extensiones → Instalar extensión…** y elige el fichero.
69
+ Si el doble clic no funciona, en Claude Desktop ve a **Ajustes → Extensiones → Instalar extensión…** y elige el fichero. Para actualizar a una versión nueva, descarga el fichero otra vez y repite el doble clic.
51
70
 
52
- ### Opción B · Claude Code (una línea)
71
+ ### B · Claude Code
53
72
 
54
73
  ```bash
55
74
  claude mcp add educa -- npx -y educa-navarra-mcp
56
75
  ```
57
76
 
58
- ### Opción C · Otras aplicaciones de IA (Cursor, VS Code, Windsurf, LM Studio…)
77
+ ### C · Otras aplicaciones compatibles con MCP
59
78
 
60
- Necesitas [Node.js 20 o superior](https://nodejs.org). Añade esto a la configuración de servidores MCP de tu aplicación:
79
+ Añade esto a la configuración de servidores MCP de tu aplicación:
61
80
 
62
81
  ```json
63
82
  {
@@ -71,92 +90,132 @@ Necesitas [Node.js 20 o superior](https://nodejs.org). Añade esto a la configur
71
90
  ```
72
91
 
73
92
  <details>
74
- <summary>¿Quieres que entre solo en Educa con las opciones B o C?</summary>
93
+ <summary>Entrar solo en Educa con las opciones B o C</summary>
75
94
 
76
- 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\`):
95
+ Crea el fichero `credenciales.json` en la carpeta `.educa-mcp` de tu usuario (Mac: `/Users/tu_usuario/.educa-mcp/`; Windows: `C:\Users\tu_usuario\.educa-mcp\`):
77
96
 
78
97
  ```json
79
98
  { "usuario": "tu_usuario_de_educa", "clave": "tu_contraseña" }
80
99
  ```
81
100
 
82
- 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.
101
+ No compartas ese fichero ni lo subas a ningún sitio. También valen las variables `EDUCA_USER` y `EDUCA_PASSWORD` en el bloque `env` de la configuración. El resto de ajustes, en [CONFIGURACION.md](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/CONFIGURACION.md).
83
102
  </details>
84
103
 
85
- ## 💬 Cómo se usa
104
+ ## Primeros pasos
105
+
106
+ Escríbele a Claude con tus palabras. La primera vez:
86
107
 
87
- Escríbele a Claude con tus palabras. Por ejemplo:
108
+ 1. **"Actualiza mis grupos."** Entra en Educa, lee tus grupos y asignaturas y los guarda en tu ordenador. Tarda unos segundos por grupo. Repítelo cuando cambien (curso nuevo, sustitución).
109
+ 2. **"Mete las notas de la 1ª evaluación de BTO N 1ºA, TIC."** Busca el fichero, abre la pantalla y te enseña la vista previa.
110
+ 3. **"Vale, escríbelas."** Rellena la pantalla de Educa sin guardar. Mira la ventana del navegador.
111
+ 4. **"Guarda."** Pulsa *Aceptar*. Si algo no te cuadra, no lo digas: pulsa tú *Cancelar* en la ventana de Educa y no se guarda nada.
112
+
113
+ El cierre y la firma de la evaluación los sigues haciendo tú a mano, como siempre.
114
+
115
+ ### Qué puedes pedirle
88
116
 
89
117
  | Quieres… | Dile… |
90
118
  |---|---|
91
- | Meter notas | *"Mete las notas de la 1ª evaluación de BTO N 1ºA, TIC."* |
92
- | Cargar tus grupos (la primera vez) | *"Actualiza mis grupos."* |
93
119
  | Ir directo a un grupo | *"Abre las notas de 1ºAB de Tecnología, 2ª evaluación."* |
120
+ | Consultar sin tocar | *"Enséñame las notas de ESO 3ºDEFH, Matemáticas. No cambies nada."* |
94
121
  | Ver qué ficheros tienes | *"¿Qué ficheros de notas tengo?"* |
95
- | Consultar sin tocar | *"Enséñame las notas que hay ahora en Educa de ESO 3ºDEFH, Matemáticas. No cambies nada."* |
96
- | Escribir tras la vista previa | *"Vale, escríbelas."* |
97
- | Guardar tras revisar en pantalla | *"Guarda."* |
98
122
  | Usar otra columna | *"La nota está en la columna Media T1."* |
123
+ | Aceptar un nombre dudoso | *"Sí, Maite Etxeberria es la misma."* |
124
+ | Ver la pantalla | *"Haz una captura de la pantalla."* |
99
125
  | Aprender a preparar el Excel | *"¿Cómo preparo mi Excel de notas?"* |
100
126
 
101
- En Claude Desktop tienes además atajos en el menú **+** del chat: **Meter notas en Educa**, **Revisar mis notas en Educa** y **Cómo preparo mi Excel de notas**.
102
-
103
- ```mermaid
104
- flowchart LR
105
- A["📄 Tu Excel"] --> B["🔐 Entra en Educa"]
106
- B --> C["🧭 Va a Calificaciones<br/>grupo · materia · evaluación"]
107
- C --> D["👀 Vista previa<br/>no cambia nada"]
108
- D --> E["✍️ Escribe en pantalla<br/>sin guardar"]
109
- E --> F{"¿Confirmas?"}
110
- F -- "Sí" --> G["✅ Pulsa Aceptar"]
111
- F -- "No" --> H["↩️ Cancelar"]
112
- ```
127
+ En Claude Desktop tienes además tres atajos en el menú **+** del chat: **Meter notas en Educa**, **Revisar mis notas en Educa** y **Cómo preparo mi Excel de notas**.
128
+
129
+ ### Nombres de grupo a medias
130
+
131
+ No hace falta escribir el nombre exacto de Educa. Si lo que dices encaja con un solo grupo, lo abre; si encaja con varios, te pregunta cuál.
132
+
133
+ | Tus grupos en Educa | Le dices | Abre |
134
+ |---|---|---|
135
+ | ESO 1ºAB plu, ESO 1ºCD plu, ESO 1ºEF plu | *"1ºCD"* | ESO 1ºCD plu |
136
+ | BTO N 1ºA, BTO N 2ºA | *"BTO N 1"* | BTO N 1ºA |
137
+ | ESO 1ºAB plu, ESO 1ºCD plu, ESO 1ºEF plu | *"ESO 1"* | Te pregunta cuál de los tres |
138
+
139
+ Lo mismo con la asignatura (*"Tecnología"*) y la evaluación (*"2"*, *"2a"*, *"Final"*). Si el grupo solo tiene una asignatura, no hace falta decirla.
140
+
141
+ ## Tu fichero de notas
142
+
143
+ Vale casi cualquier Excel (`.xlsx`) o CSV con una fila por alumno y una columna de nota. Para que Claude lo encuentre solo:
144
+
145
+ | | Recomendación | Ejemplo |
146
+ |---|---|---|
147
+ | **Carpeta** | Una para todo, con subcarpeta por curso | `Documentos/Notas Educa/2026-27/` |
148
+ | **Nombre** | `EVALUACIÓN_GRUPO_MATERIA` | `1EV_BTO-1A_TIC.xlsx` |
149
+ | **Contenido** | Cabeceras en la primera fila, una fila por alumno | *Apellidos · Nombre · Nota* |
150
+
151
+ | Apellidos | Nombre | Nota |
152
+ |---|---|---|
153
+ | García López | Ana | 7 |
154
+ | Pérez Martínez | Iñigo | 9 |
155
+ | Etxeberria Goñi | Maite | |
156
+
157
+ - Si tus columnas se llaman de otra forma, díselo: *"la nota está en la columna Media T1"*.
158
+ - Los alumnos con la nota en blanco se saltan.
159
+ - **No redondea por ti**: si una nota no vale para esa enseñanza, avisa y no la escribe.
113
160
 
114
- 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.
161
+ Todos los consejos, con ejemplos para interinos que cambian de centro, en la **[guía para preparar los Excel](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/BUENAS-PRACTICAS.md)**.
115
162
 
116
- ### Tus grupos
163
+ ### Así es la vista previa
117
164
 
118
- No hay que configurar los grupos: el conector los lee de Educa. Di *"actualiza mis grupos"* y guardará en tu ordenador la lista de grupos, agrupamientos, asignaturas y evaluaciones; a partir de ahí basta con *"abre las notas de 1ºAB de Tecnología, 2ª evaluación"*. Repítelo cuando cambien tus grupos (curso nuevo, sustitución).
165
+ <p align="center">
166
+ <img src="https://raw.githubusercontent.com/vTanco/educa-navarra-mcp/main/assets/vista-previa.svg" width="100%" alt="Ejemplo de vista previa con datos inventados: tabla con alumno en el fichero, alumno en Educa, nota actual, nota nueva y estado.">
167
+ </p>
119
168
 
120
- Si en algún grupo no pones tú las notas (docencia compartida), indícalo en el ajuste **Grupos en los que no pongo notas**: podrás consultarlo, pero el conector se negará a escribir en él.
169
+ Los nombres que solo coinciden en parte se marcan como *aproximados* y no se escriben salvo que lo confirmes. También avisa de alumnos del fichero que no están en Educa y de alumnos de Educa que no tienen nota en el fichero.
121
170
 
122
- ### Sirve para cualquier etapa
171
+ ## Cualquier etapa
123
172
 
124
173
  El conector no supone cómo se califica: lee la pantalla de Educa abierta y se adapta. Vale igual si este curso das ESO y el siguiente un ciclo formativo.
125
174
 
126
175
  | Lo que ofrece Educa | Qué acepta de tu fichero |
127
176
  |---|---|
128
- | Desplegable con términos (ESO, Primaria): IN, SU, BI, NT, SB | El término ("NT", "Notable") o un número entero, que convierte así: 0–4 IN, 5 SU, 6 BI, 7–8 NT, 9–10 SB |
177
+ | Desplegable con términos (ESO): IN, SU, BI, NT, SB | El término (*NT*, *Notable*) o un número entero: 0–4 IN · 5 SU · 6 BI · 7–8 NT · 9–10 SB |
129
178
  | Nota tecleada (Bachillerato) | Entero de 0 a 10 |
130
- | Nota tecleada en un ciclo formativo (FP) | Entero de 1 a 10 |
179
+ | Nota tecleada en un ciclo (FP) | Entero de 1 a 10 |
131
180
  | Desplegable Apto / No apto | El término; rechaza números |
132
- | Otros valores (FPEX, EX, NP...) | Solo si la pantalla los ofrece |
181
+ | Otros valores (FPEX, EX, NP…) | Solo si la pantalla los ofrece |
133
182
 
134
- La vista previa dice siempre qué escala ha detectado y nunca redondea decimales. Las pantallas de FP solo se han probado con el simulador. Normativa de referencia en [docs/normativa-evaluacion.md](docs/normativa-evaluacion.md).
183
+ La vista previa dice siempre qué escala ha detectado. Normativa de referencia (LOMLOE y órdenes forales de Navarra) en [normativa-evaluacion.md](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/normativa-evaluacion.md).
135
184
 
136
- ### Tu fichero de notas
185
+ ## Qué hace solo y qué necesita tu permiso
137
186
 
138
- > [!TIP]
139
- > Guarda tus Excel en **Documentos/Notas Educa** con nombres como `1EV_BTO-1A_TIC.xlsx` (evaluación_grupo_materia) y Claude los encontrará solo. Todos los consejos en la **[guía de buenas prácticas](docs/BUENAS-PRACTICAS.md)**.
187
+ | Lo hace solo | Necesita que lo confirmes | No lo hace nunca |
188
+ |---|---|---|
189
+ | Entrar en Educa | Escribir notas en pantalla (tras la vista previa) | Cerrar o firmar una evaluación |
190
+ | Leer grupos, alumnos y notas | Escribir un nombre aproximado | Bloquear, borrar o publicar |
191
+ | Abrir la pantalla de Calificaciones | Pulsar *Aceptar* para guardar | Escribir en tus grupos sin notas |
192
+ | Leer tu Excel | | Visitar webs que no sean de Educa |
193
+ | Hacer capturas de pantalla | | Redondear una nota |
140
194
 
141
- Vale casi cualquier Excel o CSV con una fila por alumno. Por ejemplo:
195
+ Antes de escribir comprueba que la tabla no ha cambiado (mismo grupo y mismos alumnos) y, después, vuelve a leer cada campo. No toca campos bloqueados, como los de una evaluación ya cerrada.
142
196
 
143
- | Apellidos | Nombre | Nota |
144
- |---|---|---|
145
- | García López | Ana | 7 |
146
- | Pérez Martínez | Iñigo | 9 |
197
+ ## Qué se ha probado
147
198
 
148
- - Si tus columnas se llaman de otra forma, díselo a Claude: *"la nota está en la columna Media T1"*.
149
- - Los alumnos con la nota en blanco se saltan.
150
- - **No redondea por ti**: si una nota no es válida para esa enseñanza, te avisa y no la escribe.
199
+ Cada cambio pasa pruebas automáticas contra un **Educa simulado** (ESO, Bachillerato, FP y Apto / No apto), con todo el recorrido: entrar, abrir el grupo, vista previa, escribir y guardar. Además, se ha probado en el **Educa real** de un instituto de Navarra con una cuenta de profesor, sin guardar nada:
200
+
201
+ | | ESO | Bachillerato | FP |
202
+ |---|---|---|---|
203
+ | Entrar y leer la tabla de notas | Probado en Educa real | Probado en Educa real | Solo simulador |
204
+ | Actualizar grupos y abrir un grupo por nombre parcial | Probado en Educa real | Probado en Educa real | Solo simulador |
205
+ | Detectar la escala | Probado en Educa real (términos) | Probado en Educa real (0 a 10) | Solo simulador |
206
+ | Escribir en pantalla, sin guardar | Probado en Educa real | Probado en Educa real | Solo simulador |
207
+ | Pulsar *Aceptar* para guardar | Solo simulador | Solo simulador | Solo simulador |
151
208
 
152
- ## 🛡️ Privacidad y seguridad
209
+ En el Educa real se ha comprobado que, al escribir una nota, Educa muestra *Aceptar* y *Cancelar* y no guarda hasta pulsar uno de los dos; el guardado definitivo se ha dejado para cuando un docente lo haga con sus propias notas. ¿Lo has usado en tu enseñanza? Cuéntalo en [Issues](https://github.com/vTanco/educa-navarra-mcp/issues).
210
+
211
+ ## Privacidad
153
212
 
154
213
  - **Se ejecuta en tu ordenador.** No hay ningún servidor intermedio: el conector maneja un navegador en tu equipo, como harías tú.
155
214
  - **Tu contraseña no pasa por el chat.** Se guarda en tu ordenador y solo se escribe en el formulario de acceso de Educa.
156
215
  - **Solo visita Educa** (`*.navarra.es`). Cualquier otra dirección se bloquea.
157
- - **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).
216
+ - **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](https://github.com/vTanco/educa-navarra-mcp/blob/main/AVISO-LEGAL.md).
158
217
 
159
- ## ❓ Preguntas frecuentes
218
+ ## Preguntas frecuentes
160
219
 
161
220
  <details>
162
221
  <summary><b>¿Puede guardar algo sin que yo me entere?</b></summary>
@@ -173,32 +232,28 @@ Sí. Deja usuario y contraseña vacíos y haz tú ese paso en la ventana que se
173
232
  <details>
174
233
  <summary><b>Me cambio de centro o de etapa el curso que viene.</b></summary>
175
234
 
176
- No tienes que hacer nada: el conector trabaja con los grupos y materias que tengas asignados en Educa en cada momento.
235
+ Di *"actualiza mis grupos"* al empezar el curso y listo. La escala de notas la detecta en cada pantalla, así que no hay que configurar nada para pasar de ESO a Bachillerato o a FP.
177
236
  </details>
178
237
 
179
238
  <details>
180
- <summary><b>Me dice que no encuentra la tabla de notas.</b></summary>
239
+ <summary><b>No encuentra mi grupo.</b></summary>
181
240
 
182
- 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).
241
+ Pídele *"actualiza mis grupos"* y vuelve a intentarlo. Si tu nombre encaja con varios grupos, te dirá cuáles y te pedirá el nombre completo.
183
242
  </details>
184
243
 
185
244
  <details>
186
- <summary><b>¿Cómo lo desinstalo?</b></summary>
245
+ <summary><b>Me dice que no encuentra la tabla de notas.</b></summary>
187
246
 
188
- 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.
247
+ 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 [CONFIGURACION.md](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/CONFIGURACION.md).
189
248
  </details>
190
249
 
191
- ## 📍 Estado
192
-
193
- | Enseñanza | Leer notas | Escribir notas |
194
- |---|---|---|
195
- | ESO | ✅ probado en Educa real | ✅ probado en Educa real |
196
- | Bachillerato | ✅ probado en Educa real | 🧪 en pruebas |
197
- | FP Grado Medio y Superior | 🧪 en pruebas | 🧪 en pruebas |
250
+ <details>
251
+ <summary><b>¿Cómo lo desinstalo?</b></summary>
198
252
 
199
- ¿Lo has probado en tu enseñanza? Cuéntalo en [Issues](https://github.com/vTanco/educa-navarra-mcp/issues).
253
+ En Claude Desktop: **Ajustes → Extensiones → Educa Navarra → Desinstalar**. Si quieres borrar también la sesión guardada del navegador y la lista de grupos, elimina la carpeta `.educa-mcp` de tu usuario.
254
+ </details>
200
255
 
201
- ## 🧑‍💻 Para desarrolladores
256
+ ## Para desarrolladores
202
257
 
203
258
  ```bash
204
259
  git clone https://github.com/vTanco/educa-navarra-mcp.git
@@ -206,12 +261,18 @@ cd educa-navarra-mcp
206
261
  npm install
207
262
  npm run build
208
263
  npm test # ficheros, conversión de notas y emparejamiento de nombres
209
- npm run smoke # prueba completa contra un Educa simulado
264
+ npm run smoke # recorrido completo contra un Educa simulado
210
265
  npm run pack:mcpb # genera build/educa-navarra-mcp.mcpb para Claude Desktop
211
266
  ```
212
267
 
213
- 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).
268
+ | Documento | Contenido |
269
+ |---|---|
270
+ | [CONFIGURACION.md](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/CONFIGURACION.md) | Herramientas, variables de entorno, fichero de configuración y Educa simulado |
271
+ | [BUENAS-PRACTICAS.md](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/BUENAS-PRACTICAS.md) | Guía para docentes sobre cómo preparar los Excel |
272
+ | [normativa-evaluacion.md](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/normativa-evaluacion.md) | Resumen de la normativa de evaluación por etapa |
273
+ | [PUBLICAR.md](https://github.com/vTanco/educa-navarra-mcp/blob/main/docs/PUBLICAR.md) | Cómo sacar una versión (GitHub y npm) |
274
+ | [CHANGELOG.md](https://github.com/vTanco/educa-navarra-mcp/blob/main/CHANGELOG.md) | Cambios de cada versión |
214
275
 
215
276
  ---
216
277
 
217
- <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>
278
+ <sub>Licencia [MIT](https://github.com/vTanco/educa-navarra-mcp/blob/main/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>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "educa-navarra-mcp",
3
- "version": "1.1.0",
3
+ "version": "1.1.1",
4
4
  "description": "Conector MCP no oficial para que Claude (u otra IA) meta las notas de evaluación en Educa (Gobierno de Navarra) desde tu Excel o CSV.",
5
5
  "keywords": [
6
6
  "mcp",