Técnica

Documentación para agentes

Cómo conectar un agente a esta documentación por MCP, y las alternativas sin MCP.

Un agente puede consultar esta documentación sin copiarla a mano. El sitio publica un servidor MCP de solo lectura y además ofrece cada página en Markdown.

Servidor MCP


URL	`/mcp`
Transporte	HTTP (Streamable HTTP)
Autenticación	Ninguna: es el mismo contenido público de estas páginas
Acceso	Solo lectura

Herramienta	Qué hace
`search_docs`	Busca en todas las páginas. Devuelve título, ruta, extracto y URL. Funciona mejor con dos o tres palabras («proyecto web», «nota interna») que con una pregunta completa.
`get_page`	Devuelve una página completa en Markdown, con su frontmatter.
`list_pages`	Lista todas las páginas con su ruta, título y descripción.
`get_navigation`	Devuelve el árbol: Guía de uso y Técnica, con sus secciones.

Cada página también es un recurso MCP (resources/list y resources/read). El descubrimiento está en /.well-known/mcp.json.

Conectar un agente

En cada página, el recuadro Conectar a MCP trae la URL del servidor y los textos listos para copiar.

Claude Code:

claude mcp add --transport http smart-desk-docs https://tu-dominio/mcp

Queda disponible en el proyecto donde lo corres. Con --scope user queda en todos tus proyectos. Para comprobar la conexión, usa claude mcp list.

Cursor, en .cursor/mcp.json del proyecto o en la configuración global:

{
  "mcpServers": {
    "smart-desk-docs": { "url": "https://tu-dominio/mcp" }
  }
}

VS Code, en .vscode/mcp.json:

{
  "servers": {
    "smart-desk-docs": { "type": "http", "url": "https://tu-dominio/mcp" }
  }
}

El recuadro de esta página ya sustituye tu-dominio por el origen real.

Sin MCP

Recurso	Qué trae
`/llms.txt`	El índice de todas las páginas, con su título y su descripción.
`/llms-full.txt`	Todo el contenido en un solo archivo de texto.
Cualquier URL + `.md`	La página en Markdown, por ejemplo `/docs/guia/proyectos.md`.
`Accept: text/markdown`	Pedida con esa cabecera, la URL normal de una página devuelve Markdown en vez de HTML.

Qué contiene y qué no

Contiene lo mismo que estas páginas: la guía de uso y esta sección técnica. No da acceso a tickets, clientes, usuarios ni a ninguna empresa. Esos datos se consultan dentro de SMART DESK, con la sesión de quien ingresó.