Endpoints de descubrimiento y well-known
Los documentos públicos y legibles por máquinas que permiten a un agente entender Vidext, encontrar sus servidores MCP y conocer el contrato de autenticación antes de iniciar sesión.
Vidext publica una capa de descubrimiento en el dominio de la aplicación, https://app.vidext.com. Todos los documentos de aquí son públicos y no necesitan token. Los genera el mismo código que sirve los servidores MCP, y las listas de tools que contienen salen de las propias definiciones de tools de los servidores.
Describen el producto Vidext. Este sitio de documentación publica su propio llms.txt, llms-full.txt y una versión en markdown de cada página (añade .md a la URL de una página) que describen la documentación en sí.
El camino más rápido para un agente que llega a Vidext sin contexto: lee /llms.txt, sigue /.well-known/mcp hasta el endpoint y deja que el challenge 401 dirija OAuth. Los clientes MCP bien hechos hacen solos los dos últimos pasos.
Archivos de entrada
| Ruta | Qué es |
|---|---|
/llms.txt | El resumen del producto para modelos de lenguaje: qué hace Vidext, las tools MCP y enlaces. El punto de entrada canónico. |
/llms-full.txt | Todo lo de llms.txt, más el detalle de cada tool, los endpoints de auth y orientación operativa. |
/agents.md | Cuándo y cómo debería usar Vidext un agente. |
/agent.txt | Un archivo de referencia breve: descubrimiento, documentación, endpoint, auth. |
/index.md | La página de inicio en markdown. |
/api/llms.txt | Solo el descubrimiento de la API y MCP. |
/developers/llms.txt | Solo la guía de integración. |
Las peticiones a la página de inicio o a la de inicio de sesión que piden text/markdown, o que vienen de un user agent conocido de crawler o agente de IA, reciben /index.md en lugar de HTML. Esas respuestas varían según Accept y User-Agent; los navegadores no se ven afectados.
Páginas de producto y confianza
| Ruta | Qué es |
|---|---|
/about | La empresa detrás de Vidext: entidad legal, qué hace el producto y adónde ir después. |
/contact | Canales y direcciones de contacto. |
/privacy | Cómo se tratan los datos, con enlaces a las páginas de políticas. |
/developers | La guía para desarrolladores: conexión, entornos, límites de tasa, errores, versionado y deprecación. |
/pricing.md | Los planes, en markdown. |
/compare, /alternatives, /best-ai-learning-path-generator-for-employee-training | Páginas de comparación, en markdown. |
Cada página de esta tabla responde también con el sufijo .md (/about.md, /developers.md). Cada documento markdown servido empieza con un frontmatter --- que lleva su título, descripción, URL canónica y fecha de última actualización. /auth.md es la excepción: envía su URL canónica en una cabecera Link.
Descubrimiento MCP
| Ruta | Qué es |
|---|---|
/.well-known/mcp | JSON de descubrimiento MCP del servidor de Operator: endpoint, transporte, versiones del protocolo, referencias de auth y nombres de las tools. Su entrada documentationServer describe el servidor MCP de documentación público en /api/mcp/docs. |
/.well-known/mcp/server-card.json | La server card de Operator, con el esquema de entrada y las anotaciones de cada tool. |
/server.json | Metadatos del servidor en el formato del registro MCP. |
/card.json | Una ficha de producto compacta en JSON. |
/.well-known/agent-skills/index.json | Índice de Agent Skills, que sirve la skill de Vidext Operator en /.well-known/agent-skills/vidext-operator/SKILL.md. |
/.well-known/ard.json | Catálogo Agentic Resource Discovery: los dos servidores MCP, la skill de Operator, el contrato OpenAPI y la documentación, como entradas urn:air: ancladas al dominio que las publica. |
/.well-known/ai-catalog.json | El mismo catálogo con su nombre anterior. |
Cada documento JSON de .well-known responde también con el sufijo .md (/.well-known/mcp.md), con el JSON envuelto en markdown.
Vidext no anuncia A2A: /.well-known/agent-card.json responde 410.
Contrato de la API
| Ruta | Qué es |
|---|---|
/openapi.json | Contrato OpenAPI 3.1 de las superficies HTTP públicas: rutas de descubrimiento, OAuth, registro de agentes y el transporte MCP. Un contrato de transporte, no una API REST de recursos. |
/.well-known/openapi.yaml | El mismo contrato en YAML. |
/.well-known/api-catalog | Linkset RFC 9727 de las superficies públicas de la API, incluidos los dos servidores MCP. |
Metadatos de auth
| Ruta | Qué es |
|---|---|
/.well-known/oauth-protected-resource/api/mcp/operator | Metadatos del recurso protegido del endpoint de Operator: el documento al que apunta el challenge 401. /.well-known/oauth-protected-resource sirve la versión raíz. |
/.well-known/oauth-authorization-server | Metadatos del servidor de autorización con todos los endpoints OAuth. El mismo documento único se sirve en /.well-known/oauth-authorization-server/api/auth (donde RFC 8414 lo busca cuando partes del emisor, https://app.vidext.com/api/auth) y en /api/auth/.well-known/oauth-authorization-server. |
/.well-known/openid-configuration | Descubrimiento OpenID, también en /.well-known/openid-configuration/api/auth y /api/auth/.well-known/openid-configuration. |
/auth.md | Registro headless de agentes (consulta Autenticación). |
Desambiguación de JWKS
/.well-known/jwks.json es el juego de claves de LTI. El juego de claves del emisor OAuth para los tokens MCP es /api/auth/jwks.
Rastreo, enlaces y no encontrado
/robots.txtpermite la búsqueda y el uso como entrada de IA, excluye el entrenamiento de IA (Content-Signal: search=yes, ai-input=yes, ai-train=no) y apunta a/sitemap.xml.- La página de inicio, la de inicio de sesión y
/developersenvían una cabeceraLinkque apunta al sitemap,llms.txt, la guía para desarrolladores, OpenAPI,server.json, el catálogo de la API y el índice de skills. La página de inicio de sesión envía además una pistaWWW-Authenticatecon los metadatos del recurso protegido, para los escáneres que empiezan ahí. - Una ruta
/.well-known/*desconocida responde un404real comoapplication/problem+json, que apunta al sitemap y allms.txt, nunca una redirección al inicio de sesión. Para un visitante sin sesión iniciada, una ruta que no pertenece a ninguna organización responde404(en markdown, salvo que el cliente pida HTML) en lugar de redirigir al inicio de sesión. Las rutas/api/*desconocidas responden un404en JSON.
Last updated on