docs: add downloadApiSpec contextual menu option

ai/contextual-menu.mdx

@@ -34,6 +34,7 @@ The contextual menu includes several pre-built options that you can enable by ad
 | **Connect to Cursor** | `cursor` | Installs your hosted MCP server in Cursor |
 | **Connect to VS Code** | `vscode` | Installs your hosted MCP server in VS Code |
 | **Connect to Devin** | `devin-mcp` | Installs your hosted MCP server in Devin |
+| **Download API spec** | `download-spec` | Downloads your deployment's OpenAPI spec. If there are multiple specs, downloads them as a zip archive. Only appears on API reference pages. |
 | **Custom options** | Object | Add custom options to the contextual menu |
 
 <Frame>
@@ -64,7 +65,8 @@ Add the `contextual` field to your `docs.json` file and specify which options yo
       "mcp",
       "cursor",
       "vscode",
-      "devin-mcp"
+      "devin-mcp",
+      "download-spec"
     ]
  }
 }

es/ai/contextual-menu.mdx

@@ -36,12 +36,17 @@ El menú contextual incluye varias opciones preconfiguradas que puedes habilitar
 | **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                                     |
 
 <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>
 
+<Note>
+  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.
+</Note>
+
 <div id="enabling-the-contextual-menu">
   ## Activar el menú contextual
 </div>
@@ -65,7 +70,8 @@ Añade el campo `contextual` a tu archivo `docs.json` y especifica qué opciones
         "mcp",
       "cursor",
       "vscode",
-      "devin-mcp"
+      "devin-mcp",
+      "downloadApiSpec"
     ]
  }
 }

fr/ai/contextual-menu.mdx

@@ -36,12 +36,17 @@ Le menu contextuel comprend plusieurs options prédéfinies que vous pouvez acti
 | **Se connecter à Cursor**                 | `cursor`     | Installe votre serveur MCP hébergé dans Cursor                                        |
 | **Se connecter à VS Code**                | `vscode`     | Installe votre serveur MCP hébergé dans VS Code                                       |
 | **Se connecter à Devin**                  | `devin-mcp`  | Installe votre serveur MCP hébergé dans Devin                                         |
+| **Télécharger la spécification d'API**    | `downloadApiSpec` | Télécharge la spécification OpenAPI de votre déploiement. Si plusieurs spécifications sont configurées, les télécharge dans une archive zip. N'apparaît que sur les pages de référence d'API. |
 | **Options personnalisées**                | Objet        | Ajoutez des options personnalisées au menu contextuel                                 |
 
 <Frame>
   <img src="/images/contextual-menu/contextual-menu.png" alt="Le menu contextuel développé affichant les éléments Copier la page, Afficher en Markdown, Ouvrir dans ChatGPT et Ouvrir dans Claude." />
 </Frame>
 
+<Note>
+  L'option `downloadApiSpec` n'apparaît que sur les pages de référence d'API (pages dont le frontmatter déclare `api`, `openapi` ou `asyncapi`). Sur les déploiements avec authentification ou authentification utilisateur activée, seuls les lecteurs authentifiés peuvent télécharger la spécification.
+</Note>
+
 <div id="enabling-the-contextual-menu">
   ## Activer le menu contextuel
 </div>
@@ -65,7 +70,8 @@ Ajoutez le champ `contextual` à votre fichier `docs.json` et indiquez les optio
       "mcp",
       "cursor",
       "vscode",
-      "devin-mcp"
+      "devin-mcp",
+      "downloadApiSpec"
     ]
  }
 }