MCP de la documentación

Esta documentación se sirve también como servidor MCP público. Si conectas el endpoint a tu cliente de IA, cualquier pregunta sobre Hilbana se responde con las páginas reales de este sitio en vez de con lo que el modelo recuerde de su entrenamiento.

Es de solo lectura y no necesita ninguna clave: todo lo que devuelve ya está publicado aquí.

No confundirlo con el MCP de la app

Son dos servidores distintos y hacen cosas distintas:

	MCP de la documentación	MCP de la app
Endpoint	https://hilbana.com/mcp	https://app.hilbana.com/mcp
Autenticación	Ninguna	Clave hil_… u OAuth
Qué hace	Leer la documentación	Operar tus issues, proyectos y documentos
Para qué	Aprender y resolver dudas	Trabajar

Si lo que quieres es que un agente cree issues, tire de la cola o cambie estados, el que necesitas es el otro: ver API y MCP.

Conectarlo

En Claude Code, de una línea:

claude mcp add --transport http hilbana-docs https://hilbana.com/mcp

En claude.ai (web y escritorio), añádelo como conector personalizado con esa misma URL: Ajustes → Conectores → Añadir conector personalizado.

Si tu cliente se configura con un JSON (.mcp.json, claude_desktop_config.json, el mcp.json de tu editor…), esta es la entrada equivalente. No hay nada que sustituir, se copia tal cual:

{
  "mcpServers": {
    "hilbana-docs": {
      "type": "http",
      "url": "https://hilbana.com/mcp"
    }
  }
}

Las herramientas

Herramienta	Qué devuelve
search_docs	Las páginas más relevantes para unos términos, con fragmentos del texto
get_doc	El Markdown completo de una o varias páginas, por slug
list_docs	El índice: slug, título, descripción y sección de cada página
get_all_docs	Toda la documentación de un idioma, en un solo bloque
get_overview	Resumen del producto y mapa del sitio: qué es, planes y precios, enlaces

Todas aceptan lang, que es es por defecto y admite en: la documentación existe completa en los dos idiomas.

La que más sorprende es get_all_docs. La documentación entera de un idioma son unas 30 páginas, que caben de sobra en el contexto de un modelo actual, así que tu cliente puede pedirlo todo de una vez y responder sin encadenar búsquedas. Si prefieres ir por partes, search_docs localiza y get_doc lee.

Qué preguntarle

Una vez conectado, sirve para lo que harías con la documentación abierta al lado, pero sin abrirla:

• «¿Cómo conecto un agente a Hilbana desde Claude Code?»
• «Explícame la diferencia entre ciclos e hitos en Hilbana.»
• «¿Qué hace exactamente claim_issue y por qué hay que llamarlo antes de trabajar?»
• «Según la documentación de Hilbana, ¿cómo firmo un webhook entrante?»
• «Resume qué incluye el plan gratuito.»

Cómo se mantiene al día

El contenido del servidor se genera en el mismo despliegue que este sitio, a partir de estos mismos ficheros. No hay un índice que sincronizar aparte ni una copia que pueda quedarse vieja: si lees algo aquí, el MCP lo devuelve.