mintlify · mintlify-development · Apr 4, 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: Permisos del Editor
+description: Permite que más miembros de tu equipo actualicen tu documentación
+---
+
+El miembro del equipo que creó tu documentación inicial tendrá acceso de actualización a tu documentación, siempre que haga push al repositorio de documentación con la misma cuenta de GitHub que se usó al registrarse en Mintlify.
+
+Si otro editor intenta actualizar la documentación mientras está en el plan gratuito, verás una advertencia en la verificación de tu 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ás el enlace para actualizar tu plan. También puedes actualizar tu plan en el [panel de control](https://dashboard.mintlify.com) para permitir que editores ilimitados actualicen tu documentación. Una vez que actualices tu plan, activa una actualización manual o haz push de otro cambio para implementar tus actualizaciones.
+
+Aprende 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: Inicio de Sesión Único (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, ¡por favor 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 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, ¡avisa a nuestro equipo 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: MCP Generator
+description: Aprende cómo configurar tu propio Servidor MCP
+---
+
+<Tip>
+  Esta página está dedicada a la configuración de tu propio Servidor MCP. Si estás buscando información sobre cómo usar el Servidor MCP de Mintlify, por favor consulta la
+  [página de Instalación y uso del Servidor MCP de Mintlify](/advanced/mcp/quickstart).
+</Tip>
+
+## Comenzar
+
+Ejecuta `npm i @mintlify/mcp` para instalar el `@mintlify/mcp` CLI.
+
+En el [panel de control](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 puntos finales en tu especificación OpenAPI.
+</Note>
+
+## 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 [your subdomain]
+    ```
+  </Step>
+
+  <Step title="Add the authentication token if applicable">
+    Si tu API requiere un token de autenticación, indica a tu cliente final que lo obtenga y lo aplique cuando reciba esta respuesta: `> What is the Authorization
+        (basic token)?` De lo contrario, puedes omitir este paso.
+  </Step>
+
+  <Step title="Start your MCP server">
+    Ahora puedes 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: Inicio Rápido
+description: Genera 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 a la`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 Claude](https://claude.ai/download)
+</Note>
+
+Una vez que tengas instalada la Aplicación de Escritorio 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,38 @@
+---
+title: Overview
+---
+
+## Activar Actualizaciones
+
+Puede aprovechar la API REST para activar programáticamente una actualización cuando lo desee.
+
+<Info>
+  Si bien el caso de uso principal será activar actualizaciones, iremos agregando más y más
+  funcionalidad a la API con el tiempo. Déjenos saber qué más quiere ver en
+  [nuestra comunidad](https://mintlify.com/community)!
+</Info>
+
+## Autenticación
+
+Puedes generar una clave API a través de
+[el panel de control](https://dashboard.mintlify.com/settings/organization/api-keys). La clave API está asociada con toda la organización y puede ser utilizada en múltiples implementaciones.
+
+<Frame>
+  <img src="/images/external-api-key.png" />
+</Frame>
+
+## Clave API de Administrador
+
+La clave API de Administrador se utiliza para la mayoría de la API. Se usa para activar actualizaciones a través del [punto final 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).