Saltar al contenido principal

​
Acerca de los servidores MCP

El MCP (Protocolo de Contexto de Modelo) 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 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 API.

​
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 puede utilizarse para otros elementos de navegación.

​
Configuring your MCP server

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 desencadenar actualizaciones. Los servidores MCP siguen un enfoque de “seguridad primero”, por lo que los endpoints de API no se exponen de forma predeterminada. Debes habilitar explícitamente los endpoints para ponerlos a disposición como herramientas MCP. Expón únicamente endpoints que sean seguros para el acceso público a través de 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 determinados endpoints de forma selectiva: 
{
  "openapi": "3.1.0",
  "x-mint": {
    "mcp": {
      "enabled": true
    }
  },
  // ...
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": false // Deshabilita 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": {
        // No hay `x-mint: mcp`, así que este endpoint no se expone como una herramienta de 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 de acceso público.
  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 y a los endpoints de tu API desde sus herramientas.
Estas son algunas formas en que puedes ayudar a tus usuarios a conectarse a tu servidor MCP:
  • Menú contextual
  • Claude
  • Claude Code
  • Cursor
  • VS Code
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 en el portapapeles del usuario.
Conectar con CursorcursorInstala tu servidor MCP en Cursor.
Conectar con VS CodevscodeInstala tu servidor MCP en VS Code.

​
Ejemplo: Conexión 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 mostrará cómo puedes ayudar a tus usuarios a conectarse a tu servidor MCP.
  • Menú contextual
  • Claude
  • Claude Code
  • Cursor
  • VS Code
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.

​
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 al usuario las credenciales de autenticación necesarias.

​
Monitorear 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 destacada

​
Solución de problemas

Si tu servidor MCP solo expone la herramienta de búsqueda a pesar de tener una especificación de OpenAPI:
  1. Verifica que tu especificación de OpenAPI sea válida y accesible.
  2. Asegúrate de haber habilitado explícitamente MCP para endpoints específicos usando x-mint.mcp.enabled: true.
  3. Revisa los registros de tu despliegue para detectar errores en el procesamiento de OpenAPI.
Si el procesamiento de OpenAPI falla, el servidor continúa únicamente con la herramienta de búsqueda para mantener la funcionalidad.
Si los usuarios reportan problemas de autenticación:
  1. Comprueba que tu especificación de OpenAPI incluya definiciones adecuadas de securitySchemes.
  2. Confirma que los endpoints habilitados funcionen con los métodos de autenticación especificados.
Si las herramientas de IA no están utilizando tus endpoints de API de manera efectiva:
  1. Agrega campos detallados summary y description a tus endpoints.
  2. Asegúrate de que los nombres y descripciones de los parámetros sean autoexplicativos.
  3. Usa el panel de MCP para verificar cómo se muestran tus endpoints como herramientas.