Menú contextual
Agrega a tu documentación un menú contextual con integraciones de IA en un clic para ChatGPT, Claude, Perplexity, Google AI Studio y herramientas MCP.
El menú contextual ofrece acceso rápido a contenido optimizado con IA e integraciones directas con herramientas de IA populares. Cuando los usuarios seleccionan el menú contextual en cualquier página, pueden copiar contenido como contexto para herramientas de IA o abrir conversaciones en ChatGPT, Claude, Perplexity, Google AI Studio, Grok, Devin, Devin Desktop o una herramienta personalizada de su elección, con su documentación ya cargada como contexto.
Combina el menú contextual con tu archivo skill.md alojado y tu servidor MCP para que los usuarios puedan instalar todas las capacidades de tu producto en sus herramientas de IA, no solo la página que están leyendo.
El menú contextual incluye varias opciones preconfiguradas que puedes habilitar agregando su identificador a tu configuración.
| Opción | Identificador | Descripción |
|---|---|---|
| Copiar página | copy | Copia la página actual como Markdown para pegarla como contexto en herramientas de IA |
| Ver como Markdown | view | Abre la página actual como Markdown |
| Preguntar a assistant | assistant | Abre el assistant con la página actual como contexto |
| Descargar PDF | download-pdf | Descarga la página actual como PDF. Disponible en los planes Enterprise. |
| Abrir en ChatGPT | chatgpt | Crea una conversación en ChatGPT con la página actual como contexto |
| Abrir en Claude | claude | Crea una conversación en Claude con la página actual como contexto |
| Abrir en Perplexity | perplexity | Crea una conversación en Perplexity con la página actual como contexto |
| Abrir en Grok | grok | Crea una conversación en Grok con la página actual como contexto |
| Abrir en Google AI Studio | aistudio | Crea una conversación en Google AI Studio con la página actual como contexto |
| Abrir en Devin | devin | Crea una sesión de Devin con la página actual como contexto |
| Abrir en Devin Desktop | devin-desktop | Abre Devin Desktop con la página actual como contexto. Requiere instalar Devin Desktop. |
| Copiar URL del servidor MCP | mcp | Copia la URL de tu servidor MCP al portapapeles |
| Copiar comando de instalación del servidor MCP | add-mcp | Copia el comando npx add-mcp para instalar el servidor MCP |
| Conectar con Cursor | cursor | Instala tu servidor MCP alojado en Cursor |
| Conectar con VS Code | vscode | Instala tu servidor MCP alojado en VS Code |
| Conectar con Devin | devin-mcp | Instala tu servidor MCP alojado en Devin |
| Descargar especificación de API | downloadApiSpec | Descarga la especificación OpenAPI de tu despliegue. Si hay varias especificaciones configuradas, las descarga como un archivo zip. Solo aparece en páginas de referencia de API. |
| Opciones personalizadas | Object | Agrega opciones personalizadas al menú contextual |
La opción downloadApiSpec solo aparece en páginas de referencia de API (páginas cuyo frontmatter declara api, openapi o asyncapi). En despliegues con autenticación o autenticación de usuario habilitada, solo los lectores autenticados pueden descargar la especificación.
Añade el campo contextual a tu archivo docs.json y especifica qué opciones quieres incluir. Las opciones aparecen en el menú en el orden en el que las enumeras.
{
"contextual": {
"options": [
"copy",
"view",
"assistant",
"download-pdf",
"chatgpt",
"claude",
"perplexity",
"grok",
"aistudio",
"devin",
"devin-desktop",
"mcp",
"cursor",
"vscode",
"devin-mcp",
"downloadApiSpec"
]
}
}De forma predeterminada, el menú contextual aparece en el encabezado de la página. Puedes configurarlo para que se muestre en la barra lateral de la tabla de contenidos mediante la opción display.
{
"contextual": {
"options": ["copy", "view", "chatgpt", "claude"],
"display": "toc"
}
}| Valor | Descripción |
|---|---|
header | Muestra las opciones en el menú contextual de la parte superior de la página (predeterminado) |
toc | Muestra las opciones en la barra lateral de la tabla de contenidos |
Crea opciones personalizadas en el menú contextual agregando un objeto al arreglo options. Cada opción personalizada requiere estas propiedades:
titlestringrequiredEl título de la opción.
descriptionstringrequiredLa descripción de la opción. Se muestra debajo del título cuando el menú contextual se expande.
Debes proporcionar icon o src.
iconstringEl icono que se mostrará desde una biblioteca de iconos.
Options:
- Font Awesome icon name, if you have the
icons.libraryproperty set tofontawesomein yourdocs.json - Lucide icon name, if you have the
icons.libraryproperty set tolucidein yourdocs.json - Nombre del icono Tabler, si tienes la
icons.librarypropiedad configurada comotableren tudocs.json
srcstringRuta o URL de una imagen para usar como icono. Usa src en lugar de icon cuando quieras utilizar una imagen personalizada en lugar de un icono de una biblioteca.
Options:
- Ruta a un archivo de imagen en tu proyecto (por ejemplo,
/images/mi-icono.svg) - URL de una imagen alojada externamente (por ejemplo,
https://example.com/icon.png)
iconTypestringThe Font Awesome icon style. Only used with Font Awesome icons.
Options: regular, solid, light, thin, sharp-solid, duotone, brands.
hrefstring | objectrequiredEl href de la opción. Usa una cadena para enlaces simples o un objeto para enlaces dinámicos con parámetros de búsqueda.
Show Hide href object
basestringrequiredLa URL base de la opción.
queryobject[]Un array de objetos de parámetros de búsqueda que se añaden a la URL base.
Show Hide query object
keystringrequiredLa key del parámetro de búsqueda.
valuestringrequiredEl value del parámetro de búsqueda. Mintlify reemplaza los siguientes marcadores de posición por los valores correspondientes:
- Usa
$pagepara insertar el contenido de la página actual en Markdown. - Usa
$pathpara insertar la ruta de la página actual. - Usa
$mcppara insertar la URL del servidor MCP alojado.
Ejemplo de opción personalizada:
{
"contextual": {
"options": [
"copy",
"view",
"chatgpt",
"claude",
"perplexity",
{
"title": "Solicitar una funcionalidad",
"description": "Únete a la discusión en GitHub para solicitar una nueva funcionalidad",
"icon": "plus",
"href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
}
]
}
}Sobrescribe el menú contextual global en una página específica añadiendo un campo contextual al frontmatter de la página. Úsalo para mostrar acciones específicas de la página, como download-pdf en una página de términos de servicio, u ocultar el menú por completo en una landing page.
El objeto contextual a nivel de página reemplaza al global en esa página. Omite el campo para heredar docs.json, o define options: [] para desactivar el menú contextual en esa página.
---
title: "Términos de servicio"
contextual:
options:
- copy
- download-pdf
display: header
---Se aplican los mismos campos y reglas de validación que en docs.json, incluidas las opciones personalizadas y la configuración display. Si la sobrescritura de página no es válida, Mintlify utiliza la configuración global de contextual.