Skip to main content
Glama
ia-cae-zurekin-mcp

ia-cae-zurekin-mcp

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

Related MCP server: wikijs-mcp

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.

Available Tools

4 tools
extract_page_contentC

Extrae el contenido estructurado de una p�gina.

Inputs: url (required), include_tables, include_links.

get_pageC

Obtiene una p�gina concreta del sitio.

Inputs: url, path.

list_sectionsC

Lista secciones navegables del sitio.

Inputs: root_path.

search_pagesC

Busca contenido dentro de la web interna autenticada.

Inputs: query (required), limit, section.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct operation: extracting content from a page, retrieving a specific page, listing sections, and searching within the site. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., extract_page_content, get_page, list_sections, search_pages) using snake_case, making them predictable and easy to understand.

    Tool Count5/5

    The server has 4 tools, which is well-scoped for a website content retrieval and navigation purpose. Each tool serves a clear and necessary function without being redundant or excessive.

    Completeness4/5

    The tool set covers core operations: retrieving pages, extracting content, listing sections, and searching. It lacks features like listing pages within a section or getting page metadata, but these are minor gaps for the intended domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers