mintlify · mintlify · Apr 7, 2025
diff --git a/docs.json b/docs.json
diff --git a/es/advanced/dashboard/permissions.mdx b/es/advanced/dashboard/permissions.mdx
@@ -0,0 +1,16 @@
+---
+title: Editor Permissions
+description: Permita que más miembros de su equipo actualicen sus documentos
+---
+
+El miembro del equipo que creó sus documentos iniciales tendrá acceso de actualización a sus documentos, siempre que envíe a su repositorio de documentación con la misma cuenta de GitHub que se usó al registrarse en Mintlify.
+
+Si otro editor intenta actualizar los documentos mientras está en el plan gratuito, verá una advertencia en la verificación de su commit de git.
+
+<Frame>
+  <img className="rounded-md" src="/images/editor-gate.png" />
+</Frame>
+
+En los detalles de la advertencia de verificación de git, encontrará el enlace para actualizar su plan. También puede actualizar su plan en el [panel de control](https://dashboard.mintlify.com) para permitir que editores ilimitados actualicen su documentación. Una vez que actualice su plan, active una actualización manual o envíe otro cambio para implementar sus actualizaciones.
+
+Aprenda más sobre nuestros precios [aquí](https://mintlify.com/pricing).
diff --git a/es/advanced/dashboard/sso.mdx b/es/advanced/dashboard/sso.mdx
@@ -0,0 +1,104 @@
+---
+title: Single Sign-On (SSO)
+description: Personaliza cómo tu equipo puede iniciar sesión en tu panel de administración
+---
+
+Utiliza el inicio de sesión único en tu panel mediante SAML y OIDC. Si utilizas Okta o Google Workspace, tenemos documentación específica para configurar SSO, pero si utilizas otro proveedor, ¡contáctanos!
+
+<Note>
+  La funcionalidad SSO está disponible en nuestro plan Enterprise.[Contáctanos](https://mintlify.com/enterprise) para saber más!
+</Note>
+
+## Okta
+
+<Tabs>
+  <Tab title="SAML">
+    <Steps>
+      <Step title="Create an application">
+        En `Applications`, haz clic para crear una nueva integración de aplicación usando SAML 2.0.
+      </Step>
+
+      <Step title="Configure integration">
+        Ingresa lo siguiente:
+
+        * URL de inicio de sesión único (proporcionada por Mintlify)
+        * URI de audiencia (proporcionada por Mintlify)
+        * Formato de ID de nombre: `EmailAddress`
+        * Declaraciones de atributos:
+          | Nombre      | Formato de nombre | Valor            |
+          | ----------- | ----------------- | ---------------- |
+          | `firstName` | Básico            | `user.firstName` |
+          | `lastName`  | Básico            | `user.lastName`  |
+      </Step>
+
+      <Step title="Send us your IdP information">
+        Una vez que la aplicación esté configurada, navega a la pestaña de inicio de sesión y envíanos la URL de metadatos.
+        Habilitaremos la conexión desde nuestro lado usando esta información.
+      </Step>
+    </Steps>
+  </Tab>
+
+  <Tab title="OIDC">
+    <Steps>
+      <Step title="Create an application">
+        En `Applications`, haz clic para crear una nueva integración de aplicación usando OIDC.
+        Debes elegir el tipo de aplicación `Web Application`.
+      </Step>
+
+      <Step title="Configure integration">
+        Selecciona el tipo de concesión de código de autorización e ingresa la URI de redirección proporcionada por Mintlify.
+      </Step>
+
+      <Step title="Send us your IdP information">
+        Una vez que la aplicación esté configurada, navega a la pestaña General y localiza el ID de cliente y el secreto del cliente.
+        Por favor, proporciónanos estos datos de manera segura, junto con la URL de tu instancia de Okta (por ejemplo, `<your-tenant-name>.okta.com`). Puedes enviar estos datos a través de un servicio como 1Password o SendSafely.
+      </Step>
+    </Steps>
+  </Tab>
+</Tabs>
+
+## Google Workspace
+
+<Tabs>
+  <Tab title="SAML">
+    <Steps>
+      <Step title="Create an application">
+        En `Web and mobile apps`, selecciona `Add custom SAML app` del menú desplegable `Add app`.
+
+        <Frame>
+          ![](/images/gsuite-add-custom-saml-app.png)
+        </Frame>
+      </Step>
+
+      <Step title="Send us your IdP information">
+        Copia la URL de SSO proporcionada, el ID de entidad y el certificado x509 y envíalos al equipo de Mintlify.
+
+        <Frame>
+          ![](/images/gsuite-saml-metadata.png)
+        </Frame>
+      </Step>
+
+      <Step title="Configure integration">
+        En la página de detalles del proveedor de servicios, ingresa lo siguiente:
+
+        * URL de ACS (proporcionada por Mintlify)
+        * ID de entidad (proporcionado por Mintlify)
+        * Formato de ID de nombre: `EMAIL`
+        * ID de nombre: `Basic Information > Primary email`
+
+        <Frame>
+          ![](/images/gsuite-sp-details.png)
+        </Frame>
+
+        En la siguiente página, ingresa las siguientes declaraciones de atributos:
+
+        | Atributo del Directorio de Google | Atributo de la Aplicación |
+        | --------------------------------- | ------------------------- |
+        | `First name`                      | `firstName`               |
+        | `Last name`                       | `lastName`                |
+
+        Una vez que este paso esté completo y los usuarios estén asignados a la aplicación, avísanos y habilitaremos SSO para tu cuenta!
+      </Step>
+    </Steps>
+  </Tab>
+</Tabs>
diff --git a/es/advanced/mcp/generate.mdx b/es/advanced/mcp/generate.mdx
@@ -0,0 +1,41 @@
+---
+title: Generador MCP
+description: Aprende cómo configurar tu propio Servidor MCP
+---
+
+<Tip>
+  Esta página está dedicada a configurar tu propio Servidor MCP. Si estás buscando información sobre cómo usar el Servidor MCP de Mintlify, consulta la[Instalación y uso del Servidor MCP de Mintlify](/advanced/mcp/quickstart) página.
+</Tip>
+
+## Comenzar
+
+Ejecuta `npm i @mintlify/mcp` para instalar el `@mintlify/mcp` CLI.
+
+En el [dashboard](https://dashboard.mintlify.com/products/mcp) ve a `MCP Server`, en esta página alterna para ver tu comando de instalación único. Este es el comando para instalar tu Servidor MCP con el `@mintlify/mcp` CLI.
+
+<Note>
+  Asegúrate de activar el acceso OpenAPI para permitir que el servidor MCP acceda a **todos**
+  los endpoints en tu especificación OpenAPI.
+</Note>
+
+## Inicie el servidor MCP localmente
+
+<Steps>
+  <Step title="Install the server through the CLI">
+    Ejecute el siguiente comando para instalar el servidor:
+
+    ```bash
+    npx @mintlify/mcp add [your subdomain]
+    ```
+  </Step>
+
+  <Step title="Add the authentication token if applicable">
+    Si su API requiere un token de autenticación, indique a su cliente final que lo
+    obtenga y lo aplique cuando reciba esta respuesta:`> What is the Authorization
+        (basic token)?` De lo contrario, puede omitir este paso.
+  </Step>
+
+  <Step title="Start your MCP server">
+    Ahora puede ejecutar:`bash npm --prefix ~/.mcp/[your subdomain] start `
+  </Step>
+</Steps>
diff --git a/es/advanced/mcp/quickstart.mdx b/es/advanced/mcp/quickstart.mdx
@@ -0,0 +1,97 @@
+---
+title: Quickstart
+description: Generar un servidor MCP para ayudar a conectar tu producto con LLMs
+---
+
+## Introducción
+
+El Generador MCP es una herramienta CLI que genera un servidor MCP basado en la documentación de tu empresa y la especificación OpenAPI si está disponible. Toma tu documentación y una especificación OpenAPI y genera un servidor MCP que puede ser usado con cualquier cliente MCP. El Generador MCP se entrega a través del[paquete npm](https://www.npmjs.com/package/mcp) y genera un servidor MCP que puede ser usado con cualquier cliente MCP.
+
+Mintlify te permite crear un servidor MCP que permite a las herramientas de IA interactuar con tus documentos en estos escenarios clave:
+
+1. **Preguntas y Respuestas sobre Docs**, similar a nuestro Chat de IA. Esto se habilita automáticamente para tus documentos, no se requiere configuración.
+2. **Consultas de API en tiempo real**, si tienes una especificación OpenAPI, dirígete al`Mintlify Dashboard > Products > MCP Server` y activa el interruptor para habilitar tu especificación OpenAPI.
+
+   <Note>
+     Al habilitar el interruptor OpenAPI, estás permitiendo que el servidor MCP acceda a
+     **todos** los endpoints en tu especificación OpenAPI.
+   </Note>
+
+## Instalar el servidor MCP
+
+<Tip>
+  Esta página está dedicada al Servidor MCP de Mintlify. Si estás buscando información sobre cómo generar tu MCP, por favor consulta la página del[Generador MCP](/advanced/mcp/generate).
+</Tip>
+
+## Ejemplo de instalación con el servidor MCP de Mintlify
+
+Para usar el servidor MCP de Mintlify necesitarás una[clave API](https://mintlify.com/docs/advanced/rest-api/overview#authentication) de tu cuenta de Mintlify. Si no tienes una, navega a`Settings > API Keys > Chat API Key` y crea una nueva clave.
+
+## Iniciar el servidor MCP localmente
+
+<Steps>
+  <Step title="Install the server through the CLI">
+    Ejecuta el siguiente comando para instalar el servidor:
+
+    ```bash
+    npx @mintlify/mcp add mintlify
+    ```
+  </Step>
+
+  <Step title="Add the authentication token">
+    La siguiente respuesta se mostrará después de ejecutar el comando anterior:
+
+    ```
+    > What is the Authorization (basic token)?
+    ```
+
+    Usando tu clave de chat API, copia el token de autenticación y pégalo en la CLI.
+  </Step>
+
+  <Step title="Start your MCP server">
+    Ahora puedes ejecutar:
+
+    ```bash
+    npm --prefix ~/.mcp/mintlify start
+    ```
+  </Step>
+</Steps>
+
+## Usa tu servidor con Claude
+
+<Note>
+  Descarga la[Aplicación de Escritorio de Claude](https://claude.ai/download)
+</Note>
+
+Una vez que tengas instalada la Aplicación de Escritorio de Claude, sigue estos pasos:
+
+<Steps>
+  <Step title="Navigate to the Settings > Developer" />
+
+  <Step title="Click on Edit Config">
+    Agrega lo siguiente al`claude_desktop_config.json`:
+
+    ```json
+    {
+     "mcpServers": {
+         "mintlify": {
+             "command": "npm",
+             "args": [
+                 "--prefix",
+                 "~/.mcp/mintlify",
+                 "start"
+             ]
+         }
+     }
+    }
+    ```
+  </Step>
+
+  <Step title="If you see the hammer icon, you're all set!">
+    Si haces clic en él, deberías ver las Herramientas MCP disponibles en tu servidor.
+
+    <Frame>
+      ![Claude MCP](/images/mcp-with-claude.png)
+    </Frame>
+  </Step>
+</Steps>
diff --git a/es/advanced/rest-api/chat/create-topic.mdx b/es/advanced/rest-api/chat/create-topic.mdx
@@ -0,0 +1,3 @@
+---
+openapi: POST /chat/topic
+---
diff --git a/es/advanced/rest-api/chat/generate-message.mdx b/es/advanced/rest-api/chat/generate-message.mdx
@@ -0,0 +1,3 @@
+---
+openapi: POST /chat/message
+---
diff --git a/es/advanced/rest-api/overview.mdx b/es/advanced/rest-api/overview.mdx
@@ -0,0 +1,36 @@
+---
+title: Descripción General
+---
+
+## Activar Actualizaciones
+
+Puedes aprovechar la API REST para activar programáticamente una actualización cuando lo desees.
+
+<Info>
+  Si bien el caso de uso principal será activar actualizaciones, iremos agregando más y más funcionalidades a la API con el tiempo. Házanos saber qué más quieres ver en
+  [nuestra comunidad](https://mintlify.com/community)!
+</Info>
+
+## Autenticación
+
+Puedes generar una clave API a través de[el dashboard](https://dashboard.mintlify.com/settings/organization/api-keys). La clave API está asociada con toda la organización y puede usarse en múltiples implementaciones.
+
+<Frame>
+  <img src="/images/external-api-key.png" />
+</Frame>
+
+## Clave API de Administrador
+
+La clave API de Administrador se usa para la mayoría de la API. Se utiliza para activar actualizaciones a través del [endpoint de Actualización](/advanced/rest-api/update/trigger).
+
+## Clave API de Chat
+
+La API de Chat te permite integrar la experiencia de chat con IA basada en tus documentos y continuamente actualizada en cualquier aplicación de tu elección.
+
+Las respuestas incluyen citas para que puedas dirigir a tus usuarios a los lugares correctos donde necesitan obtener ayuda.
+
+<Note>
+  El token de la API de Chat es un token público que puede ser referenciado en tu código frontend, mientras que la clave API es un token del lado del servidor que debe mantenerse en secreto.
+</Note>
+
+Ahora que tienes una clave API, revisa nuestro [ejemplo](https://github.com/mintlify/discovery-api-example) para saber cómo usar la API para el chat con IA. También puedes ver una versión implementada de este ejemplo en [chat.mintlify.com](https://chat.mintlify.com).
diff --git a/es/advanced/rest-api/update/status.mdx b/es/advanced/rest-api/update/status.mdx
@@ -0,0 +1,3 @@
+---
+openapi: GET /project/update-status/{statusId}
+---
diff --git a/es/advanced/rest-api/update/trigger.mdx b/es/advanced/rest-api/update/trigger.mdx
@@ -0,0 +1,3 @@
+---
+openapi: POST /project/update/{projectId}
+---
diff --git a/es/advanced/subpath/cloudflare.mdx b/es/advanced/subpath/cloudflare.mdx
@@ -0,0 +1,75 @@
+---
+title: Cloudflare
+description: Aloja documentación en una subruta /docs usando Cloudflare Workers
+---
+
+## Crear Worker de Cloudflare
+
+Navega a`Workers & Pages > Create application > Create worker`. Deberías ver la siguiente pantalla donde puedes crear un nuevo worker de Cloudflare.
+
+<Frame>
+  <img alt="Create a Cloudflare worker" src="/images/cloudflare/worker.png" />
+</Frame>
+
+<Warning>
+  Ten en cuenta: Si tu proveedor de DNS es Cloudflare, no deberías usar el proxy para el registro CNAME
+</Warning>
+
+### Agregar dominio personalizado
+
+Una vez que el worker esté creado, haz clic en`Configure worker`. Navega al worker
+`Settings > Triggers`. Haz clic en`Add Custom Domain` para agregar tu dominio deseado a la lista - recomendamos que agregues tanto la versión con y sin`www.`
+antepuesto al dominio.
+
+<Frame>
+  <img alt="Cloudflare worker custom domain" src="/images/cloudflare/custom-domain.png" />
+</Frame>
+
+Si tienes problemas configurando un subdirectorio personalizado,
+[contacta a nuestro equipo de soporte](mailto:[email protected]) y te guiaremos a través del proceso de actualización de tu alojamiento con nosotros.
+
+### Editar Script del Worker
+
+Haz clic en`Edit Code` y agrega el siguiente script en el código del worker.
+
+<Frame>
+  <img alt="Cloudflare edit code" src="/images/cloudflare/edit-code.png" />
+</Frame>
+
+<Tip>
+  Edita`DOCS_URL` reemplazando`[SUBDOMAIN]` con tu subdominio único y`CUSTOM_URL` con la URL base de tu sitio web.
+</Tip>
+
+```javascript
+addEventListener("fetch", (event) => {
+  event.respondWith(handleRequest(event.request));
+});
+
+async function handleRequest(request) {
+  try {
+    const urlObject = new URL(request.url);
+    // If the request is to the docs subdirectory
+    if (/^\/docs/.test(urlObject.pathname)) {
+      // Then Proxy to Mintlify
+      const DOCS_URL = "[SUBDOMAIN].mintlify.dev";
+      const CUSTOM_URL = "[YOUR_DOMAIN]";
+
+      let url = new URL(request.url);
+      url.hostname = DOCS_URL;
+
+      let proxyRequest = new Request(url, request);
+
+      proxyRequest.headers.set("Host", DOCS_URL);
+      proxyRequest.headers.set("X-Forwarded-Host", CUSTOM_URL);
+      proxyRequest.headers.set("X-Forwarded-Proto", "https");
+
+      return await fetch(proxyRequest);
+    }
+  } catch (error) {
+    // if no action found, play the regular request
+    return await fetch(request);
+  }
+}
+```
+
+Haz clic en`Deploy` y espera a que los cambios se propaguen (puede tomar hasta algunas horas).