Servidor MCP de ExplorerHub

Qué es

Model Context Protocol (MCP) es el estándar abierto con el que los asistentes basados en modelos de lenguaje se conectan a fuentes de datos externas. El servidor MCP de ExplorerHub expone en modo de solo lectura la estructura, los descriptores, los niveles y los glosarios de DigComp, DigCompEdu, GreenComp, LifeComp, FinComp, DigCompConsumers, AILit y EntreComp, con los mismos datos y en los mismos cuatro idiomas que el sitio. El servidor es un producto de IDCERT S.r.l. Società Benefit y responde en explorerhub.eu.

Las herramientas

• explorerhub_list_frameworksEnumera los marcos publicados con identificador, editor, año, idiomas, recuentos y licencia.
• explorerhub_get_frameworkDevuelve la estructura de un marco: áreas, competencias, niveles y, cuando el marco está dividido por público, los segmentos disponibles.
• explorerhub_get_nodeDevuelve un área o una competencia con todos sus descriptores, agrupados por nivel o por dimensión.
• explorerhub_get_levelsDevuelve los niveles de dominio de un marco, con descripción y las correspondencias EQF/MCER que indica el documento.
• explorerhub_get_glossaryDevuelve el glosario de un marco, filtrable y paginado.
• explorerhub_searchBusca texto o un código del documento en un marco o en todos, con resultados ordenados y enlaces a la página. Acepta limit y offset para recorrer los resultados y audience para los marcos con varios públicos; indica si la lista está truncada y desde dónde continuar.

Cómo obtener la clave

1. Crea una cuenta de ExplorerHub, o inicia sesión si ya tienes una.
2. En tu cuenta, abre la sección «Acceso MCP».
3. Dale un nombre a la clave (por ejemplo, el cliente que la usará) y acepta los términos del servicio MCP: sin la aceptación la clave no se crea.
4. Pulsa «Crear clave» y cópiala de inmediato: se muestra una sola vez y no se puede recuperar. Si la pierdes, revócala y crea otra.
5. Pasa la clave a tu cliente MCP en la cabecera Authorization como Bearer token, como en los ejemplos siguientes.

Las claves empiezan por ehk_ y tienen 47 caracteres. El servidor conserva solo su huella criptográfica: nadie, ni siquiera IDCERT, puede volver a leer una clave ya creada. Puedes tener como máximo 5 claves activas por cuenta; las claves revocadas no cuentan.

Revocación

En tu cuenta, junto a cada clave, «Revocar» la desactiva de inmediato y de forma definitiva: los clientes que la usan reciben 401 desde la siguiente llamada. Revoca una clave si la has expuesto, si el dispositivo que la usaba ya no es tuyo o si ya no la necesitas, y crea una nueva cuando la necesites.

Ejemplos de configuración

Exporta la clave a una variable de entorno, como en el primer ejemplo, y déjala ahí. Los archivos de configuración del proyecto — .mcp.json, .cursor/mcp.json, .vscode/mcp.json — acaban en el repositorio: por eso los ejemplos hacen referencia a la variable, o a una entrada del editor, y no a la clave. Nunca pegues la clave en un archivo versionado ni la compartas.

export EXPLORERHUB_API_KEY=ehk_YOUR_KEY_HERE

claude mcp add --transport http explorerhub https://explorerhub.eu/api/mcp \
  --header "Authorization: Bearer ehk_YOUR_KEY_HERE"

{
  "mcpServers": {
    "explorerhub": {
      "type": "http",
      "url": "https://explorerhub.eu/api/mcp",
      "headers": {
        "Authorization": "Bearer ${EXPLORERHUB_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "explorerhub": {
      "url": "https://explorerhub.eu/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:EXPLORERHUB_API_KEY}"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "explorerhub-key",
      "description": "ExplorerHub MCP API key",
      "password": true
    }
  ],
  "servers": {
    "explorerhub": {
      "type": "http",
      "url": "https://explorerhub.eu/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:explorerhub-key}"
      }
    }
  }
}

{
  "mcpServers": {
    "explorerhub": {
      "serverUrl": "https://explorerhub.eu/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:EXPLORERHUB_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "explorerhub": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://explorerhub.eu/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ehk_YOUR_KEY_HERE"
      }
    }
  }
}

La aplicación Claude Desktop no acepta una cabecera estática en sus conectores, pero se conecta mediante mcp-remote, un puente de código abierto de terceros (paquete npm, licencia MIT) que se ejecuta en tu ordenador, habla con la aplicación y pasa la clave al servidor: el ejemplo de arriba es el de su README, y la clave se queda en el archivo de configuración local de la aplicación, que nunca acaba en un repositorio. Los conectores de claude.ai y de ChatGPT requieren OAuth y por el momento no están soportados. El servidor responde a cualquier cliente MCP que use el transporte Streamable HTTP y envíe la cabecera Authorization.

Niveles y límites

Qué ocurre al alcanzar el límite

El límite se mide por minuto y por clave; sin una clave válida se aplica por dirección IP y solo lo consumen los intentos fallidos. Superado el límite, el servidor responde 429 con un cuerpo JSON que lleva error «rate_limited», scope (key o ip), limit y retryAfter, y con la cabecera Retry-After en segundos. Las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (segundos desde la época Unix) acompañan cada respuesta autenticada, de modo que el cliente puede frenar antes de ser rechazado. A cada cuenta se aplica además una cuota mensual sobre todas sus claves: 10.000 llamadas por mes natural (UTC) en el nivel gratuito, 500.000 en Pro. Agotada la cuota, el servidor responde 429 con scope month y un Retry-After que llega hasta el primer día del mes siguiente; las cabeceras X-RateLimit-Monthly-Limit, X-RateLimit-Monthly-Remaining y X-RateLimit-Monthly-Reset acompañan cada respuesta autenticada junto a las del minuto. Una solicitud rechazada por el límite del minuto no consume la cuota del mes.

Códigos de respuesta

Cada respuesta lleva Cache-Control: no-store. El servidor solo acepta POST, que es el transporte Streamable HTTP del protocolo MCP.

La forma de las respuestas

Cada respuesta de una herramienta lleva, además de los datos solicitados, dos bloques distintos. attribution dice de quién es el texto del marco y bajo qué título se reutiliza: licencia o declaración de derechos, cita, procedencia de la traducción en el idioma solicitado. service dice quién ha prestado el servicio. En las herramientas que leen un marco attribution es un objeto; en explorerhub_list_frameworks y en la búsqueda en todos los marcos es un array con un elemento por marco. Los dos bloques nunca se fusionan, porque IDCERT no es titular del texto de los marcos.

{
  "framework": {
    "id": "digcomp",
    "name": "DigComp",
    "version": "3.0"
  },
  "attribution": {
    "framework": {
      "id": "digcomp",
      "name": "DigComp",
      "version": "3.0",
      "producer": "JRC",
      "publisher": "Joint Research Centre, European Commission",
      "year": 2025,
      "citation": "Cosgrove, J., Cachia, R., DigComp 3.0: European Digital Competence Framework – Fifth Edition, EUR 40491, Publications Office of the European Union, Luxembourg, 2025, ISBN 978-92-68-32677-0, doi:10.2760/0001149, JRC144121.",
      "doi": "10.2760/0001149",
      "sourceUrl": "https://publications.jrc.ec.europa.eu/repository/handle/JRC144121"
    },
    "license": {
      "url": "https://creativecommons.org/licenses/by/4.0/",
      "requiresAttribution": true
    },
    "rightsStatement": null,
    "translation": {
      "locale": "es",
      "provenance": [
        "official",
        "idcert"
      ],
      "notice": "The es text is an edition edited by IDCERT, not an official edition (in part; the rest is the publisher's own edition). The European Commission is not responsible for this translation."
    },
    "attributionPage": "https://explorerhub.eu/en/legal/attribution"
  },
  "service": {
    "name": "ExplorerHub MCP",
    "provider": "IDCERT S.r.l. Società Benefit",
    "url": "https://explorerhub.eu",
    "endpoint": "https://explorerhub.eu/api/mcp",
    "termsOfService": "https://explorerhub.eu/en/legal/mcp-terms",
    "notice": "Data obtained through ExplorerHub MCP (https://explorerhub.eu/api/mcp), a service of IDCERT S.r.l. Società Benefit. Framework content is reproduced from the official publication named in `attribution`, under that publication's own licence or rights statement: when you redistribute it, credit its publisher as that licence requires. Use of this service is governed by the ExplorerHub MCP terms of service (https://explorerhub.eu/en/legal/mcp-terms), which ask you to state that the data was obtained through ExplorerHub by IDCERT S.r.l. Società Benefit, in addition to the publisher's attribution."
  }
}

Ejemplo generado por las mismas funciones del servidor, para DigComp en el idioma de esta página; los campos propios de la herramienta (árbol, descriptores, resultados) se omiten.

Cómo citar

Quien reutiliza los datos declara la fuente del texto como exige la licencia del marco y, junto a ella, el servicio con el que los obtuvo — nunca en lugar del editor. Una fórmula lista para copiar, para DigComp:

Cosgrove, J., Cachia, R., DigComp 3.0: European Digital Competence Framework – Fifth Edition, EUR 40491, Publications Office of the European Union, Luxembourg, 2025, ISBN 978-92-68-32677-0, doi:10.2760/0001149, JRC144121. Datos obtenidos a través de ExplorerHub MCP, servicio de IDCERT S.r.l. Società Benefit (https://explorerhub.eu/api/mcp).

Licencias y atribución

Los textos de los marcos son publicaciones de la Comisión Europea, del Centro Común de Investigación (JRC) y de la OCDE, reproducidos en las condiciones de sus respectivas licencias Creative Commons o autorizaciones de reutilización. Cada respuesta del servidor incluye la cita, la licencia y la procedencia de la traducción: quien redistribuya ese texto debe conservarlas. El uso del servicio se rige por los términos MCP, que piden declarar que los datos se obtuvieron a través de ExplorerHub de IDCERT S.r.l. Società Benefit, junto a la atribución al editor. Las ediciones traducidas a cargo de IDCERT se declaran como tales y no son ediciones oficiales.

ExplorerHub e IDCERT no están afiliados a la Comisión Europea, al JRC ni a la OCDE.

• Atribución de las fuentes
• Términos del servicio MCP