> ## Documentation Index
> Fetch the complete documentation index at: https://omer-914cc1c6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Context Protocol

> Permite que los usuarios accedan a tu documentación y a tus APIs desde sus herramientas de IA favoritas

export const PreviewButton = ({children, href}) => {
  return <a href={href} className="text-sm font-medium text-white dark:!text-zinc-950 bg-zinc-900 hover:bg-zinc-700 dark:bg-zinc-100 hover:dark:bg-zinc-300 rounded-full px-3.5 py-1.5 not-prose">
        {children}
      </a>;
};

<div id="about-mcp-servers">
  ## Acerca de los servidores MCP
</div>

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.

<div id="accessing-your-mcp-server">
  ## Acceder a tu servidor MCP
</div>

<Note>
  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.
</Note>

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](https://dashboard.mintlify.com/products/mcp).

La ruta `/mcp` está reservada para servidores MCP alojados y no se puede usar para otros elementos de navigation.

<div id="configuring-your-mcp-server">
  ## Configuración de tu servidor MCP
</div>

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](https://mintlify.com/pricing?ref=mcp), 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` 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 por defecto. Debes habilitar explícitamente los endpoints para ponerlos a disposición como herramientas MCP. Solo expón endpoints que sean seguros para el acceso público a través de herramientas de IA.

<ResponseField name="mcp" type="object">
  La configuración de MCP para el endpoint.

  <Expandable title="MCP">
    <ResponseField name="enabled" type="boolean">
      Indica si se debe exponer el endpoint como una herramienta MCP. Tiene prioridad sobre la configuración a nivel de archivo.
    </ResponseField>

    <ResponseField name="name" type="string">
      El nombre de la herramienta MCP.
    </ResponseField>

    <ResponseField name="description" type="string">
      La descripción de la herramienta MCP.
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="file-level-configuration">
  ### Configuración a nivel de archivo
</div>

Habilita MCP para todos los endpoints de forma predeterminada en un archivo de especificación de OpenAPI y excluye endpoints de manera selectiva:

```json theme={null}
{
  "openapi": "3.1.0",
  "x-mint": {
    "mcp": {
      "enabled": true
    }
  },
  // ...
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": false // Desactiva MCP para este endpoint
          }
        },
        // ...
      }
    }
  }
}
```

<div id="endpoint-level-configuration">
  ### Configuración a nivel de endpoint
</div>

Activa Model Context Protocol (MCP) para endpoints específicos:

```json theme={null}
{
  "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
        // ...
      }
    }
  }
}
```

<div id="using-your-mcp-server">
  ## Uso de tu servidor MCP
</div>

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:

<Tabs>
  <Tab title="Menú contextual">
    Agrega opciones en el [menú contextual](/es/ai/contextual-menu) 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.                             |
  </Tab>

  <Tab title="Claude">
    <Steps>
      <Step title="Obtén la URL de tu servidor MCP.">
        Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y encuentra la URL de tu servidor MCP.
      </Step>

      <Step title="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](https://claude.ai/settings/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.
      </Step>
    </Steps>

    Consulta la [documentación de Model Context Protocol](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server#connecting-to-a-remote-mcp-server) para más detalles.
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Obtén la URL de tu servidor MCP.">
        Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y encuentra la URL de tu servidor MCP.
      </Step>

      <Step title="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.

        ```bash theme={null}
        claude mcp add --transport http <name> <url>
        ```
      </Step>
    </Steps>

    Consulta la [documentación de Claude Code](https://docs.anthropic.com/en/docs/claude-code/mcp#installing-mcp-servers) para más detalles.
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Obtén la URL de tu servidor MCP.">
        Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y encuentra la URL de tu servidor MCP.
      </Step>

      <Step title="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 <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> 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:

        ```json theme={null}
        {
          "mcpServers": {
            "<your-mcp-server-name>": {
              "url": "<your-mcp-server-url>"
            }
          }
        }
        ```
      </Step>
    </Steps>

    Consulta la [documentación de Cursor](https://docs.cursor.com/en/context/mcp#installing-mcp-servers) para más detalles.
  </Tab>

  <Tab title="VS Code">
    <Steps>
      <Step title="Obtén la URL de tu servidor MCP.">
        Ve a tu [dashboard](https://dashboard.mintlify.com/products/mcp) y encuentra la URL de tu servidor MCP.
      </Step>

      <Step title="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:

        ```json theme={null}
        {
          "servers": {
            "<your-mcp-server-name>": {
              "type": "http",
              "url": "<your-mcp-server-url>"
            }
          }
        }
        ```
      </Step>
    </Steps>

    Consulta la [documentación de VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) para más detalles.
  </Tab>
</Tabs>

<div id="example-connecting-to-the-mintlify-mcp-server">
  ### Ejemplo: Conectarse al servidor MCP de Mintlify
</div>

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.

<Tabs>
  <Tab title="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.
  </Tab>

  <Tab title="Claude">
    Para usar el servidor MCP de Mintlify con Claude:

    <Steps>
      <Step title="Add the Mintlify MCP server to Claude">
        1. Ve a la página [Connectors](https://claude.ai/settings/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**.
      </Step>

      <Step title="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.
      </Step>
    </Steps>

    Consulta la [documentación de Model Context Protocol](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server#connecting-to-a-remote-mcp-server) para más detalles.
  </Tab>

  <Tab title="Claude Code">
    Para usar el servidor MCP de Mintlify con Claude Code, ejecuta el siguiente comando:

    ```bash theme={null}
    claude mcp add --transport http Mintlify https://mintlify.com/docs/mcp
    ```

    Prueba la conexión ejecutando:

    ```bash theme={null}
    claude mcp list
    ```

    Consulta la [documentación de Claude Code](https://docs.anthropic.com/en/docs/claude-code/mcp#installing-mcp-servers) para más detalles.
  </Tab>

  <Tab title="Cursor">
    <PreviewButton href="cursor://anysphere.cursor-deeplink/mcp/install?name=mintlify&config=eyJ1cmwiOiJodHRwczovL21pbnRsaWZ5LmNvbS9kb2NzL21jcCJ9">Install in Cursor</PreviewButton>

    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:

    <Steps>
      <Step title="Open MCP settings">
        1. Usa <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> en Windows) para abrir la paleta de comandos.
        2. Busca "Open MCP settings".
        3. Selecciona **Add custom MCP**. Esto abrirá el archivo `mcp.json`.
      </Step>

      <Step title="Configure the Mintlify MCP server">
        En `mcp.json`, agrega:

        ```json theme={null}
        {
          "mcpServers": {
            "Mintlify": {
              "url": "https://mintlify.com/docs/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="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.
      </Step>
    </Steps>

    Consulta [Installing MCP servers](https://docs.cursor.com/en/context/mcp#installing-mcp-servers) en la documentación de Cursor para más detalles.
  </Tab>

  <Tab title="VS Code">
    <PreviewButton href="https://vscode.dev/redirect/mcp/install?name=mintlify&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmintlify.com%2Fdocs%2Fmcp%22%7D">Install in VS Code</PreviewButton>

    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:

    ```json theme={null}
    {
      "servers": {
        "Mintlify": {
          "type": "http",
          "url": "https://mintlify.com/docs/mcp"
        }
      }
    }
    ```

    Consulta la [documentación de VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) para más detalles.
  </Tab>
</Tabs>

<div id="authentication">
  ## Autenticación
</div>

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.

<div id="monitoring-your-mcp-server">
  ## Supervisar tu servidor MCP
</div>

Puedes ver todas las herramientas MCP disponibles en la sección **Available tools** de la [página del MCP Server](https://dashboard.mintlify.com/products/mcp) en tu dashboard.

<Frame>
  <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/mcp/mcp-server-page-light.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=8e8149e1692e4a212f49ff96bfdb7d95" alt="Dashboard de MCP con la sección Available tools resaltada" class="block dark:hidden" width="3024" height="1548" data-path="images/mcp/mcp-server-page-light.png" />

  <img src="https://mintcdn.com/omer-914cc1c6/1pfjDJXEL6HIHDKE/images/mcp/mcp-server-page-dark.png?fit=max&auto=format&n=1pfjDJXEL6HIHDKE&q=85&s=ddb49e7c8de96f257d1e6df1518e0299" alt="Dashboard de MCP con la sección Available tools resaltada" class="hidden dark:block" width="3018" height="1540" data-path="images/mcp/mcp-server-page-dark.png" />
</Frame>

<div id="troubleshooting">
  ## Solución de problemas
</div>

<AccordionGroup>
  <Accordion title="El servidor MCP solo muestra la herramienta de búsqueda">
    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.
  </Accordion>

  <Accordion title="Problemas de autenticación">
    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.
  </Accordion>

  <Accordion title="Descripciones de herramientas ausentes o poco claras">
    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.
  </Accordion>
</AccordionGroup>