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
18 changes: 18 additions & 0 deletions es.json
Original file line number Diff line number Diff line change
Expand Up @@ -228,6 +228,14 @@
"es/ai/model-context-protocol",
"es/ai/mintlify-mcp",
"es/optimize/search",
{
"group": "Mintlify Index",
"pages": [
"es/search-index/index",
"es/search-index/connect",
"es/search-index/mcp"
]
},
"es/optimize/seo",
"es/ai/markdown-export",
"es/optimize/pdf-exports",
Expand Down Expand Up @@ -329,6 +337,16 @@
"es/api/assistant/get-page-content"
]
},
{
"group": "Mintlify Index",
"icon": "library",
"pages": [
"es/api/search-index/introduction",
"es/api/search-index/context",
"es/api/search-index/search",
"es/api/search-index/contents"
]
},
{
"group": "Analytics",
"icon": "chart-line",
Expand Down
2 changes: 2 additions & 0 deletions es/ai-native.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,8 @@ Mintlify hospeda los archivos `llms.txt` y `skill.md` para tu documentación. Es

Tu sitio de documentación también ejecuta un servidor MCP (Model Context Protocol) que permite a los usuarios conectar tu documentación directamente con sus herramientas de IA para obtener información actualizada sobre tu producto, justo donde la necesitan.

Para preguntas de implementación que abarcan varios productos o requieren búsquedas web, [Mintlify Index](/es/search-index) ofrece a los agentes de programación un único servidor MCP y una API REST para recuperar contexto de documentación mantenida por sus editores y de la web.

La búsqueda de texto completo y la comprensión semántica ayudan a los usuarios y a las herramientas de IA a encontrar información relevante rápidamente. La búsqueda comprende la intención del usuario en lugar de limitarse a coincidir palabras clave. Y si un usuario se encuentra con un error 404, tu sitio sugiere páginas relacionadas para ayudarle a encontrar lo que busca. No se requiere configuración.

<div id="enable-ai-features">
Expand Down
20 changes: 11 additions & 9 deletions es/ai/mintlify-mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,18 +17,20 @@ Conecta cualquier cliente MCP como Claude, Claude Code, ChatGPT o Cursor al serv
El servidor Admin MCP permite que las herramientas de IA accedan a tu panel de Mintlify. Trátalo como a un compañero de trabajo con acceso de escritura. Conéctalo solo desde herramientas de IA de confianza y revisa cada pull request antes de fusionarla.
</Note>

El Admin MCP es un servicio alojado por Mintlify en `https://mcp.mintlify.com`. No hay una versión autoalojada: todos los clientes se conectan al mismo endpoint y se autentican con tu cuenta de Mintlify.
El Admin MCP es un servicio alojado por Mintlify en `https://mcp.mintlify.com`. Todos los clientes se conectan al mismo endpoint y se autentican con tu cuenta de Mintlify.

<div id="how-the-admin-mcp-differs-from-the-search-mcp">
### Cómo se diferencia el Admin MCP del Search MCP
<div id="how-the-admin-mcp-differs-from-other-mintlify-mcp-servers">
### Cómo se diferencia el Admin MCP de otros servidores MCP de Mintlify
</div>

| | Admin MCP | Search MCP |
| :-- | :-- | :-- |
| **Audiencia** | Tu equipo | Tus usuarios finales |
| **Acceso** | Leer, editar, reestructurar, guardar, crear workflows, gestionar la configuración | Leer y buscar en las páginas publicadas |
| **Endpoints** | Alojado por Mintlify, limitado a tu proyecto | `/mcp` en el dominio de tu sitio |
| **Salida** | Ediciones de contenido, cambios de navegación, pull requests, ejecuciones de workflows | Resultados de búsqueda y contenido de páginas |
| | Admin MCP | Search MCP | Index MCP |
| :-- | :-- | :-- | :-- |
| **Audiencia** | Tu equipo | Tus usuarios finales | Todos los desarrolladores y agentes |
| **Acceso** | Leer, editar, reestructurar, guardar, crear workflows, gestionar la configuración | Leer y buscar en las páginas publicadas de un sitio | Leer y buscar en todos los sitios de Mintlify |
| **Endpoint** | `https://mcp.mintlify.com` | `/mcp` en el dominio de tu sitio | `https://index.mintlify.com` |
| **Salida** | Ediciones de contenido, cambios de navegación, pull requests, ejecuciones de workflows | Resultados de búsqueda y contenido de páginas de tu sitio | Resultados de búsqueda y contenido de páginas de todos los sitios de Mintlify |

Consulta la [referencia del MCP de Mintlify Index](/es/search-index/mcp) para ver sus entradas de herramientas y límites de uso.

<div id="prerequisites">
## Requisitos previos
Expand Down
2 changes: 1 addition & 1 deletion es/ai/model-context-protocol.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ El Model Context Protocol (MCP) es un protocolo abierto que crea conexiones esta
Tu servidor Search MCP expone herramientas para que las aplicaciones de IA busquen y recuperen tu contenido. Tus usuarios deben conectar tu servidor Search MCP a sus herramientas.

<Tip>
¿Quieres permitir que los agentes editen tu contenido en lugar de solo leerlo? Usa el [servidor Admin MCP](/es/ai/mintlify-mcp) para acceder a un servidor MCP autenticado que expone herramientas de branching, edición de páginas, navegación y `docs.json` a agentes de confianza.
Para permitir que agentes de confianza editen tu contenido, usa el [servidor Admin MCP](/es/ai/mintlify-mcp). Para ofrecer a los agentes de programación una única fuente de recuperación en todos los sitios de Mintlify, usa [Mintlify Index](/es/search-index).
</Tip>

<div id="how-mcp-servers-work">
Expand Down
26 changes: 22 additions & 4 deletions es/api/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@ boost: 3
---

<Info>
La API REST requiere un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=api).
La API REST de la plataforma requiere un [plan Pro o Enterprise](https://mintlify.com/pricing?ref=api).

La [API REST de Mintlify Index](/es/api/search-index/introduction) usa una clave de API y una URL base independientes.
</Info>

La REST (Representational State Transfer) API de Mintlify te permite interactuar de forma programática con tu documentación, lanzar actualizaciones, integrar experiencias de chat impulsadas por IA y exportar datos de Analytics.
Expand Down Expand Up @@ -58,12 +60,20 @@ https://api.mintlify.com
## Autenticación
</div>

Puedes generar API keys en la [página de API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard. Cada API key pertenece a una organización; puedes usar API keys en múltiples implementaciones dentro de la misma organización.
Puedes generar API keys en la [página de API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard. Las claves de API de administrador e Index pertenecen a una organización. Puedes usar las mismas claves en múltiples implementaciones dentro de la misma organización. Las claves de API del Assistant pertenecen al despliegue donde las creas.

Puedes crear hasta 10 API keys por hora y por organización.

Al crear una API key, puedes configurarla para que caduque en 7, 30, 60 o 90 días, o seleccionar **Sin caducidad**. Las nuevas API keys caducan en 90 días de forma predeterminada. La página de API keys muestra una insignia **Caduca en …** para las API keys que caducan en los próximos 7 días y una insignia **Caducada** para las que ya han caducado. Las API keys caducadas dejan de funcionar, por lo que debes rotarlas o reemplazarlas antes de la fecha de caducidad.

Mintlify utiliza tres tipos de API keys, cada una con un conjunto diferente de endpoints:

| Tipo de key | Prefijo | Se usa para |
| ----------------- | ----------- | ----------------------------------------------------------------------------- |
| Admin API key | `mint_` | Actualizaciones, tareas de agente y exportaciones de Analytics. Solo servidor. |
| Assistant API key | `mint_dsc_` | Mensajes del asistente, búsqueda de documentación y contenido de páginas. Usa un proxy en producción. |
| Index API key | `mint_us_` | Búsqueda de Index, ensamblaje de contexto y recuperación de contenido. Solo servidor. |

<div id="admin-api-key">
### Clave de la API de administrador
</div>
Expand All @@ -86,11 +96,19 @@ Las keys del Assistant API comienzan con el prefijo `mint_dsc_`.
Las solicitudes de Search documentation y Get page content no consumen créditos. Las solicitudes de Create assistant message usan créditos y pueden generar excedentes.
</Note>

<div id="index-api-key">
### Clave de la API de Index
</div>

Usa una clave de la API de Index para autenticar solicitudes a la [API REST de Mintlify Index](/es/search-index). Las claves de la API de Index comienzan con el prefijo `mint_us_`.

La clave de la API de Index es un secreto del lado del servidor. No la expongas en código del lado del cliente.

<div id="restrict-keys-by-ip-address">
### Restringir claves por dirección IP
</div>

Puedes restringir opcionalmente una API key a una lista de direcciones IP o rangos CIDR permitidos. Cuando una key tiene una lista de permitidos, las solicitudes desde cualquier otra dirección IP se rechazan con una respuesta `403`. Tanto las claves de la API de administrador como las del Assistant API admiten listas de permitidos.
Puedes restringir opcionalmente una API key a una lista de direcciones IP o rangos CIDR permitidos. Cuando una key tiene una lista de permitidos, las solicitudes desde cualquier otra dirección IP se rechazan con una respuesta `403`. Las claves de las API de administrador, Assistant e Index admiten listas de permitidos.

Configura la lista de permitidos al crear la key en la [página de API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard. La lista de permitidos es fija durante la vida de la key; para cambiarla, elimina la key y crea una nueva. Si no configuras una lista de permitidos, la key acepta solicitudes desde cualquier dirección IP.

Expand Down Expand Up @@ -126,7 +144,7 @@ Solo se aceptan `read` y `write`. Cualquier otro valor devuelve una respuesta `4
### Establecer una fecha de expiración
</div>

Puedes establecer opcionalmente una fecha de expiración en cualquier API key al crearla. Cuando pasa la marca de tiempo de expiración, las solicitudes que usan la key se rechazan. Tanto las claves de la API de administrador como las del Assistant API admiten expiración.
Puedes establecer opcionalmente una fecha de expiración en cualquier API key al crearla. Cuando pasa la marca de tiempo de expiración, las solicitudes que usan la key se rechazan con una respuesta `401`. Todas las API keys admiten expiración.

Configura la expiración en la [página de API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard. La expiración es fija durante la vida de la key; para cambiarla, elimina la key y crea una nueva. Si no configuras una expiración, la key nunca expira.

Expand Down
7 changes: 7 additions & 0 deletions es/api/search-index/contents.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
title: "Obtener contenido de resultados"
sidebarTitle: "Contenido"
description: "Recupera contenido de Mintlify Index mediante el ID o la URL de un resultado después de buscar."
keywords: ["Mintlify Index", "contents API", "result IDs", "URLs"]
openapi: "/es/index-openapi.json POST /v1/contents"
---
7 changes: 7 additions & 0 deletions es/api/search-index/context.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
title: "Crear contexto de implementación"
sidebarTitle: "Contexto"
description: "Reúne contexto técnico con fuentes citadas dentro de un presupuesto de tokens para una aplicación o agente."
keywords: ["Mintlify Index", "context", "citations", "token budget"]
openapi: "/es/index-openapi.json POST /v1/context"
---
101 changes: 101 additions & 0 deletions es/api/search-index/introduction.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,101 @@
---
title: "API REST de Mintlify Index"
sidebarTitle: "Descripción general"
description: "Usa la API REST de Mintlify Index para buscar en la documentación y la web, reunir contexto con fuentes citadas y recuperar el contenido de páginas para aplicaciones y agentes."
keywords: ["Mintlify Index API", "REST API", "authentication", "API key"]
---

Usa la API REST de Mintlify Index para recuperar conocimientos técnicos para aplicaciones y agentes. La API admite tres patrones de recuperación:

- [`context`](/es/api/search-index/context) reúne contenido con fuentes citadas dentro de un presupuesto de tokens.
- [`search`](/es/api/search-index/search) devuelve resultados clasificados de documentación y la web.
- [`contents`](/es/api/search-index/contents) recupera contenido para los ID de resultados de Mintlify o las URL de resultados seleccionados.

<Info>
La API REST requiere una clave de API para tu organización. El [servidor MCP de Index](/es/search-index/mcp) público no requiere una clave de API.
</Info>

<div id="base-url">
## URL base
</div>

Envía las solicitudes a la API REST a:

```text
https://leaves.mintlify.com/api/universal-search/v1
```

Añade una ruta de endpoint a esta URL base, por ejemplo `/context`, `/search` o `/contents`.

<div id="authentication">
## Autenticación
</div>

Autentica cada solicitud con una clave de API de Index en el encabezado `Authorization`:

```http
Authorization: Bearer mint_us_...
```

Las claves de API de Index comienzan por `mint_us_`.

<Steps>
<Step title="Crear una clave de API de Index">
Abre la [página de claves de API](https://app.mintlify.com/settings/organization/api-keys) en tu dashboard y crea una clave de API de Index.

Si este tipo de clave no está disponible, tu organización no tiene acceso a la API REST de Index.
</Step>
<Step title="Guardar la clave de forma segura">
Guarda la clave en una variable de entorno del lado del servidor. Mintlify solo muestra la clave completa cuando la creas por primera vez. Guárdala de forma segura.

```bash
export MINTLIFY_INDEX_API_KEY="mint_us_..."
```

<Warning>
No expongas una clave de API de Index en código del lado del cliente ni la confirmes en el control de versiones.
</Warning>
</Step>
<Step title="Crear contexto">
Envía tu primera solicitud al endpoint `context`:

```bash
curl -X POST "https://leaves.mintlify.com/api/universal-search/v1/context" \
-H "Authorization: Bearer $MINTLIFY_INDEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "How should I configure caching in Next.js 16?",
"product": "Next.js",
"format": "txt",
"tokenBudget": 3000
}'
```

Una respuesta correcta incluye el contexto reunido con las URL de las fuentes, el número de resultados utilizados y el recuento de tokens de salida.
</Step>
</Steps>

<div id="rate-limits">
## Límites de uso
</div>

Los límites de la API REST se aplican por organización de Mintlify. Todas las claves de API de una organización comparten el mismo límite:

| Ventana | Límite |
| --- | ---: |
| Por segundo | 10 solicitudes |
| Por día | 1.000 solicitudes |

Las solicitudes que superan cualquiera de los límites devuelven `429 Too Many Requests`. Usa un backoff exponencial antes de volver a intentarlo.

<div id="errors">
## Errores
</div>

| Estado | Significado |
| --- | --- |
| `400` | El cuerpo de la solicitud no es válido. |
| `401` | Falta la clave de API, no es válida o la organización no tiene acceso a la API REST de Index. |
| `403` | La IP de la solicitud no está permitida por la clave de API. |
| `429` | La organización superó un límite de uso. |
| `500` | Index no pudo completar la solicitud. |
7 changes: 7 additions & 0 deletions es/api/search-index/search.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
title: "Buscar conocimientos técnicos"
sidebarTitle: "Búsqueda"
description: "Busca en Mintlify Index documentación técnica y resultados web clasificados."
keywords: ["Mintlify Index", "search API", "technical documentation", "ranked results"]
openapi: "/es/index-openapi.json POST /v1/search"
---
13 changes: 13 additions & 0 deletions es/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,19 @@ rss: true
noindex: true
---

<Update label="5 de agosto de 2026" tags={["Nuevos lanzamientos"]} rss={{ title:"Presentamos Mintlify Index" }}>

<div id="mintlify-index">
## Mintlify Index
</div>

[Mintlify Index](/es/search-index) proporciona a los agentes de programación una única capa de recuperación para documentación técnica mantenida por los editores y la web.

- **Servidor MCP público:** [Conecta](/es/search-index/connect) agentes de programación sin una API key. La herramienta `context` devuelve material con citas de fuentes para tareas de implementación.
- **API REST con control de acceso:** Busca fuentes clasificadas, ensambla contexto dentro de un presupuesto de tokens y recupera contenidos seleccionados mediante endpoints de API independientes. Requiere una API key de Index.

</Update>

<Update label="July 31, 2026" tags={["Nuevos lanzamientos","Mejoras","Correcciones"]} rss={{ title:"Páginas privadas, analytics del Assistant Widget, analytics de impresiones y más" }}>

<div id="new-features">
Expand Down
Loading