Servidor MCP

Los asistentes de programación con IA conocen un OpenKM, no necesariamente el suyo. Se entrenaron con la documentación de OpenKM que encontraron, así que pueden usar métodos que no existen en su versión, desconocer los más recientes o inventarse firmas.

El servidor MCP de OpenKM da a cualquier asistente de IA compatible con el Model Context Protocol (Claude, ChatGPT, Codex, Cursor, GitHub Copilot, Gemini, Windsurf…) acceso directo a la documentación para desarrolladores de la versión exacta de OpenKM con la que trabaja: la API Java, las utilidades del core, el sistema de plugins, los metadatos y el esquema de la base de datos.

Sirve el mismo contenido que los ficheros de contexto para LLM, pero no tiene que descargar ni adjuntar nada: el asistente pide al servidor lo que necesita, cuando lo necesita.

Por qué usarlo

• Las respuestas corresponden a su versión. Están disponibles todas las versiones de OpenKM desde la 8.2.5, y el asistente pide la que usa su proyecto.
• Ahorra tokens. En lugar de cargar un fichero de referencia completo (solo el de la API supera los 50.000 tokens), el asistente obtiene una sección, una clase o un método.
• Siempre actualizado. Cuando se publica una versión nueva de OpenKM, su documentación se añade al servidor. No tiene que actualizar nada.
• Sin cuenta ni clave de API. El servidor es público y de solo lectura.

URL del servidor

https://mcp.openkm.com/mcp

El servidor usa el transporte Streamable HTTP. Cualquier cliente MCP que admita servidores remotos puede conectarse directamente.

URL	Sirve
https://mcp.openkm.com/mcp	Todas las versiones. El asistente elige la versión en cada petición (por defecto, la última).
https://mcp.openkm.com/mcp/8.2.9	Solo OpenKM 8.2.9. Útil para fijar la versión de un proyecto.
https://mcp.openkm.com/mcp/8.2	La última versión 8.2.x.

Conectar su asistente de IA

En todos los ejemplos el servidor se llama openkm-docs. Puede usar cualquier otro nombre.

Claude Code

claude mcp add --transport http --scope user openkm-docs https://mcp.openkm.com/mcp

--scope user lo deja disponible en todos sus proyectos. Para compartirlo con su equipo, use --scope project: el servidor se guarda en el fichero .mcp.json del proyecto, que puede subir al repositorio.

Compruebe la conexión con claude mcp get openkm-docs, o con /mcp dentro de una sesión.

Claude Desktop y claude.ai

1. Abra Settings → Connectors.
2. Pulse Add custom connector.
3. Escriba OpenKM docs como nombre y https://mcp.openkm.com/mcp como URL, y pulse Add.

Los conectores personalizados están disponibles en los planes de Claude que los admiten. Una vez añadido, el conector se activa en cada conversación desde el menú de herramientas.

Cursor

Añada el servidor a .cursor/mcp.json en su proyecto, o a ~/.cursor/mcp.json para usarlo en todos sus proyectos:

{
  "mcpServers": {
    "openkm-docs": {
      "url": "https://mcp.openkm.com/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Añada el servidor a .vscode/mcp.json en su proyecto. Tenga en cuenta que VS Code usa la clave servers:

{
  "servers": {
    "openkm-docs": {
      "type": "http",
      "url": "https://mcp.openkm.com/mcp"
    }
  }
}

Las herramientas están disponibles en Copilot Chat en modo Agent.

OpenAI Codex

codex mcp add openkm-docs --url https://mcp.openkm.com/mcp

O añádalo a mano en ~/.codex/config.toml:

[mcp_servers.openkm-docs]
url = "https://mcp.openkm.com/mcp"

ChatGPT

1. Abra Settings → Apps & Connectors → Advanced settings y active Developer mode.
2. En Apps & Connectors, pulse Create.
3. Escriba OpenKM docs como nombre y https://mcp.openkm.com/mcp como URL, seleccione No authentication y pulse Create.

El modo desarrollador está disponible en los planes de ChatGPT que lo admiten. Una vez creado, seleccione el conector en la conversación desde el menú +.

Windsurf

Añada el servidor a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "openkm-docs": {
      "serverUrl": "https://mcp.openkm.com/mcp"
    }
  }
}

Gemini CLI

gemini mcp add --transport http openkm-docs https://mcp.openkm.com/mcp

O añádalo a mano en ~/.gemini/settings.json:

{
  "mcpServers": {
    "openkm-docs": {
      "httpUrl": "https://mcp.openkm.com/mcp"
    }
  }
}

Otros clientes

Cualquier cliente que admita servidores MCP remotos por HTTP puede usar directamente la URL del servidor. Para los clientes que solo admiten servidores locales (stdio), use el puente mcp-remote, que necesita Node.js:

{
  "mcpServers": {
    "openkm-docs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.openkm.com/mcp"]
    }
  }
}

Qué obtiene el asistente

Herramienta	Para qué sirve
list_versions	Las versiones de OpenKM disponibles y qué documentación cambió en cada una.
list_pages	Las páginas de documentación de una versión: API, utilidades del core, plugins, metadatos y esquema de la base de datos.
search_docs	Las secciones que coinciden con unas palabras clave, con su tamaño.
get_page	Una página, una de sus secciones o su índice.
list_api	Las clases Java documentadas (OKMDocument, OKMFolder, FileUtils…).
get_api	Una clase con la lista de sus miembros, o uno de sus miembros (por ejemplo, un método con todas sus sobrecargas).

Todas las herramientas aceptan el argumento version (8.2.9, o 8.2 para la última versión 8.2.x). Normalmente el asistente la toma de la dependencia com.openkm:openkm del pom.xml de su proyecto. Si no lo hace, indíquele qué versión usa, o conéctese a la URL de esa versión.

Ejemplo de prompt

Con el servidor conectado no hace falta referenciar ningún fichero. Indique la versión de OpenKM y el servidor MCP que debe usar:

I am working on an OpenKM 8.2.9 plugin.
Use the "openkm-docs" MCP server to check the plugin interface and the API methods you need.

Create a Crontab plugin that runs every night and moves to /okm:root/archive
the documents in /okm:root/inbox that have not been modified in the last 90 days.

El asistente buscará en la documentación, leerá la interfaz de los plugins de Crontab y los métodos de la API que necesita para esa versión, y escribirá el código con las firmas correctas.

Buena práctica

Nombre el servidor MCP en su prompt, por ejemplo Use the “openkm-docs” MCP server (o en español, usa el servidor MCP «openkm-docs»). El asistente decide por sí mismo cuándo llamar a una herramienta, y puede responder con lo que ya sabe en lugar de consultar la documentación. Nombrar el servidor lo guía hacia la fuente correcta, y nombrar la versión de OpenKM hace que pida la documentación adecuada.