Recursos MCP

Qué es esto

Páginas de documentación y materiales de referencia que el servidor MCP de ComStack expone como recursos MCP. Los asistentes de IA pueden leerlos sin llamar a una herramienta; es útil para orientarse sobre plantillas, flujos de trabajo, códigos de error y requisitos de Lighthouse al inicio de una sesión.

Cómo funciona

Los recursos se sirven a través de resources/read y resources/list. Una plantilla de recursos cubre documentos arbitrarios: transformento://docs/{slug} resuelve cualquier página activa mediante su slug en formato kebab-case. Los recursos destacados se almacenan en caché en el proceso durante 60 segundos por slug.

Cualquier documento activo en el proyecto de documentación de ComStack puede promocionarse a un recurso MCP con nombre sin necesidad de redesplegar el servidor, añadiendo un bloque mcp_resource a sus metadatos; el servidor lo detecta en un ciclo de caché. Los alias codificados tienen prioridad en caso de colisión de URI.

Cuándo usarlo

Lea los recursos seleccionados al inicio de una sesión para dar al asistente de IA contexto sobre el flujo de trabajo de la plataforma, el esquema de metadatos y los patrones de error comunes antes de redactar o editar páginas.

Parámetros / campos / entradas

Recursos seleccionados

URI	Propósito	Audiencia	Prioridad
`transformento://guide`	Flujo de trabajo completo del agente: selección de plantillas, traducciones, patrones de URL, flujo de publicación.	asistente	1.0
`transformento://schema`	Todos los campos de metadatos: tipo, requerido/opcional, ejemplos.	asistente	0.9
`transformento://lighthouse`	Reglas para una puntuación de 100/100 en Lighthouse.	asistente	0.8
`transformento://publishing-guide`	Flujo de trabajo de publicación de principio a fin.	asistente + usuario	0.9
`transformento://faq`	Errores comunes, síntomas, acciones de recuperación.	asistente + usuario	0.7
`transformento://errors`	Referencia de errores y pasos de recuperación.	asistente	0.7
`transformento://cookbook`	Ejemplos prácticos: listados de propiedades, traducciones, etc.	asistente + usuario	0.5
`transformento://icons`	Catálogo de iconos Material Symbols (Rounded) para grupos de la barra lateral.	asistente	0.5

Plantilla de recursos

transformento://docs/{slug} resuelve cualquier página activa del sitio de documentación de ComStack. Reemplace {slug} con el slug de la página en kebab-case, usando / para rutas anidadas (ej. transformento://docs/guias/publicacion).

Promocionar una página a un recurso MCP

Añada un bloque mcp_resource a los metadatos de una página:

{
  "mcp_resource": {
    "uri": "transformento://my-guide",
    "audience": ["user", "assistant"],
    "priority": 0.6
  }
}

El servidor lo detecta en un plazo de 60 segundos. Los alias codificados (guide, schema, lighthouse, publishing-guide, faq, cookbook, errors) tienen prioridad en caso de colisión de URI.

Anotaciones

Cada recurso lleva annotations: { audience, priority } según la especificación MCP. Los recursos con audience: "assistant" están destinados como contexto para la IA; los recursos con audience: "user" también son legibles por humanos.

Ejemplo

Leer la guía del agente al inicio de una sesión:

{
  "method": "resources/read",
  "params": { "uri": "transformento://guide" }
}

Esto devuelve la guía completa del flujo de trabajo del agente como texto estructurado que el asistente de IA puede usar para orientarse antes de realizar cualquier llamada a herramientas, cubriendo el ciclo de vida de la página, la selección de plantillas, los modos de traducción y el flujo de publicación.

Errores comunes

Error	Causa	Solución
Recurso no encontrado	El slug no coincide con ninguna página activa	Verifique el slug con `search-docs` o `get-page-content`
Contenido desactualizado	La caché de alias no se ha actualizado	Espere hasta 60 segundos después de publicar

Relacionado

Descripción general del servidor MCP — configuración del servidor y transporte
Instalación — conectar un asistente de IA
Herramientas — herramientas disponibles
Ejemplos — flujos de trabajo que utilizan recursos y herramientas juntos