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.

​

Cómo funcionan los servidores MCP

Cuando un servidor MCP está conectado a una herramienta de IA, el LLM puede decidir usar tu herramienta de búsqueda en la documentación durante la generación de la respuesta.

• 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, lo que permite que el LLM incorpore información en tiempo real de tu documentación en su respuesta.

Por ejemplo, si un usuario hace una pregunta de programación y el LLM determina que tu documentación es relevante, puede buscar en tu documentación e incluir esa información en la respuesta sin que el usuario tenga que pedir explícitamente que se consulte tu documentación.

​

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.

​

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

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.

​

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.