Skip to content

Commit b26e47f

Browse files
mintlify[bot]mintlify[bot]
authored
Documentation edits made through Mintlify web editor
1 parent c2cdc16 commit b26e47f

File tree

107 files changed

+9309
-221
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

107 files changed

+9309
-221
lines changed

‎docs.json‎

Lines changed: 393 additions & 221 deletions
Large diffs are not rendered by default.

‎es/advanced/dashboard/permissions.mdx‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
title: Editor Permissions
3+
description: Permita que más miembros de su equipo actualicen sus documentos
4+
---
5+
6+
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.
7+
8+
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.
9+
10+
<Frame>
11+
<img className="rounded-md" src="/images/editor-gate.png" />
12+
</Frame>
13+
14+
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.
15+
16+
Aprenda más sobre nuestros precios [aquí](https://mintlify.com/pricing).

‎es/advanced/dashboard/sso.mdx‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
---
2+
title: Single Sign-On (SSO)
3+
description: Personaliza cómo tu equipo puede iniciar sesión en tu panel de administración
4+
---
5+
6+
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!
7+
8+
<Note>
9+
La funcionalidad SSO está disponible en nuestro plan Enterprise.[Contáctanos](https://mintlify.com/enterprise) para saber más!
10+
</Note>
11+
12+
## Okta
13+
14+
<Tabs>
15+
<Tab title="SAML">
16+
<Steps>
17+
<Step title="Create an application">
18+
En `Applications`, haz clic para crear una nueva integración de aplicación usando SAML 2.0.
19+
</Step>
20+
21+
<Step title="Configure integration">
22+
Ingresa lo siguiente:
23+
24+
* URL de inicio de sesión único (proporcionada por Mintlify)
25+
* URI de audiencia (proporcionada por Mintlify)
26+
* Formato de ID de nombre: `EmailAddress`
27+
* Declaraciones de atributos:
28+
| Nombre | Formato de nombre | Valor |
29+
| ----------- | ----------------- | ---------------- |
30+
| `firstName` | Básico | `user.firstName` |
31+
| `lastName` | Básico | `user.lastName` |
32+
</Step>
33+
34+
<Step title="Send us your IdP information">
35+
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.
36+
Habilitaremos la conexión desde nuestro lado usando esta información.
37+
</Step>
38+
</Steps>
39+
</Tab>
40+
41+
<Tab title="OIDC">
42+
<Steps>
43+
<Step title="Create an application">
44+
En `Applications`, haz clic para crear una nueva integración de aplicación usando OIDC.
45+
Debes elegir el tipo de aplicación `Web Application`.
46+
</Step>
47+
48+
<Step title="Configure integration">
49+
Selecciona el tipo de concesión de código de autorización e ingresa la URI de redirección proporcionada por Mintlify.
50+
</Step>
51+
52+
<Step title="Send us your IdP information">
53+
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.
54+
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.
55+
</Step>
56+
</Steps>
57+
</Tab>
58+
</Tabs>
59+
60+
## Google Workspace
61+
62+
<Tabs>
63+
<Tab title="SAML">
64+
<Steps>
65+
<Step title="Create an application">
66+
En `Web and mobile apps`, selecciona `Add custom SAML app` del menú desplegable `Add app`.
67+
68+
<Frame>
69+
![](/images/gsuite-add-custom-saml-app.png)
70+
</Frame>
71+
</Step>
72+
73+
<Step title="Send us your IdP information">
74+
Copia la URL de SSO proporcionada, el ID de entidad y el certificado x509 y envíalos al equipo de Mintlify.
75+
76+
<Frame>
77+
![](/images/gsuite-saml-metadata.png)
78+
</Frame>
79+
</Step>
80+
81+
<Step title="Configure integration">
82+
En la página de detalles del proveedor de servicios, ingresa lo siguiente:
83+
84+
* URL ACS (proporcionada por Mintlify)
85+
* ID de entidad (proporcionado por Mintlify)
86+
* Formato de ID de nombre: `EMAIL`
87+
* ID de nombre: `Basic Information > Primary email`
88+
89+
<Frame>
90+
![](/images/gsuite-sp-details.png)
91+
</Frame>
92+
93+
En la siguiente página, ingresa las siguientes declaraciones de atributos:
94+
95+
| Atributo del Directorio de Google | Atributo de la Aplicación |
96+
| --------------------------------- | ------------------------- |
97+
| `First name` | `firstName` |
98+
| `Last name` | `lastName` |
99+
100+
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!
101+
</Step>
102+
</Steps>
103+
</Tab>
104+
</Tabs>

‎es/advanced/mcp/generate.mdx‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: Generador MCP
3+
description: Aprende cómo configurar tu propio Servidor MCP
4+
---
5+
6+
<Tip>
7+
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.
8+
</Tip>
9+
10+
## Comenzar
11+
12+
Ejecuta `npm i @mintlify/mcp` para instalar el `@mintlify/mcp` CLI.
13+
14+
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.
15+
16+
<Note>
17+
Asegúrate de activar el acceso OpenAPI para permitir que el servidor MCP acceda a **todos**
18+
los endpoints en tu especificación OpenAPI.
19+
</Note>
20+
21+
## Inicie el servidor MCP localmente
22+
23+
<Steps>
24+
<Step title="Install the server through the CLI">
25+
Ejecute el siguiente comando para instalar el servidor:
26+
27+
```bash
28+
npx @mintlify/mcp add [your subdomain]
29+
```
30+
</Step>
31+
32+
<Step title="Add the authentication token if applicable">
33+
Si su API requiere un token de autenticación, indique a su cliente final que lo
34+
obtenga y lo aplique cuando reciba esta respuesta:`> What is the Authorization
35+
(basic token)?` De lo contrario, puede omitir este paso.
36+
</Step>
37+
38+
<Step title="Start your MCP server">
39+
Ahora puede ejecutar:`bash npm --prefix ~/.mcp/[your subdomain] start `
40+
</Step>
41+
</Steps>

‎es/advanced/mcp/quickstart.mdx‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
---
2+
title: Quickstart
3+
description: Generar un servidor MCP para ayudar a conectar tu producto con LLMs
4+
---
5+
6+
## Introducción
7+
8+
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.
9+
10+
Mintlify te permite crear un servidor MCP que permite a las herramientas de IA interactuar con tus documentos en estos escenarios clave:
11+
12+
1. **Docs Q\&A**, similar a nuestro Chat de IA. Esto está habilitado automáticamente para tus documentos, no se requiere configuración.
13+
2. **Consulta 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.
14+
15+
<Note>
16+
Al habilitar el interruptor OpenAPI, estás permitiendo que el servidor MCP acceda a
17+
**todos** los endpoints en tu especificación OpenAPI.
18+
</Note>
19+
20+
## Instalar el servidor MCP
21+
22+
<Tip>
23+
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[MCP Generator](/advanced/mcp/generate).
24+
</Tip>
25+
26+
## Ejemplo de instalación con el servidor MCP de Mintlify
27+
28+
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.
29+
30+
## Iniciar el servidor MCP localmente
31+
32+
<Steps>
33+
<Step title="Install the server through the CLI">
34+
Ejecuta el siguiente comando para instalar el servidor:
35+
36+
```bash
37+
npx @mintlify/mcp add mintlify
38+
```
39+
</Step>
40+
41+
<Step title="Add the authentication token">
42+
La siguiente respuesta se mostrará después de ejecutar el comando anterior:
43+
44+
```
45+
> What is the Authorization (basic token)?
46+
```
47+
48+
Usando tu clave de chat API, copia el token de autenticación y pégalo en la CLI.
49+
</Step>
50+
51+
<Step title="Start your MCP server">
52+
Ahora puedes ejecutar:
53+
54+
```bash
55+
npm --prefix ~/.mcp/mintlify start
56+
```
57+
</Step>
58+
</Steps>
59+
60+
## Usa tu servidor con Claude
61+
62+
<Note>
63+
Descarga la[Aplicación de Escritorio de Claude](https://claude.ai/download)
64+
</Note>
65+
66+
Una vez que tengas instalada la Aplicación de Escritorio de Claude, sigue estos pasos:
67+
68+
<Steps>
69+
<Step title="Navigate to the Settings > Developer" />
70+
71+
<Step title="Click on Edit Config">
72+
Agrega lo siguiente al`claude_desktop_config.json`:
73+
74+
```json
75+
{
76+
"mcpServers": {
77+
"mintlify": {
78+
"command": "npm",
79+
"args": [
80+
"--prefix",
81+
"~/.mcp/mintlify",
82+
"start"
83+
]
84+
}
85+
}
86+
}
87+
```
88+
</Step>
89+
90+
<Step title="If you see the hammer icon, you're all set!">
91+
Si haces clic en él, deberías ver las Herramientas MCP disponibles en tu servidor.
92+
93+
<Frame>
94+
![Claude MCP](/images/mcp-with-claude.png)
95+
</Frame>
96+
</Step>
97+
</Steps>

‎es/advanced/rest-api/chat/create-topic.mdx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
---
2+
openapi: POST /chat/topic
3+
---

‎es/advanced/rest-api/chat/generate-message.mdx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
---
2+
openapi: POST /chat/message
3+
---

‎es/advanced/rest-api/overview.mdx‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: Descripción General
3+
---
4+
5+
## Activar Actualizaciones
6+
7+
Puedes aprovechar la API REST para activar programáticamente una actualización cuando lo desees.
8+
9+
<Info>
10+
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
11+
[nuestra comunidad](https://mintlify.com/community)!
12+
</Info>
13+
14+
## Autenticación
15+
16+
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.
17+
18+
<Frame>
19+
<img src="/images/external-api-key.png" />
20+
</Frame>
21+
22+
## Clave API de Administrador
23+
24+
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).
25+
26+
## Clave API de Chat
27+
28+
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.
29+
30+
Las respuestas incluyen citas para que puedas dirigir a tus usuarios a los lugares correctos donde necesitan obtener ayuda.
31+
32+
<Note>
33+
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.
34+
</Note>
35+
36+
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).

‎es/advanced/rest-api/update/status.mdx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
---
2+
openapi: GET /project/update-status/{statusId}
3+
---

‎es/advanced/rest-api/update/trigger.mdx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
---
2+
openapi: POST /project/update/{projectId}
3+
---

0 commit comments

Comments
 (0)