Recursos · Conector de Claude

Conector Claude MintlifyLo que Claude sabe hacer en tu cuenta de Mintlify.

El conector Claude Mintlify expone 15 herramientas. 5 leen tu documentación y tu sesión, 10 escriben: páginas, navegación, configuración, ramas y pull requests. Así funciona una sesión, esto puede entregar Claude y esto puede publicarse sin revisión.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Resumen

Qué cambia para un equipo de documentación

Sale un cambio de producto y algunas páginas quedan desfasadas de golpe. Con este conector le describes la corrección a Claude y él trabaja dentro de tu proyecto de Mintlify: localiza las páginas, las retoca en una rama propia, te enseña el diff y abre una pull request. Mintlify precisa que cada retoque se acumula en esa rama de sesión: nada toca la rama de despliegue antes de guardar.

Poner al día las páginas tras una versión. Se renombró un parámetro: search encuentra cada línea con el nombre viejo, edit_page corrige cada página y diff muestra el resultado antes de que nada salga de la rama.

Reordenar una sección. La referencia de la API se ha vuelto un laberinto: list_nodes recorre el árbol de navegación, create_node añade un grupo nuevo y move_node coloca las páginas dentro.

Entregarlo para revisión. Cuando la rama te convence, save abre una pull request; si cambias de idea, discard_session lo descarta todo.

Lo que Claude no puede prometer. Los retoques se quedan en una rama de sesión hasta guardarlos, pero según la configuración del proyecto, guardar puede fusionar al instante. Claude trabaja con el rol de tu cuenta de Mintlify, así que los ajustes reservados a administradores necesitan un administrador. Y nada se dispara solo: una versión nueva no despierta a Claude. Las tareas programadas o por eventos son cosa de herramientas de automatización, otro oficio que encontrarás desde la página de Integraciones.

Vocabulario

El vocabulario en un minuto

Cinco palabras que verás al conectar Mintlify.

Conector
El vínculo que configuras una vez entre Claude y una cuenta que ya tienes, para que trabaje en ella mientras te responde.
Herramienta
Una acción con nombre que el conector le abre a Claude en esa cuenta. Él elige las que necesita; la ficha del directorio las lista todas.
Autorización
La pantalla de acceso de Mintlify, donde concedes el acceso que usará Claude. Se da una vez por persona y se revoca desde los ajustes de Mintlify.
Aprobación
La confirmación que Claude espera antes de completar algo que modifica tu cuenta, mostrada en el chat en el momento oportuno.
MCP
El estándar común de los conectores: es lo que permite a un asistente como Claude hablar con un servicio externo.
Conexión

Conectar Mintlify a Claude en tres pasos

  1. 01

    Encontrar Mintlify

    En Claude, abre Customize y luego Connectors, y busca Mintlify en la lista. En un espacio Team o Enterprise, un Owner o un Primary Owner activa el conector para la organización antes de que entren los miembros.

  2. 02

    Entrar en Mintlify

    Pulsa Connect en su fila y completa el acceso en la ventana que abre Mintlify. Si la conexión falla algún día, usa Disconnect y vuelve a conectar desde la misma fila.

  3. 03

    Revisar lo que concedes

    Lee la pantalla de autorización antes de aceptar. Es de Mintlify, no de Claude, y fija qué cubre el acceso. Puedes revocarlo después desde el panel de Mintlify.

Herramientas

Las 15 herramientas, según lo que hacen

Mintlify le da a Claude 15 herramientas: 5 que leen tu cuenta, 10 que cambian algo en ella.

Dos grupos: lo que Claude lee y lo que cambia en tu proyecto. Los nombres siguen en inglés, tal como los muestra Claude.

  • 5 lectura
  • 10 escritura

Lo que Claude lee (5)

5 herramientas

Cinco herramientas que consultan páginas, navegación y la sesión en curso sin tocarlas.

read

Recupera el MDX completo de cualquier página de la rama de sesión, a partir de una ruta de archivo o un identificador. Devuelve la versión de la rama, con los retoques incluidos.

Cuándo sirve
antes de rehacer la guía de inicio, quieres que Claude la repase línea por línea.

Fuentemintlify.com · 1 de octubre de 2026 ↗

list_nodes

Lista el árbol de navegación con filtros opcionales. Así se ve cómo se ordenan páginas, grupos y pestañas antes de cualquier reorganización.

Cuándo sirve
necesitas ver cómo está montada la pestaña de guías antes de decidir dónde va una sección nueva.

Fuentemintlify.com · 1 de octubre de 2026 ↗

get_session_state

Muestra la rama actual, los archivos ya retocados en la sesión y el diff de navegación pendiente, un repaso rápido a mitad de un trabajo largo.

Cuándo sirve
al volver de una reunión, le preguntas a Claude en qué punto está la sesión antes de seguir.

Fuentemintlify.com · 1 de octubre de 2026 ↗

diff

Enumera cada diferencia entre la rama de sesión y tu rama de despliegue, para ver exactamente lo que saldría antes de guardar nada.

Cuándo sirve
una revisora quiere tener toda la sesión a la vista en un mismo sitio antes de dar el visto bueno.

Fuentemintlify.com · 1 de octubre de 2026 ↗

Lo que Claude cambia (10)

10 herramientas

Diez herramientas que abren una rama, retocan el contenido o lo entregan. Ninguna fuente describe una confirmación propia: rige la regla general de abajo.

checkout

Aprobación: ver la regla

Vincula la sesión a una rama de un proyecto, generando una rama admin-mcp nueva desde la rama de despliegue del proyecto. Si lo llamas otra vez, pasa a la sesión de otro proyecto.

Lo que Claude pide
ninguna fuente documenta una confirmación aquí, así que se aplica la regla de aprobación por defecto.
Cuándo sirve
quieres una rama limpia con el nombre del arreglo antes de tocar nada.

Fuentemintlify.com · 1 de octubre de 2026 ↗

save

Aprobación: ver la regla

Lleva el trabajo de la sesión a Git, abriendo una pull request o haciendo commit en la rama de sesión. Si el proyecto deja al agente subir a main y la rama no está protegida, Mintlify fusiona al instante.

Lo que Claude pide
nada propio de este paso está documentado; entra en la regla general.
Cuándo sirve
la reescritura está lista y espera revisión.

Fuentemintlify.com · 1 de octubre de 2026 ↗

discard_session

Aprobación: ver la regla

Tira la sesión y todos los retoques en curso. Nada de esa sesión llega a tu rama de despliegue.

Lo que Claude pide
las fuentes no dicen nada de una petición para esta, la cubre el ajuste por defecto de la sección de aprobaciones.
Cuándo sirve
un intento de reorganización salió torcido y prefieres empezar otra vez desde la rama de despliegue.

Fuentemintlify.com · 1 de octubre de 2026 ↗

edit_page

Aprobación: ver la regla

Aplica una corrección puntual a una página y deja el resto de su contenido como estaba. El cambio queda en la rama de sesión.

Lo que Claude pide
la documentación de Mintlify no describe confirmación para esta herramienta; la referencia es la regla general de Claude.
Cuándo sirve
un único ejemplo de código apunta al endpoint antiguo y solo ese bloque debe variar.

Fuentemintlify.com · 1 de octubre de 2026 ↗

write_page

Aprobación: ver la regla

Sustituye de una vez todo el contenido MDX de una página en vez de parchear un fragmento. La nueva versión se queda en la rama de sesión hasta guardar.

Lo que Claude pide
ninguna fuente menciona una petición específica; consulta la sección de aprobaciones.
Cuándo sirve
la vieja página de resolución de problemas ya no admite parches y pide un borrador nuevo.

Fuentemintlify.com · 1 de octubre de 2026 ↗

create_node

Aprobación: ver la regla

Añade a la navegación una página, grupo, pestaña, ancla, versión, idioma, producto o menú desplegable. Mintlify avisa de que los nodos no válidos pueden caerse de la navegación publicada, así que los errores se corrigen antes de guardar.

Lo que Claude pide
no hay nada documentado para esta herramienta en concreto, queda bajo la regla general de aprobación.
Cuándo sirve
las preguntas de facturación merecen su propia página dentro del grupo de FAQ.

Fuentemintlify.com · 1 de octubre de 2026 ↗

update_node

Aprobación: ver la regla

Modifica en el sitio las propiedades de un nodo: renombrar un grupo, cambiar un icono o fijar una versión por defecto, sin desplazar nada.

Lo que Claude pide
la documentación calla sobre una petición, se aplica la regla por defecto.
Cuándo sirve
un grupo sigue diciendo «Beta» aunque la función salió hace meses.
Ojo
una navegación no válida vuelve como errores que hay que arreglar antes de guardar.

Fuentemintlify.com · 1 de octubre de 2026 ↗

move_node

Aprobación: ver la regla

Lleva un nodo a otro lugar de la navegación, incluido renombrar la ruta de una página, lo que altera también la dirección a la que llegan los lectores.

Lo que Claude pide
no se describe confirmación propia de la herramienta; la sección de aprobaciones explica qué la rige.
Cuándo sirve
las páginas de webhooks andan dispersas y deben juntarse en un solo grupo.

Fuentemintlify.com · 1 de octubre de 2026 ↗

delete_node

Aprobación: ver la regla

Saca un nodo de la navegación. La retirada espera en la rama de sesión como cualquier otro retoque.

Lo que Claude pide
Mintlify no documenta petición alguna para una retirada; lo único fiable es la regla general.
Cuándo sirve
una función abandonada aún tiene su página en la barra lateral.
Ojo
si no se corrigen, los nodos no válidos pueden desaparecer de la navegación publicada.

Fuentemintlify.com · 1 de octubre de 2026 ↗

update_config

Aprobación: ver la regla

Modifica el docs.json del proyecto: tema, raíces de navegación, integraciones y ajustes SEO. En los parámetros protegidos, Mintlify exige rol de administrador en el proyecto.

Lo que Claude pide
no hay nada documentado más allá del comportamiento de aprobación por defecto de Claude.
Cuándo sirve
la identidad visual cambió y el tema de la documentación tiene que seguirla.

Fuentemintlify.com · 1 de octubre de 2026 ↗

Aprobaciones

Lo que Claude te pide antes de actuar

Por defecto, Claude se detiene y pide tu visto bueno antes de cada acción que hace en una cuenta en tu nombre. En Mintlify, la rama añade una segunda red, salvo que tu proyecto deje que guardar fusione directamente.

En Team y Enterprise, los propietarios del espacio deciden si los miembros pueden dejar pasar acciones sin preguntar, y pueden acotar lo que hace un conector en toda la organización, mantener la lectura y cerrar la escritura, por ejemplo. Claude hereda tu rol de Mintlify y nada más: Mintlify explica que la sesión OAuth lleva los permisos de tu panel. La etiqueta oficial por herramienta solo aparece en los ajustes de una cuenta conectada.

Planes

En qué planes está disponible

Ninguna de las 819 fichas del directorio oficial muestra disponibilidad por plan. Esa respuesta, conector por conector, no se publica en ninguna parte.

La regla general sí está publicada: los conectores remotos están abiertos a todos los usuarios en Claude, Cowork, Claude Desktop y móvil. En Team y Enterprise, un Owner o un Primary Owner activa el conector para la organización antes de que entren los miembros. Tu rol en Mintlify y tu acceso a Git son requisitos aparte, del lado de Mintlify. Para el estado actual, consulta la ficha del conector en el directorio oficial.

Límites

Dónde se queda corto este conector

Un conector no es una automatización. Claude llama a estas herramientas mientras te responde: nada arranca cuando se fusiona código o sale una versión.

Solo Mintlify documenta este conector: el centro de ayuda de Claude no tiene página sobre él, así que los límites de abajo son del fabricante. La página de Mintlify describe también herramientas que no figuran en la ficha del directorio; esta página solo cubre las quince listadas. La lista es un mínimo observado, no un techo. La insignia del directorio no es una auditoría de seguridad, y Anthropic indica en cada ficha que no elige las herramientas de un fabricante. Para otros conectores y páginas de automatización, recorre la página de Integraciones.

¿Necesitas ayuda?

¿Necesitas ayuda para conectar Mintlify con Claude?

Una persona lee cada mensaje.

FAQ

Preguntas frecuentes sobre el conector Claude Mintlify

01¿Qué puede hacer Claude con el conector de Mintlify?
Claude puede trabajar directamente en tu documentación de Mintlify durante una conversación. Las quince herramientas de la ficha le permiten abrir una sesión en una rama, leer y buscar en las páginas, recorrer la navegación, revisar el estado de la sesión y el diff, retocar o rehacer páginas, añadir, ajustar, reubicar o quitar nodos, actualizar docs.json y, al final, guardar el trabajo como pull request o descartarlo. Todo ocurre en una rama hasta que guardas.
02¿Puede Claude publicar cambios en mi documentación en línea?
Sí, en algunas configuraciones. Guardar abre una pull request por defecto, que luego revisa una persona. Pero Mintlify explica que si tu proyecto sube los cambios del agente directamente a la rama de despliegue y esa rama no está protegida, la pull request se fusiona en cuanto Claude guarda. Revisa tu ajuste de revisión del agente y tus reglas de protección antes de conectar: es lo que decide si alguien ve los retoques primero. Una rama protegida mantiene la revisión.
03¿Claude pregunta antes de retocar mis páginas de Mintlify?
Por defecto, Claude pide confirmación antes de cada acción que hace en una cuenta en tu nombre. Ninguna fuente describe una confirmación propia de una herramienta de Mintlify, así que esa regla cubre por igual abrir una rama, retocar, tocar la navegación y guardar. La rama de sesión añade un colchón, porque nada llega a la rama de despliegue antes de save. En Team y Enterprise, los propietarios deciden además qué acciones pasan sin preguntar.
04¿En qué planes de Claude está disponible el conector de Mintlify?
Ninguna fuente oficial publica la disponibilidad por plan conector por conector, y ninguna de las 819 fichas del directorio la muestra. La regla general dice que los conectores remotos están abiertos a todos los usuarios en Claude, Cowork, Claude Desktop y móvil, con activación por un Owner o un Primary Owner en Team y Enterprise. Tu rol en Mintlify y tu acceso a Git son requisitos aparte. La ficha del directorio muestra el estado actual para tu cuenta.
05¿Obtiene Claude permisos de administrador en nuestro proyecto de Mintlify?
No, obtiene los tuyos. Mintlify indica que la sesión OAuth hereda los permisos de tu panel, así que las acciones reservadas a administradores, como actualizar ajustes protegidos con update_config, exigen rol de administrador en el proyecto. Revocar el acceso en Settings, Security & access, Connected apps del panel de Mintlify invalida al instante los tokens de sesión activos. En Team y Enterprise, un propietario de Claude puede además restringir el conector para todos, sin que un miembro lo levante.
06¿Qué pasa con una sesión que nunca guardé?
Su rama se queda atrás. Mintlify explica que una sesión abandonada sin guardar ni descartar conserva su rama hasta que el siguiente checkout la sobrescribe. Para evitar el desorden, pídele a Claude que descarte la sesión cuando un borrador no lleva a nada, o mantén cada sesión centrada en un solo cambio para que la pull request sea fácil de revisar. Revocar el acceso OAuth, en cambio, deja en su sitio las pull requests ya abiertas.
07¿Claude o una herramienta de automatización para Mintlify?
Hacen trabajos distintos, así que elige según el uso. Claude con este conector retoca la documentación conversando: describes el arreglo, localiza las páginas, enseña el diff y abre una pull request. Una herramienta de automatización reacciona a eventos o a un calendario, por ejemplo para abrir una tarea de documentación con cada cambio de API, algo que este conector no hace nunca solo. Para reescribir y reorganizar a mano, Claude; para disparadores recurrentes, la automatización.