Protocolo de Contexto del Modelo

Conecta tu documentación y endpoints de API con herramientas de IA mediante un servidor MCP alojado.

​

Acerca de los servidores MCP

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, 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.

Tu servidor MCP expone una herramienta para que las aplicaciones de IA puedan buscar en tu documentación. Tus usuarios deben conectar tu servidor MCP a sus herramientas.

​

Cómo funcionan los servidores MCP

Cuando una herramienta de IA tiene conectado tu servidor MCP de documentación, la herramienta de IA puede buscar directamente en tu documentación en lugar de realizar una búsqueda genérica en la web en respuesta al mensaje de un usuario. Tu servidor MCP proporciona acceso a todo el contenido indexado de tu sitio de documentación.

• El LLM puede buscar proactivamente en tu documentación mientras genera una respuesta, no solo cuando se le pide explícitamente.
• El LLM determina cuándo usar la herramienta de búsqueda según el contexto de la conversación y la relevancia de tu documentación.
• Cada llamada a la herramienta ocurre durante el proceso de generación, por lo que el LLM busca información actualizada de tu documentación para generar su respuesta.

Algunas herramientas de IA como Claude son compatibles tanto con MCP como con Skills. MCP da a la IA acceso al contenido de tu documentación, mientras que Skills le indican a la IA cómo usar ese contenido de forma eficaz. Son complementarios. MCP proporciona los datos y Skills proporcionan las instrucciones.

​

MCP en comparación con la búsqueda en la web

Las herramientas de IA pueden buscar en la web, pero MCP ofrece ventajas claras para la documentación.

• Acceso directo a la fuente: La búsqueda en la web depende de lo que los motores de búsqueda hayan indexado, lo cual puede estar desactualizado o incompleto. MCP busca directamente en tu documentación indexada actual.
• Flujo de trabajo integrado: MCP permite que la IA busque mientras genera la respuesta, en lugar de realizar una búsqueda web por separado.
• Sin ruido de búsqueda: Los algoritmos de SEO (optimización para motores de búsqueda) y de clasificación influyen en los resultados de búsqueda en la web. MCP va directamente al contenido de tu documentación.

​

Accede a tu servidor MCP

Los servidores MCP solo están disponibles para documentación pública. La documentación detrás de la autenticación del usuario final no puede generar un servidor MCP.

Mintlify genera automáticamente un servidor MCP para tu documentación y lo aloja en la URL de tu documentación con la ruta /mcp. Por ejemplo, el servidor MCP de Mintlify está disponible en https://mintlify.com/docs/mcp.

Puedes ver y copiar la URL de tu servidor MCP en la página del servidor MCP de tu dashboard.

Los servidores MCP alojados utilizan la ruta /mcp en sus URL. Otros elementos de navigation no pueden utilizar la ruta /mcp.

​

Filtrado de contenido e indexación

Tu servidor MCP busca contenido que Mintlify indexa a partir de tu repositorio de documentación. La forma en que se procesan los archivos y se realiza la indexación de búsqueda determina qué contenido está disponible a través de tu servidor MCP.

​

Procesamiento de archivos con .mintignore

Si los archivos coinciden con los patrones de .mintignore, Mintlify no los procesa ni los indexa. Estos archivos no están disponibles mediante tu servidor MCP.

​

Indexación de búsqueda con docs.json

De forma predeterminada, Mintlify solo indexa las páginas incluidas en la navigation de tu docs.json para la búsqueda a través de tu servidor MCP.

Mintlify excluye las páginas ocultas (páginas que no están en tu navigation) del índice de búsqueda a menos que elijas indexar todas las páginas. Para incluir páginas ocultas en los resultados de búsqueda de tu servidor MCP, agrega la propiedad seo.indexing a tu docs.json.

"seo": {
    "indexing": "all"
}

Para excluir una página específica de la indexación en buscadores, agrega noindex: true a su frontmatter.

---
title: "Página oculta"
description: "Esta página no está en la navegación y no está disponible mediante búsqueda."
noindex: true
---

​

Usa tu servidor MCP

Tus usuarios deben conectar tu servidor MCP a sus herramientas de IA preferidas.

1. Haz que la URL de tu servidor MCP sea pública.
2. Los usuarios copian la URL de tu servidor MCP y la añaden a sus herramientas.
3. Los usuarios acceden a tu documentación desde sus herramientas.

Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu servidor MCP:

Menú contextual

Agrega opciones en el menú contextual para que tus usuarios se conecten a tu servidor MCP desde cualquier página de tu documentación.

Opción	Identificador	Descripción
Copiar URL del servidor MCP	mcp	Copia la URL de tu servidor MCP en el portapapeles del usuario.
Conectar con Cursor	cursor	Instala tu servidor MCP en Cursor.
Conectar con VS Code	vscode	Instala tu servidor MCP en VS Code.

Claude

1. Obtén la URL de tu servidor MCP.

   Ve a tu dashboard y encuentra la URL de tu servidor MCP.

2. Publica la URL de tu servidor MCP para tus usuarios.

   Crea una guía para tus usuarios que incluya la URL de tu servidor MCP y los pasos para conectarlo a Claude.

   1. Ve a la página de Connectors en la configuración de Claude.
   2. Selecciona Add custom connector.
   3. Agrega el nombre y la URL de tu servidor MCP.
   4. Selecciona Add.
   5. Al usar Claude, selecciona el botón de adjuntos (el ícono de más).
   6. Selecciona tu servidor MCP.

Consulta la documentación de Model Context Protocol para más detalles.

Claude Code

1. Obtén la URL de tu servidor MCP.

   Ve a tu dashboard y encuentra la URL de tu servidor MCP.

2. Publica la URL de tu servidor MCP para tus usuarios.

   Crea una guía para tus usuarios que incluya la URL de tu servidor MCP y el comando para conectarlo a Claude Code.

   claude mcp add --transport http <name> <url>
   

Consulta la documentación de Claude Code para más detalles.

Cursor

1. Obtén la URL de tu servidor MCP.

   Ve a tu dashboard y encuentra la URL de tu servidor MCP.

2. Publica la URL de tu servidor MCP para tus usuarios.

   Crea una guía para tus usuarios que incluya la URL de tu servidor MCP y los pasos para conectarlo a Cursor.

   1. Usa Command + Shift + P (Ctrl + Shift + P en Windows) para abrir la paleta de comandos.
   2. Busca “Open MCP settings”.
   3. Selecciona Add custom MCP. Esto abrirá el archivo mcp.json.
   4. En mcp.json, configura tu servidor:

   {
     "mcpServers": {
       "<your-mcp-server-name>": {
         "url": "<your-mcp-server-url>"
       }
     }
   }
   

Consulta la documentación de Cursor para más detalles.

VS Code

1. Obtén la URL de tu servidor MCP.

   Ve a tu dashboard y encuentra la URL de tu servidor MCP.

2. Publica la URL de tu servidor MCP para tus usuarios.

   Crea una guía para tus usuarios que incluya la URL de tu servidor MCP y los pasos para conectarlo a VS Code.

   1. Crea un archivo .vscode/mcp.json.
   2. En mcp.json, configura tu servidor:

   {
     "servers": {
       "<your-mcp-server-name>": {
         "type": "http",
         "url": "<your-mcp-server-url>"
       }
     }
   }
   

Consulta la documentación de VS Code para más detalles.

​

Ejemplo: Conectarse al servidor MCP de Mintlify

Conéctate al servidor MCP de Mintlify para buscar en este sitio de documentación desde tu herramienta de IA preferida. Esto te dará respuestas más precisas sobre cómo usar Mintlify en tu entorno local y demuestra cómo puedes ayudar a tus usuarios a conectarse a tu servidor MCP.

Contextual menu

En la parte superior de esta página, selecciona el menú contextual y elige Connect to Cursor o Connect to VS Code para conectar el servidor MCP de Mintlify con el IDE de tu preferencia.

Claude

Para usar el servidor MCP de Mintlify con Claude:

1. Add the Mintlify MCP server to Claude

   1. Ve a la página Connectors en la configuración de Claude.
   2. Selecciona Add custom connector.
   3. Agrega el servidor MCP de Mintlify:

   • Name: Mintlify
   • URL: https://mintlify.com/docs/mcp

   4. Selecciona Add.
2. Access the MCP server in your chat

   1. Cuando uses Claude, selecciona el botón de adjuntos (el icono de suma).
   2. Selecciona el servidor MCP de Mintlify.
   3. Hazle a Claude una pregunta sobre Mintlify.

Consulta la documentación de Model Context Protocol para más detalles.

Claude Code

Para usar el servidor MCP de Mintlify con Claude Code, ejecuta el siguiente comando:

claude mcp add --transport http Mintlify https://mintlify.com/docs/mcp

Prueba la conexión ejecutando:

claude mcp list

Consulta la documentación de Claude Code para más detalles.

CursorInstall in Cursor

Para conectar el servidor MCP de Mintlify a Cursor, haz clic en el botón Install in Cursor. O, para conectar el servidor MCP manualmente, sigue estos pasos:

1. Open MCP settings

   1. Usa Command + Shift + P (Ctrl + Shift + P en Windows) para abrir la paleta de comandos.
   2. Busca “Open MCP settings”.
   3. Selecciona Add custom MCP. Esto abrirá el archivo mcp.json.
2. Configure the Mintlify MCP server

   En mcp.json, agrega:

   {
     "mcpServers": {
       "Mintlify": {
         "url": "https://mintlify.com/docs/mcp"
       }
     }
   }
   
3. Test the connection

   En el chat de Cursor, pregunta “What tools do you have available?” Cursor debería mostrar el servidor MCP de Mintlify como una herramienta disponible.

Consulta Installing MCP servers en la documentación de Cursor para más detalles.

VS CodeInstall in VS Code

Para conectar el servidor MCP de Mintlify a VS Code, haz clic en el botón Install in VS Code. O, para conectar el servidor MCP manualmente, crea un archivo .vscode/mcp.json y agrega:

{
  "servers": {
    "Mintlify": {
      "type": "http",
      "url": "https://mintlify.com/docs/mcp"
    }
  }
}

Consulta la documentación de VS Code para más detalles.

​

Uso de múltiples servidores MCP

Los usuarios pueden conectar varios servidores MCP (Model Context Protocol) a sus herramientas de IA. Los servidores MCP conectados no consumen contexto hasta que la IA llama a una herramienta de búsqueda. La IA decide cuándo buscar según la relevancia de la búsqueda, por lo que no busca en cada servidor conectado para cada pregunta.

Cuando la IA realiza una búsqueda, cada búsqueda devuelve varios resultados que se agregan al contexto de la conversación. Si la IA busca en varios servidores para una sola pregunta, esto puede consumir una cantidad significativa de contexto.

Mejores prácticas para usar múltiples servidores MCP:

• Conecta solo los servidores MCP relevantes para tu trabajo actual.
• Sé específico en tus prompts para que la IA busque en el servidor más relevante.
• Desconecta los servidores que no estés usando activamente para reducir el posible consumo de contexto.