# IA CAE Zurekin MCP Server

Servidor MCP en Node.js para consultar de forma autenticada la web interna de CAE Zurekin.

## Qué incluye

- `search_pages`: busca contenido en el sitio autenticado
- `get_page`: obtiene una página concreta
- `extract_page_content`: devuelve contenido estructurado
- `list_sections`: lista enlaces navegables desde una página raíz

## Requisitos

- Node.js 18+
- Un servidor o entorno donde ejecutar este proyecto fuera del editor
- Ajustar la lógica de login a la web real si el formulario no coincide con los valores por defecto

## Configuración

1. Copia `.env.example` a `.env`
2. Completa o ajusta las variables de entorno
3. Instala dependencias:
   - `npm install`
4. Arranca el servidor:
   - `npm start`

## Variables principales

- `CAEZ_BASE_URL`: URL base del sitio interno
- `CAEZ_USERNAME`: usuario de acceso
- `CAEZ_PASSWORD`: contraseña de acceso
- `CAEZ_LOGIN_URL`: URL exacta de login si es distinta de la base
- `CAEZ_LOGIN_USER_FIELD`: nombre real del campo usuario en el formulario
- `CAEZ_LOGIN_PASSWORD_FIELD`: nombre real del campo contraseña en el formulario
- `CAEZ_LOGIN_EXTRA_FIELDS`: JSON con campos extra del formulario, si existen
- `CAEZ_SEARCH_PATH`: ruta interna de búsqueda si el sitio tiene una URL específica para buscar
- `PORT`: puerto HTTP del servicio (por defecto `3000`)
- `MCP_PATH`: ruta del endpoint MCP (por defecto `/mcp`)

## Configuración precargada para tu caso

El ejemplo ya quedó ajustado con esta base:

- `CAEZ_BASE_URL=https://interna.caezurekin.biz/caezurekin`
- `CAEZ_LOGIN_URL=https://interna.caezurekin.biz/caezurekin`
- `CAEZ_LOGIN_USER_FIELD=username`
- `CAEZ_LOGIN_PASSWORD_FIELD=password`

## Ajustes probables

Es muy probable que todavía tengas que adaptar:

- el flujo de autenticación si hay redirecciones, tokens CSRF o SSO
- la lógica de búsqueda si el sitio no tiene un endpoint claro
- cualquier campo oculto adicional del formulario, si existe

## Endpoint remoto MCP

Este servidor ya no está pensado para funcionar solo por stdio. Ahora expone un endpoint HTTP remoto para el conector MCP:

- MCP: `POST /mcp`
- Healthcheck: `GET /health`

Si abres `/mcp` en el navegador, verás un mensaje indicando que debes usar `POST`, lo cual es esperado.

## Uso con tu MCP personalizado

Cuando lo despliegues, la conexión MCP del agente debe apuntar a:

- `https://tu-dominio-o-render.onrender.com/mcp`

No debe apuntar directamente a la web interna autenticada.

## Despliegue en Render

- Build command: `npm install`
- Start command: `npm start`

Después del despliegue, comprueba primero:

- `https://tu-dominio-o-render.onrender.com/health`
- `https://tu-dominio-o-render.onrender.com/mcp`

En `/mcp` es normal recibir un error de método si entras por navegador. Lo importante es que la ruta exista y que el conector MCP pueda hacer `POST`.

## Nota importante de despliegue

Si el MCP personalizado que ya está conectado al agente sigue desplegado con una versión anterior del código o con variables de entorno antiguas, el agente puede seguir fallando aunque este borrador ya esté corregido. En ese caso tendrás que redeplegar el servidor MCP real con este código y con la `CAEZ_BASE_URL` y `CAEZ_LOGIN_URL` correctas.