mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
164 lines
5.4 KiB
Plaintext
164 lines
5.4 KiB
Plaintext
---
|
|
title: "Menú contextual"
|
|
description: "Agrega integraciones de IA con un clic a tu documentación."
|
|
keywords: ["Herramientas de IA", "ChatGPT", "Claude", "Perplexity", "MCP", "Grok"]
|
|
---
|
|
|
|
import { PreviewButton } from "/snippets/previewbutton.jsx"
|
|
import IconsRequired from "/snippets/es/icons-required.mdx";
|
|
|
|
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 o una herramienta personalizada de su elección, con su documentación ya cargada como contexto.
|
|
|
|
|
|
<div id="menu-options">
|
|
## Opciones del menú
|
|
</div>
|
|
|
|
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 |
|
|
| **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 |
|
|
| **Copiar URL del servidor MCP** | `mcp` | Copia la URL de tu servidor MCP al portapapeles |
|
|
| **Conectar con Cursor** | `cursor` | Instala tu servidor MCP alojado en Cursor |
|
|
| **Conectar con VS Code** | `vscode` | Instala tu servidor MCP alojado en VS Code |
|
|
| **Opciones personalizadas** | Object | Agrega opciones personalizadas al menú contextual |
|
|
|
|
<Frame>
|
|
<img
|
|
src="/images/contextual-menu/contextual-menu.png"
|
|
alt="El menú contextual expandido que muestra los elementos del menú Copiar página, Ver como Markdown, Abrir en ChatGPT y Abrir en Claude."
|
|
/>
|
|
</Frame>
|
|
|
|
<div id="enabling-the-contextual-menu">
|
|
## Activar el menú contextual
|
|
</div>
|
|
|
|
Añade el campo `contextual` a tu archivo `docs.json` y especifica qué opciones quieres incluir.
|
|
|
|
```json
|
|
{
|
|
"contextual": {
|
|
"options": [
|
|
"copy",
|
|
"view",
|
|
"chatgpt",
|
|
"claude",
|
|
"perplexity",
|
|
"grok",
|
|
"mcp",
|
|
"cursor",
|
|
"vscode"
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
|
|
<div id="adding-custom-options">
|
|
## Agregar opciones personalizadas
|
|
</div>
|
|
|
|
Crea opciones personalizadas en el menú contextual agregando un objeto al arreglo `options`. Cada opción personalizada requiere estas propiedades:
|
|
|
|
<ResponseField name="title" type="string" required>
|
|
El título de la opción.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="description" type="string" required>
|
|
La descripción de la opción. Se muestra debajo del título cuando se expande el menú contextual.
|
|
</ResponseField>
|
|
|
|
<IconsRequired />
|
|
|
|
<ResponseField name="href" type="string | object" required>
|
|
El href de la opción. Usa una cadena para enlaces simples o un objeto para enlaces dinámicos con parámetros de búsqueda.
|
|
|
|
<Expandable title="href object">
|
|
<ResponseField name="base" type="string" required>
|
|
La URL base de la opción.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="query" type="object" required>
|
|
Los parámetros de búsqueda de la opción.
|
|
|
|
<Expandable title="query object">
|
|
<ResponseField name="key" type="string" required>
|
|
La key del parámetro de búsqueda.
|
|
</ResponseField>
|
|
|
|
<ResponseField name="value" type="string" required>
|
|
El value del parámetro de búsqueda. Reemplazaremos los siguientes marcadores de posición por los valores correspondientes:
|
|
|
|
* Usa `$page` para insertar el contenido de la página actual en Markdown.
|
|
* Usa `$path` para insertar la ruta de la página actual.
|
|
* Usa `$mcp` para insertar la URL del servidor MCP alojado.
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
</Expandable>
|
|
</ResponseField>
|
|
|
|
Ejemplo de opción personalizada:
|
|
|
|
```json {9-14} wrap
|
|
{
|
|
"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"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
<div id="custom-option-examples">
|
|
### Ejemplos de opciones personalizadas
|
|
</div>
|
|
|
|
<AccordionGroup>
|
|
<Accordion title="Enlace simple">
|
|
```json
|
|
{
|
|
"title": "Solicitar una función",
|
|
"description": "Únete a la conversación en GitHub",
|
|
"icon": "plus",
|
|
"href": "https://github.com/orgs/mintlify/discussions/categories/feature-requests"
|
|
}
|
|
```
|
|
</Accordion>
|
|
|
|
<Accordion title="Enlace dinámico con contenido de la página">
|
|
```json
|
|
{
|
|
"title": "Compartir en X",
|
|
"description": "Comparte esta página en X",
|
|
"icon": "x",
|
|
"href": {
|
|
"base": "https://x.com/intent/tweet",
|
|
"query": [
|
|
{
|
|
"key": "text",
|
|
"value": "Consulta esta documentación: $page"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
</Accordion>
|
|
</AccordionGroup> |