AI-discoverability surface
docs.frihet.io publica una capa estática de descubrimiento pensada para que modelos de lenguaje, agentes y crawlers identifiquen qué hace Frihet, cómo se integra y qué herramientas expone, sin tener que rastrear cientos de páginas. Cada archivo es máquina-legible y cumple con un estándar emergente del ecosistema AI web.
Cómo funciona
Hay cuatro archivos clave servidos desde la raíz del dominio de documentación.
/ai.txt declara permisos y capacidades para agentes según el estándar emergente del web AI ecosystem. Indica qué bots están permitidos, qué pueden hacer y a qué endpoints útiles dirigirse. Es el equivalente moderno de robots.txt para LLMs y agentes.
/openapi.json sirve una copia estática de la especificación OpenAPI 3.1 de la API pública de Frihet. Permite que un agente de tool-calling cargue el esquema y descubra automáticamente las operaciones disponibles — listar facturas, registrar gasto, crear cliente — con sus parámetros y respuestas tipadas. El archivo se mantiene sincronizado con la API real.
/mcp.json publica el manifiesto del servidor MCP de Frihet con la lista de herramientas disponibles. Los agentes MCP-aware (Claude Desktop, Cursor, Windsurf) usan este manifiesto para detectar y configurar el servidor sin necesidad de leer documentación adicional.
/llms.txt es el archivo de contexto compacto siguiendo la convención llmstxt.org. Contiene una visión sintetizada del producto y enlaces a las páginas de documentación más relevantes, ordenadas para que un modelo de lenguaje pueda construir contexto útil con un solo fetch.
Adicionalmente, el sitio expone un /llms-full.txt con el contenido completo de la documentación concatenado, pensado para ingestión en contextos largos.
Configuración
No requiere configuración por parte del usuario. Los archivos son públicos y servidos como estáticos desde el dominio de documentación. Si construyes un agente o integración que necesita descubrir las capacidades de Frihet, apúntalo a los URLs correspondientes.
Si añades una nueva categoría de docs o publicas una herramienta MCP nueva, los archivos se regeneran como parte del pipeline de build del sitio.