Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions es/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,21 @@ import { PreviewButton } from "/snippets/previewbutton.jsx"
## Acerca de los servidores MCP
</div>

El Model Context Protocol (MCP) es un protocolo abierto que establece conexiones estandarizadas entre aplicaciones de IA y servicios externos, como la documentación. Mintlify genera un servidor MCP a partir de tu documentación y especificaciones de OpenAPI, preparando tu contenido para el ecosistema de IA más amplio, donde cualquier cliente MCP (como Claude, Cursor, Goose y otros) puede conectarse a tu documentación y a tus APIs.
El Model Context Protocol (MCP) es un protocolo abierto que crea conexiones estandarizadas entre aplicaciones de IA y servicios externos, como la documentación. Mintlify genera un servidor MCP a partir de tu documentación y tus especificaciones OpenAPI, preparando tu contenido para el ecosistema de IA más amplio, donde cualquier cliente MCP (como Claude, Cursor, Goose y otros) puede conectarse a tu documentación y a tus API.

Tu servidor MCP expone herramientas para que las aplicaciones de IA puedan buscar en tu documentación e interactuar con tus APIs.
Tu servidor MCP expone herramientas para que las aplicaciones de IA puedan buscar en tu documentación e interactuar con tus API.

<div id="how-mcp-servers-work">
### Cómo funcionan los servidores MCP
</div>

Cuando un servidor MCP está conectado a una herramienta de IA, el LLM puede decidir usar tu documentación y tus herramientas de API durante la generación de respuestas.

- El LLM puede buscar de forma proactiva en tu documentación o llamar a tus endpoints de API mientras genera una respuesta, no solo cuando se le pide explícitamente.
- El LLM determina cuándo usar herramientas según el contexto de la conversación y la relevancia de tu documentación y tus APIs.
- Cada llamada a una herramienta se realiza durante el proceso de generación, lo que permite al LLM incorporar información en tiempo real de tu documentación y tus APIs en su respuesta.

Por ejemplo, si un usuario hace una pregunta de programación y el LLM determina que tu documentación de API es relevante, puede buscar en tu documentación de API e incluir esa información en la respuesta sin que el usuario pregunte explícitamente por tu documentación.

<div id="accessing-your-mcp-server">
## Acceder a tu servidor MCP
Expand Down
17 changes: 16 additions & 1 deletion es/deploy/preview-deployments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,4 +68,19 @@ De forma predeterminada, las implementaciones de vista previa son accesibles pú
<Frame>
<img src="/images/previews/preview-auth-light.png" alt="El interruptor de autenticación de vista previa en la página Add-ons" className="block dark:hidden" />
<img src="/images/previews/preview-auth-dark.png" alt="El interruptor de autenticación de vista previa en la página Add-ons" className="hidden dark:block" />
</Frame>
</Frame>

<div id="troubleshooting-preview-deployments">
## Solución de problemas de despliegues de vista previa
</div>

Si tu despliegue de vista previa falla, prueba estos pasos de solución de problemas.

- **Ver los registros de compilación**: En tu [dashboard](https://dashboard.mintlify.com/), ve a **Previews** y haz clic en la vista previa fallida. Los registros del despliegue muestran los errores que provocaron el fallo.
- **Revisar tu configuración**:
- Sintaxis no válida en `docs.json`
- Rutas de archivos que faltan o son incorrectas en tu navegación
- Frontmatter no válido en archivos MDX
- Enlaces de imágenes rotos o archivos de imagen inexistentes
- **Validar localmente**: Ejecuta `mint dev` localmente para detectar errores de compilación antes de hacer push a tu repositorio.
- **Revisar cambios recientes**: Revisa los commits más recientes en tu rama para identificar qué cambios hicieron que la compilación fallara.
12 changes: 2 additions & 10 deletions es/editor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -91,17 +91,9 @@ Modo Markdown proporciona acceso directo al código `MDX` subyacente de tu docum
### Navega por tus archivos
</div>

Usa el explorador de archivos de la barra lateral para explorar tu documentación. Haz clic en cualquier archivo para abrirlo en el editor.
Usa el explorador de archivos de la barra lateral para explorar tus archivos de documentación. Haz clic en cualquier archivo para abrirlo en el editor.

Pulsa <kbd>Command</kbd>

* <kbd>P</kbd>

en macOS o <kbd>Ctrl</kbd>

* <kbd>P</kbd>

en Windows para buscar archivos por nombre.
Pulsa <kbd>Command</kbd> + <kbd>P</kbd> en macOS o <kbd>Ctrl</kbd> + <kbd>P</kbd> en Windows para buscar archivos por nombre.

<div id="create-new-pages">
### Crear páginas nuevas
Expand Down
25 changes: 21 additions & 4 deletions es/integrations/analytics/mixpanel.mdx
Original file line number Diff line number Diff line change
@@ -1,15 +1,32 @@
---
title: "Mixpanel"
description: "Haz seguimiento de la analítica de producto y del comportamiento de los usuarios con Mixpanel."
keywords: ["Mixpanel integration", "product analytics", "event tracking", "token"]
description: "Realiza el seguimiento de la analítica de producto y del comportamiento de los usuarios con Mixpanel."
keywords: ["integración con Mixpanel", "analítica de producto", "seguimiento de eventos", "token"]
---

Agrega lo siguiente a tu archivo `docs.json` para enviar Analytics a Mixpanel.
Agrega lo siguiente a tu archivo `docs.json` para enviar datos de analítica a Mixpanel.

```json Analytics options in docs.json
"integrations": {
"mixpanel": {
"projectToken": "required"
"projectToken": "YOUR_MIXPANEL_PROJECT_TOKEN"
}
}
```

Reemplaza `YOUR_MIXPANEL_PROJECT_TOKEN` por el token de tu proyecto de Mixpanel. Puedes encontrarlo en la [configuración de tu proyecto de Mixpanel](https://mixpanel.com/settings/project).


<div id="tracked-events">
## Eventos registrados
</div>

Mintlify registra automáticamente las siguientes interacciones de usuario:

- Vistas de página
- Búsquedas
- Envío de comentarios
- Interacciones con el menú contextual
- Clics de navegación

Si no ves eventos en Mixpanel, asegúrate de que el token de tu proyecto sea correcto y de que ninguna política de seguridad de contenido esté bloqueando el script de Mixpanel.
9 changes: 1 addition & 8 deletions es/integrations/support/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,11 +34,4 @@ keywords: ["plataformas de soporte al cliente", "integración con mesa de ayuda"
## Habilitar integraciones de soporte
</div>

Integra widgets de atención al cliente en tu documentación. Añade el campo `integrations` a tu archivo `docs.json` con el ID de la aplicación correspondiente.

```json
"integrations": {
"intercom": "APP_ID",
"frontchat": "CHAT_ID"
}
```
Integra widgets de atención al cliente en tu documentación. Agrega el campo `integrations` a tu archivo `docs.json` con el ID de tu aplicación o el ID de chat correspondiente. Consulta la documentación de cada integración para obtener instrucciones sobre cómo encontrar tu ID.
36 changes: 31 additions & 5 deletions es/optimize/seo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,22 +42,48 @@ Si utilizas un dominio personalizado, establece la metaetiqueta `canonical` para
```

<div id="page-specific-meta-tags">
## Metadatos meta específicos de la página
## Metaetiquetas específicas de página
</div>

Para definir metadatos meta específicos de la página, agréguelos al frontmatter de la página.
Para configurar metaetiquetas específicas de página, agrégalas al frontmatter de la página.

Las siguientes metaetiquetas se admiten a nivel de página:

* `title` - Título de la página
* `description` - La descripción de la página aparece debajo del título en la página y en algunos resultados de motores de búsqueda
* `keywords` - Palabras clave separadas por comas
* `og:title` - Título de Open Graph para compartir en redes sociales
* `og:description` - Descripción de Open Graph
* `og:image` - URL de la imagen de Open Graph
* `og:url` - URL de Open Graph
* `og:type` - Tipo de Open Graph como &quot;article&quot; o &quot;website&quot;
* `og:image:width` - Ancho de la imagen de Open Graph
* `og:image:height` - Altura de la imagen de Open Graph
* `twitter:title` - Título de la tarjeta de Twitter
* `twitter:description` - Descripción de la tarjeta de Twitter
* `twitter:image` - Imagen de la tarjeta de Twitter
* `twitter:card` - Tipo de tarjeta de Twitter como &quot;summary&quot; o &quot;summary&#95;large&#95;image&quot;
* `twitter:site` - Cuenta del sitio en Twitter
* `twitter:image:width` - Ancho de la imagen de Twitter
* `twitter:image:height` - Altura de la imagen de Twitter
* `noindex` - Establécelo en `true` para evitar que los motores de búsqueda indexen la página
* `robots` - Valor de la metaetiqueta robots

```mdx
---
title: "El título de tu página de ejemplo"
"og:image": "enlace a la imagen de tu etiqueta meta"
title: "Título de tu página de ejemplo"
description: "Descripción específica de la página"
"og:image": "enlace a tu imagen de meta tag"
"og:title": "Título para redes sociales"
keywords: ["keyword1", "keyword2"]
---
```

<Note>
Las metaetiquetas con dos puntos deben estar entre comillas.
Las metaetiquetas con dos puntos deben ir entre comillas. El campo `keywords` debe estar en formato de lista YAML.
</Note>


<div id="common-meta-tags-reference">
## Referencia de etiquetas meta comunes
</div>
Expand Down
11 changes: 8 additions & 3 deletions es/organize/navigation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -81,14 +81,19 @@ En el objeto `navigation`, `groups` es un arreglo en el que cada entrada es un o
```

<div id="default-expanded-state">
### Estado expandido por defecto
### Estado expandido predeterminado
</div>

Establece `expanded: true` en un grupo para que se muestre expandido por defecto en la barra lateral de navigation. Esto es útil para resaltar secciones importantes o mejorar el descubrimiento del contenido clave.
Usa la propiedad `expanded` para controlar el estado predeterminado de un grupo en la barra lateral de navegación.

* `expanded: true`: El grupo aparece expandido de forma predeterminada.
* `expanded: false` u omitido: El grupo aparece contraído de forma predeterminada.

Esto es útil para resaltar secciones importantes o mejorar la facilidad para descubrir contenido clave.

```json
{
"group": "Comenzar",
"group": "Primeros pasos",
"expanded": true,
"pages": ["quickstart", "installation"]
}
Expand Down
14 changes: 13 additions & 1 deletion fr/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,22 @@ import { PreviewButton } from "/snippets/previewbutton.jsx"
## À propos des serveurs MCP
</div>

Le Model Context Protocol (MCP) est un protocole ouvert qui standardise les connexions entre les applications d’IA et des services externes, comme la documentation. Mintlify génère un serveur MCP à partir de votre documentation et de vos spécifications OpenAPI, afin de préparer votre contenu pour l’écosystème plus large de l’IA, où n’importe quel client MCP (comme Claude, Cursor, Goose, etc.) peut se connecter à votre documentation et à vos API.
Le Model Context Protocol (MCP) est un protocole ouvert qui crée des connexions standardisées entre les applications d’IA et des services externes, comme la documentation. Mintlify génère un serveur MCP à partir de votre documentation et de vos spécifications OpenAPI, en préparant votre contenu pour un écosystème d’IA plus vaste dans lequel n’importe quel client MCP (comme Claude, Cursor, Goose et d’autres) peut se connecter à votre documentation et à vos API.

Votre serveur MCP expose des outils permettant aux applications d’IA de rechercher dans votre documentation et d’interagir avec vos API.

<div id="how-mcp-servers-work">
### Fonctionnement des serveurs MCP
</div>

Lorsqu'un serveur MCP est connecté à un outil d'IA, le LLM peut décider d'utiliser votre documentation et vos outils d'API pendant la génération d'une réponse.

- Le LLM peut rechercher de manière proactive dans votre documentation ou appeler vos endpoints d'API pendant la génération d'une réponse, et pas uniquement lorsqu'on le lui demande explicitement.
- Le LLM détermine quand utiliser les outils en fonction du contexte de la conversation et de la pertinence de votre documentation et de vos API.
- Chaque appel d'outil a lieu pendant le processus de génération, ce qui permet au LLM d'intégrer en temps réel des informations provenant de votre documentation et de vos API dans sa réponse.

Par exemple, si un utilisateur pose une question de programmation et que le LLM détermine que la documentation de votre API est pertinente, il peut rechercher dans cette documentation et inclure ces informations dans la réponse sans que l'utilisateur ait à demander explicitement à consulter votre documentation.

<div id="accessing-your-mcp-server">
## Accéder à votre serveur MCP
</div>
Expand Down
17 changes: 16 additions & 1 deletion fr/deploy/preview-deployments.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,4 +68,19 @@ Par défaut, les déploiements de prévisualisation sont accessibles publiquemen
<Frame>
<img src="/images/previews/preview-auth-light.png" alt="L’interrupteur d’authentification des prévisualisations sur la page Modules complémentaires" className="block dark:hidden" />
<img src="/images/previews/preview-auth-dark.png" alt="L’interrupteur d’authentification des prévisualisations sur la page Modules complémentaires" className="hidden dark:block" />
</Frame>
</Frame>

<div id="troubleshooting-preview-deployments">
## Dépannage des déploiements de prévisualisation
</div>

Si votre déploiement de prévisualisation échoue, essayez les étapes de dépannage suivantes.

- **Consultez les journaux de build** : Dans votre [dashboard](https://dashboard.mintlify.com/), allez dans **Previews** et cliquez sur la prévisualisation ayant échoué. Les journaux de déploiement affichent les erreurs qui ont provoqué l’échec du déploiement.
- **Vérifiez votre configuration** :
- Syntaxe `docs.json` invalide
- Chemins de fichiers manquants ou incorrects référencés dans votre navigation
- Frontmatter invalide dans les fichiers MDX
- Liens d’images cassés ou fichiers d’images manquants
- **Validez en local** : Exécutez `mint dev` en local pour détecter les erreurs de build avant de pousser sur le dépôt.
- **Vérifiez les modifications récentes** : Passez en revue les derniers commits dans votre branche pour identifier les modifications qui ont provoqué l’échec du build.
14 changes: 3 additions & 11 deletions fr/editor.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -87,20 +87,12 @@ Le mode Markdown offre un accès direct au code `MDX` sous-jacent de votre docum
</div>

<div id="navigate-your-files">
### Parcourez vos fichiers
### Parcourir vos fichiers
</div>

Utilisez l’explorateur de fichiers dans la barre latérale pour parcourir vos fichiers de documentation. Cliquez sur un fichier pour l’ouvrir dans l’éditeur.
Utilisez l’explorateur de fichiers dans la barre latérale pour parcourir vos fichiers de documentation. Cliquez sur n’importe quel fichier pour l’ouvrir dans l’éditeur.

Appuyez sur <kbd>Command</kbd>

* <kbd>P</kbd>

sur macOS, ou sur <kbd>Ctrl</kbd>

* <kbd>P</kbd>

sur Windows pour rechercher des fichiers par nom.
Appuyez sur <kbd>Commande</kbd> + <kbd>P</kbd> sur macOS ou <kbd>Ctrl</kbd> + <kbd>P</kbd> sur Windows pour rechercher des fichiers par nom.

<div id="create-new-pages">
### Créer de nouvelles pages
Expand Down
25 changes: 21 additions & 4 deletions fr/integrations/analytics/mixpanel.mdx
Original file line number Diff line number Diff line change
@@ -1,15 +1,32 @@
---
title: "Mixpanel"
description: "Suivez l’analytics produit et le comportement des utilisateurs avec Mixpanel."
keywords: ["Mixpanel integration", "product analytics", "event tracking", "token"]
description: "Suivez les indicateurs produit et le comportement des utilisateurs avec Mixpanel."
keywords: ["intégration Mixpanel", "analyses produit", "suivi des événements", "jeton"]
---

Ajoutez ce qui suit à votre fichier `docs.json` pour envoyer des analytics à Mixpanel.
Ajoutez ce qui suit à votre fichier `docs.json` pour envoyer des données d&#39;analyse à Mixpanel.

```json Analytics options in docs.json
"integrations": {
"mixpanel": {
"projectToken": "required"
"projectToken": "YOUR_MIXPANEL_PROJECT_TOKEN"
}
}
```

Remplacez `YOUR_MIXPANEL_PROJECT_TOKEN` par votre jeton de projet Mixpanel. Vous le trouverez dans les paramètres de votre projet Mixpanel : [Mixpanel project settings](https://mixpanel.com/settings/project).


<div id="tracked-events">
## Événements suivis
</div>

Mintlify suit automatiquement les interactions utilisateur suivantes :

- Pages vues
- Requêtes de recherche
- Envois de commentaires
- Interactions avec le menu contextuel
- Clics de navigation

Si vous ne voyez pas d'événements dans Mixpanel, vérifiez que le jeton de votre projet est correct et qu'aucune politique de sécurité de contenu ne bloque le script Mixpanel.
11 changes: 2 additions & 9 deletions fr/integrations/support/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,14 +31,7 @@ keywords: ["plateformes d’assistance client", "intégration au help desk", "wi
</CardGroup>

<div id="enabling-support-integrations">
## Activer les intégrations d’assistance
## Activer les intégrations de support
</div>

Intégrez des widgets d’assistance client dans votre documentation. Ajoutez le champ `integrations` à votre fichier `docs.json` avec l’ID de votre application.

```json
"integrations": {
"intercom": "APP_ID",
"frontchat": "CHAT_ID"
}
```
Intégrez des widgets de support client dans votre documentation. Ajoutez le champ `integrations` à votre fichier `docs.json` avec l’ID de votre application ou l’ID de chat correspondant. Consultez la documentation de chaque intégration pour obtenir des instructions sur la manière de trouver votre ID.
32 changes: 29 additions & 3 deletions fr/optimize/seo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,22 +42,48 @@ Si vous utilisez un domaine personnalisé, définissez la balise meta `canonical
```

<div id="page-specific-meta-tags">
## Balises meta propres à une page
## Balises méta spécifiques à une page
</div>

Pour définir des balises meta spécifiques à une page, ajoutez-les au frontmatter de la page.
Pour définir des balises méta spécifiques à une page, ajoutez-les dans le frontmatter de la page.

Les balises méta suivantes sont prises en charge au niveau de la page :

* `title` - Titre de la page
* `description` - La description de la page apparaît sous le titre sur la page et dans certains résultats des moteurs de recherche
* `keywords` - Mots-clés séparés par des virgules
* `og:title` - Titre Open Graph pour le partage sur les réseaux sociaux
* `og:description` - Description Open Graph
* `og:image` - URL de l’image Open Graph
* `og:url` - URL Open Graph
* `og:type` - Type Open Graph comme &quot;article&quot; ou &quot;website&quot;
* `og:image:width` - Largeur de l’image Open Graph
* `og:image:height` - Hauteur de l’image Open Graph
* `twitter:title` - Titre de la carte Twitter
* `twitter:description` - Description de la carte Twitter
* `twitter:image` - Image de la carte Twitter
* `twitter:card` - Type de carte Twitter comme &quot;summary&quot; ou &quot;summary&#95;large&#95;image&quot;
* `twitter:site` - Handle du compte Twitter du site
* `twitter:image:width` - Largeur de l’image Twitter
* `twitter:image:height` - Hauteur de l’image Twitter
* `noindex` - À définir sur `true` pour empêcher l’indexation par les moteurs de recherche
* `robots` - Valeur de la balise méta robots

```mdx
---
title: "Titre de votre page d'exemple"
description: "Description spécifique de la page"
"og:image": "lien vers votre image de balise meta"
"og:title": "Titre pour les réseaux sociaux"
keywords: ["mot-clé1", "mot-clé2"]
---
```

<Note>
Les balises meta contenant des deux-points doivent être entre guillemets.
Les balises méta comportant des deux-points doivent être encadrées de guillemets. Le champ `keywords` doit être formaté comme un tableau YAML.
</Note>


<div id="common-meta-tags-reference">
## Référence des balises meta courantes
</div>
Expand Down
Loading