​
Acerca de los servidores MCP

El Model Context Protocol (MCP) es un protocolo abierto que estandariza las conexiones 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 tus APIs. Tu servidor MCP expone herramientas para que las aplicaciones de IA busquen en tu documentación e interactúen con tus APIs.

​
Acceder a tu servidor MCP

Los servidores MCP solo pueden generarse para documentación pública. No es posible acceder a documentación protegida por autenticación de usuario final para generar el servidor.
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 tu panel. La ruta /mcp está reservada para servidores MCP alojados y no se puede usar para otros elementos de navegación.

​
Configuración de tu servidor MCP

Todos los servidores MCP incluyen la herramienta search de forma predeterminada, lo que permite a los usuarios consultar información de tu documentación desde otras herramientas. Si tienes un plan Pro o Enterprise, puedes exponer endpoints de tu especificación OpenAPI como herramientas MCP. Para exponer endpoints como herramientas MCP, usa el objeto mcp dentro de la extensión x-mint, ya sea a nivel de archivo o de endpoint. Por ejemplo, el servidor MCP de Mintlify incluye herramientas para crear chats del Asistente, obtener actualizaciones de estado y activar actualizaciones. Los servidores MCP siguen un enfoque de seguridad ante todo, en el que los endpoints de API no se exponen de forma predeterminada. Debes habilitar explícitamente los endpoints para que estén disponibles como herramientas MCP. Expón únicamente endpoints que sean seguros para el acceso público mediante herramientas de IA.
​
mcp
object
La configuración de MCP para el endpoint.

​
Configuración a nivel de archivo

Habilita MCP para todos los endpoints de forma predeterminada en un archivo de especificación OpenAPI y excluye endpoints de manera selectiva: 
{
  "openapi": "3.1.0",
  "x-mint": {
    "mcp": {
      "enabled": true
    }
  },
  // ...
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": false // Desactiva MCP para este endpoint
          }
        },
        // ...
      }
    }
  }
}

​
Configuración a nivel de endpoint

Habilita MCP para endpoints específicos: 
{
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": true,
            "name": "get-users",
            "description": "Obtener una lista de usuarios"
          },
          // ...
        }
      }
    },
    "/api/v1/delete": {
      "delete": {
        // Sin `x-mint: mcp`, este endpoint no se expone como una herramienta MCP
        // ...
      }
    }
  }
}

​
Uso de 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. Pide a los usuarios que copien la URL de tu servidor MCP y la agreguen a sus herramientas.
  3. Los usuarios accederán a tu documentación y a los endpoints de tu API desde sus herramientas.
Estas son algunas maneras en las que puedes ayudar a tus usuarios a conectarse a tu servidor MCP:
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ónIdentificadorDescripción
Copiar URL del servidor MCPmcpCopia la URL de tu servidor MCP al portapapeles del usuario.
Conectar con CursorcursorInstala tu servidor MCP en Cursor.
Conectar con VS CodevscodeInstala tu servidor MCP en VS Code.

​
Ejemplo: Conectarse al servidor MCP de Mintlify

Conéctate al servidor MCP de Mintlify para interactuar con la API de Mintlify y buscar en nuestra documentación. Esto te dará respuestas más precisas sobre cómo usar Mintlify en tu entorno local y muestra cómo puedes ayudar a tus usuarios a conectarse a tu servidor MCP.
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 al IDE de tu preferencia.

​
Autenticación

Cuando habilitas un endpoint de API para MCP, el servidor incluye los requisitos de autenticación definidos en tus securitySchemes y securityRequirement de OpenAPI. Cualquier clave la gestiona directamente la herramienta y no es almacenada ni procesada por Mintlify. Si un usuario le pide a su herramienta de IA que invoque un endpoint protegido, la herramienta solicitará en ese momento las credenciales de autenticación necesarias al usuario.

​
Monitorizar tu servidor MCP

Puedes ver todas las herramientas de MCP disponibles en la sección Available tools de la página MCP Server en tu panel.
Panel de MCP con la sección Available tools resaltada

​
Solución de problemas