Documentation Index
Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Acerca del Admin MCP
docs.json, abrir pull requests, cambiar configuraciones, crear workflows y más.
Conecta cualquier cliente MCP como Claude, Claude Code o Cursor al servidor Admin MCP para colaborar en tu contenido y configuración de Mintlify con las mismas herramientas que usas para escribir código. Cuando usas el servidor Admin MCP, todos los cambios ocurren en una rama y requieren una pull request para fusionarse.
El servidor Admin MCP permite que las herramientas de IA accedan a tu panel de Mintlify. Trátalo como a un compañero de trabajo con acceso de escritura. Conéctalo solo desde herramientas de IA de confianza y revisa cada pull request antes de fusionarla.
Cómo se diferencia el Admin MCP del Search MCP
| Admin MCP | Search MCP | |
|---|---|---|
| Audiencia | Tu equipo | Tus usuarios finales |
| Acceso | Leer, editar, reestructurar, guardar, crear workflows, gestionar la configuración | Leer y buscar en las páginas publicadas |
| Endpoints | Alojado por Mintlify, limitado a tu proyecto | /mcp en el dominio de tu sitio |
| Salida | Ediciones de contenido, cambios de navegación, pull requests, ejecuciones de workflows | Resultados de búsqueda y contenido de páginas |
Conectarse al Admin MCP
- Claude
- Claude Code
- Cursor
Agregar el Admin MCP como conector personalizado
- Navega a la página Connectors en la configuración de Claude.
- Haz clic en Add custom connector.
- Agrega el conector
- Nombre: Admin MCP
- URL:
https://mcp.mintlify.com
- Haz clic en Add y completa el inicio de sesión OAuth.
Cómo funciona una sesión
Hacer checkout de una rama
La primera llamada debe ser
checkout. Crea una nueva rama mintlify-mcp/<slug>-<sha> a partir de tu rama de despliegue (o se adjunta a una rama existente que indiques) y devuelve un editorUrl que puedes abrir para seguir el progreso en el editor del panel.Llama a list_branches antes de checkout si necesitas descubrir o filtrar las ramas existentes en el repositorio.Leer, buscar y editar
La IA usa herramientas como
search, read, list_nodes, edit_page, write_page, create_node y update_config para realizar cambios. Todas las ediciones se mantienen en la rama de la sesión en tiempo real; nada toca aún tu rama de despliegue.Revisar el diff
Llama a
diff en cualquier momento para ver exactamente qué ha cambiado desde main. Abre el editorUrl en tu panel para ver los mismos cambios renderizados.Guardar
Llama a
save para enviar la rama a Git. Usa mode: "pr" (predeterminado) para abrir una pull request, o mode: "commit" para hacer push directamente a una rama de PR existente.Qué puede hacer el Admin MCP
Contenido
read— Obtén el MDX completo de cualquier página en la rama de la sesión.search— Encuentra líneas que coincidan con una subcadena o expresión regular en todas las páginas.edit_page— Aplica una edición dirigida a una página.write_page— Sobrescribe el contenido MDX completo de una página.
list_nodes— Recorre el árbol de navegación con filtros opcionales. Filtra porparentId(usarecursive: truepara incluir todos los descendientes), uno o más tipos de nodo, o cualquier ámbito de división:language,version,tab,dropdown,anchor,productoitem. Los resultados se paginan a través de uncursoropaco.create_node— Agrega una nueva página, grupo, pestaña, ancla, versión, idioma, producto o desplegable.update_node— Actualiza las propiedades de un nodo en su lugar (renombrar un grupo, cambiar un icono, establecer una versión predeterminada).move_node— Mueve un nodo, incluido renombrar la ruta de una página.delete_node— Elimina un nodo de la navegación.
Configuración
update_config— Modificadocs.json(tema, raíces de navegación, integraciones, configuración de SEO).
Sesión
checkout— Vincula la sesión a una rama.list_branches— Lista las ramas de Git disponibles para el proyecto, con filtrado opcional porquery. Devuelve los nombres de las ramas, el total y la rama de despliegue. Llama a esto antes decheckoutpara adjuntarte a una rama existente por nombre.get_session_state— Inspecciona la rama actual, los archivos editados y el diff de navegación pendiente.diff— Lista todos los cambios entre la sesión ymain.save— Abre una pull request o hace commit en la rama de la sesión.discard_session— Descarta la sesión y sus cambios pendientes.
Ejemplos de prompts
- “Haz checkout de una rama llamada
add-billing-faqy crea una nueva página bajo el grupo FAQ titulada ‘Billing’. Redacta respuestas para las cinco preguntas de este issue de Linear.” - “Encuentra todas las páginas que mencionen el campo obsoleto
legacy_tokeny actualiza el ejemplo para que useapi_keyen su lugar. Guarda como PR titulada ‘docs: replace legacy_token references’.” - “Reorganiza la referencia de API: mueve las páginas de webhooks a un nuevo grupo llamado ‘Webhooks’ y actualiza los iconos para que coincidan con el resto de la sección.”
Buenas prácticas
Abrir la URL del editor
Abrir la URL del editor
Cada
checkout devuelve un editorUrl. Ábrelo en una pestaña aparte para ver cómo se renderizan los cambios de la IA en vivo en el editor del panel mientras escribes prompts.Revisar cada PR
Revisar cada PR
El Admin MCP es lo suficientemente potente como para reescribir cientos de páginas en una sola sesión. Antes de fusionar, lee el diff de la PR y revisa la vista previa renderizada. No apruebes cambios grandes sin revisarlos.
Usar slugs para los nombres de ramas
Usar slugs para los nombres de ramas
Pasa un
slug a checkout (por ejemplo, add-quickstart) para que la rama generada automáticamente sea legible. Sin él, el nombre de la rama deriva del token de sesión y es difícil de reconocer en tu repositorio.Mantener las sesiones enfocadas
Mantener las sesiones enfocadas
Mantén cada sesión enfocada en un solo cambio. Las sesiones más pequeñas producen pull requests más fáciles de revisar y preservan las ventanas de contexto de los agentes. Usa
discard_session y vuelve a llamar a checkout para cambiar a un trabajo no relacionado.Las sesiones mantienen una rama en memoria en el lado de Mintlify. Si abandonas una sesión sin guardarla ni descartarla, la rama persiste hasta que tu próximo checkout la sobrescriba. Evita dejar ramas
mintlify-mcp/* obsoletas en tu repositorio. Límpialas periódicamente.