Skip to main content
Utiliza este glosario como referencia rápida para los términos usados en Mintlify y a lo largo de esta documentación. Para una visión general de cómo encajan las piezas, consulta Conceptos.

Admin MCP server

Un servidor Model Context Protocol autenticado que permite a herramientas de IA autorizadas leer y actualizar contenido y configuración en uno o varios despliegues de una organización. Los cambios se realizan en una rama y requieren una pull request para fusionarse. Consulta Admin MCP server.

Agente

Una herramienta de IA para quienes mantienen la documentación que investiga, escribe, valida y publica los cambios propuestos. El agente puede abrir una pull request o hacer commit en la rama de despliegue, según tu configuración. Consulta Agente.

Anchor

Un enlace de navegación persistente de nivel superior que apunta a un destino interno o externo. Los anchors son uno de los patrones principales de navegación disponibles en docs.json. Consulta Anchors.

Assistant

Una interfaz de IA para lectores de la documentación que responde preguntas a partir de tu contenido. Cita páginas relevantes y puede llevar a los usuarios directamente al contenido pertinente. El assistant no edita tu documentación. Consulta Assistant.

Automatización

Una tarea configurada del agente que se ejecuta según una programación, después de una actualización del repositorio o en respuesta a un evento de una integración conectada. Consulta Automatizaciones.

Rama

Una línea de trabajo separada en un repositorio Git. Usa ramas para realizar y revisar cambios sin afectar al sitio en producción. Consulta Conceptos de Git.

Build

El proceso que valida los archivos de tu proyecto y los convierte en un sitio de documentación desplegable. Un build puede producir el sitio en producción o un despliegue de vista previa.

Commit

Una instantánea guardada de los cambios en un repositorio Git. Publicar desde el editor web crea un commit. Consulta Conceptos de Git.

Componente

Un elemento MDX reutilizable para presentar contenido estructurado o interactivo, como una tarjeta, un aviso, un acordeón, una pestaña o un grupo de código. Consulta Componentes.

Directorio de contenido

El directorio de un repositorio que contiene docs.json y los archivos de un despliegue de Mintlify. Puede ser la raíz del repositorio o un subdirectorio configurado, como docs/ en un monorepo. Consulta Configuración de monorepo.

Repositorio de contexto

Un repositorio adicional que el agente puede leer para obtener información de referencia cuando ejecuta una tarea. Un repositorio de contexto no forma parte del sitio de documentación.

Créditos

Unidades que miden el uso de las funciones de IA de Mintlify. Los créditos se comparten en toda la organización y entre sus despliegues y miembros. Consulta Créditos.

Dominio personalizado

Un dominio, subdominio o subruta que conectas a un sitio de Mintlify en lugar de usar su dirección predeterminada .mintlify.site. Consulta Dominio personalizado.

Dashboard

La aplicación autenticada de Mintlify donde tu equipo edita contenido, monitorea despliegues, gestiona miembros y configura los ajustes del proyecto y la organización.

Despliegue

Un proyecto de documentación dentro de una organización de Mintlify. Un despliegue conecta el contenido fuente y una rama de despliegue con un sitio en producción. El término también puede referirse a un build específico que se está publicando.

Rama de despliegue

La rama de Git usada para construir el sitio en producción, normalmente main. Los cambios que se envían o fusionan en esta rama disparan un despliegue de producción. Consulta Rama de despliegue.

docs.json

El archivo de configuración obligatorio para un sitio de Mintlify. Controla la navegación, la apariencia, las integraciones, la configuración de la API, las redirecciones y otros comportamientos globales. Consulta docs.json. Una estructura de navegación de nivel superior que agrupa secciones relacionadas en un menú. Consulta Dropdowns.

Editor

El editor basado en el navegador dentro del dashboard de Mintlify. Ofrece edición colaborativa, guardado automático, vistas previas en vivo, sincronización con Git y flujos de publicación. Consulta Descripción general del editor.

Rama de funcionalidad

Cualquier rama distinta de la rama de despliegue que uses para preparar cambios. Las ramas de funcionalidad mantienen el trabajo inacabado separado del sitio en producción.

Frontmatter

Metadatos YAML al inicio de una página MDX, delimitados por líneas ---. El frontmatter controla propiedades como el título, la descripción, el icono y el diseño de la página. Consulta Páginas.

Grupo

Una colección etiquetada de páginas o de grupos anidados en la barra lateral. Los grupos organizan contenido relacionado dentro de una sección de navegación. Consulta Grupos.

Índice

Un servicio de búsqueda para agentes de programación que recupera contexto técnico actualizado desde documentación mantenida por editores y desde la web a través de un servidor MCP o una API REST. Consulta Índice.

Integración

Una conexión entre Mintlify y otro servicio. Las integraciones pueden proporcionar analíticas, chat, controles de privacidad, ejemplos de SDK, contexto de automatización o disparadores de automatización.

Idioma

Una versión específica por localización de tu documentación configurada en la navegación. Los idiomas crean rutas basadas en la localización y un selector de idioma. Consulta Idiomas.

Vista previa en vivo

La renderización que se actualiza continuamente con tus ediciones no publicadas dentro del editor web. Una vista previa en vivo no se despliega públicamente. Consulta Vista previa en vivo.

Sitio en producción

El sitio de documentación de producción construido a partir de la rama de despliegue y disponible para los lectores en un dominio de Mintlify o un dominio personalizado.

llms.txt

Un archivo de texto generado que ayuda a las herramientas de IA a descubrir las páginas más útiles de un sitio de documentación. llms-full.txt incluye el contenido de todas las páginas en un solo archivo. Consulta llms.txt.

Markdown

Una sintaxis de texto plano para dar formato al contenido con elementos como encabezados, listas, enlaces y bloques de código. Las páginas publicadas de Mintlify también están disponibles como Markdown añadiendo .md a su URL.

MDX

Markdown extendido con JSX. Mintlify utiliza archivos de página .mdx para que puedas combinar Markdown estándar con componentes y elementos personalizados de React.

Merge

La operación de Git que combina cambios de una rama en otra. Fusionar una rama de funcionalidad en la rama de despliegue publica sus cambios mediante un nuevo build.

Model Context Protocol (MCP)

Un protocolo abierto que permite a las aplicaciones de IA conectarse a herramientas y fuentes de datos. Mintlify ofrece un servidor MCP público de solo lectura para cada sitio publicado y un servidor MCP de administración autenticado para gestionar despliegues. La jerarquía que utilizan los lectores para desplazarse por un sitio de documentación. Configura la navegación en tu archivo docs.json con páginas, grupos, pestañas, dropdowns, productos, versiones, idiomas y anchors. Consulta Navegación.

OpenAPI

Un formato estándar para describir APIs HTTP. Mintlify puede generar páginas de endpoints, ejemplos de solicitudes y un playground interactivo de API a partir de un documento OpenAPI. Consulta Configuración de OpenAPI.

Organización

Un espacio de trabajo de Mintlify que contiene miembros del equipo, configuración a nivel de organización, créditos compartidos y uno o más despliegues.

Página

Un archivo .mdx que se renderiza como una ruta en tu sitio de documentación. Una página combina frontmatter, contenido en Markdown y componentes opcionales. Consulta Páginas.

Despliegue de vista previa

Una versión temporal y compartible de un sitio construida a partir de una pull request o una rama seleccionada. Permite a los revisores inspeccionar los cambios antes de que lleguen al sitio en producción. Consulta Despliegues de vista previa.

Producto

Una estructura de navegación de nivel superior para publicar documentación de varios productos distintos en un solo despliegue. Cada producto tiene su propia navegación. Consulta Productos.

Proyecto

Un término general para un despliegue de Mintlify y su repositorio conectado, configuración y sitio. En la configuración del dashboard y en las APIs, despliegue suele ser el término más específico.

Publicar

Escribir cambios en la documentación en Git para que puedan avanzar hacia el sitio en producción. Según la rama y la configuración de revisión, publicar puede desplegar directamente, guardar un commit en una rama o crear una pull request.

Pull request

Una propuesta para fusionar cambios de una rama de Git en otra. Las pull requests admiten revisión, discusión, comprobaciones automatizadas y despliegues de vista previa antes de que los cambios lleguen a la rama de despliegue. En GitLab se llama merge request.

Redirección

Una regla que envía a los visitantes desde una URL antigua o alternativa a un nuevo destino. Las redirecciones mantienen los enlaces funcionando cuando el contenido se mueve. Consulta Redirecciones.

Repositorio

Una colección de archivos y su historial de Git. El repositorio de documentación es la fuente de verdad para un sitio de Mintlify y contiene sus páginas, configuración y activos.

Fragmento reutilizable

Contenido almacenado en un archivo aparte e importado en una o varias páginas MDX. Actualizar el fragmento fuente actualiza todas las páginas que lo utilizan. Consulta Fragmentos reutilizables.

skill.md

Un archivo generado que describe las capacidades y la documentación de un producto para agentes de IA. Los usuarios pueden instalarlo como una skill de agente para mejorar los resultados al trabajar con el producto. Consulta skill.md.

Repositorio fuente

El repositorio que contiene el código del producto, las definiciones de la API u otro material descrito por la documentación. El agente puede utilizar un repositorio fuente conectado como contexto sin publicar sus archivos en el sitio de documentación.

Pestaña

Una sección de navegación de nivel superior para áreas paralelas de documentación que sirven a la misma audiencia, como guías y referencia de API. Consulta Pestañas.

Tema

El diseño base y el sistema visual de un sitio de documentación. Un tema controla la presentación general, mientras que los colores, las fuentes, los logotipos y otros ajustes lo personalizan. Consulta Temas.

Versión

Una estructura de navegación para publicar varias versiones de la misma documentación en paralelo, como v1 y v2. Consulta Versiones.