Saltar al contenido principal

​
Acerca de los servidores MCP

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. Tu servidor MCP expone herramientas para que las aplicaciones de IA puedan buscar en tu documentación e interactuar con tus APIs.

​
Acceder a tu servidor MCP

Los servidores MCP solo pueden generarse para documentación pública. No se puede acceder a la documentación detrás de la autenticación del 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 dashboard. La ruta /mcp está reservada para servidores MCP alojados y no se puede usar para otros elementos de navigation.

​
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 cuentas con un plan Pro o Enterprise, puedes exponer endpoints de tu especificación OpenAPI como herramientas MCP. Para exponer endpoints como herramientas MCP, utiliza 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 assistant, obtener actualizaciones de estado y activar actualizaciones. Los servidores MCP siguen un enfoque de seguridad primero en el que los endpoints de la 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 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 de 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

Activa Model Context Protocol (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 `x-mint: mcp` así que este endpoint no se expone como 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. 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: 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 demuestra cómo puedes ayudar a tus usuarios a conectarse a tu servidor MCP.
  • Contextual menu
  • 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 los campos securitySchemes y securityRequirement de tu especificación OpenAPI. Cualquier key es gestionada directamente por 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.

​
Monitorizar tu servidor MCP

Puedes ver todas las herramientas MCP disponibles en la sección Available tools de la página del MCP Server en tu dashboard.
Dashboard 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 OpenAPI:
  1. Verifica que tu especificación 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 implementación 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 informan problemas de autenticación:
  1. Verifica que tu especificación OpenAPI incluya definiciones correctas 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 usando tus endpoints de API de manera efectiva:
  1. Agrega campos summary y description detallados a tus endpoints.
  2. Asegúrate de que los nombres y descripciones de los parámetros sean claros por sí mismos.
  3. Usa el dashboard de MCP para verificar cómo aparecen tus endpoints como herramientas.
⌘I