Ia Cae Zurekin

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.