# Kit de herramientas de Docker MCP





> [!NOTE]
> Esta página describe la interfaz del kit de herramientas de MCP en Docker Desktop 4.62 y versiones posteriores. Las versiones anteriores tienen una interfaz de usuario diferente. Actualiza para seguir estas instrucciones exactamente.

El kit de herramientas de Docker MCP es una interfaz de gestión integrada en Docker Desktop que te permite configurar, gestionar y ejecutar servidores MCP contenedorizados en perfiles y conectarlos a agentes de IA. Elimina la fricción en el uso de herramientas al ofrecer valores predeterminados seguros, una configuración sencilla y soporte para un ecosistema en crecimiento de clientes basados en LLM. Es la forma más rápida de pasar del descubrimiento de herramientas MCP a la ejecución local.

## Características principales

- Compatibilidad con múltiples LLM: funciona con Claude, Cursor y otros clientes MCP.
- Descubrimiento de herramientas integrado: explora e inicia servidores MCP directamente en Docker Desktop desde el catálogo de Docker MCP.
- Configuración manual cero: sin gestión de dependencias, configuración de tiempo de ejecución ni preparación requerida.
- Organización basada en perfiles: crea colecciones de servidores independientes para diferentes proyectos o entornos.
- Organiza los servidores MCP en perfiles, actuando como un gateway para que los clientes accedan a los servidores de cada perfil.

> [!TIP]
> El kit de herramientas de MCP incluye [MCP dinámico](/ai/mcp-catalog-and-toolkit/dynamic-mcp/), que permite a los agentes de IA descubrir, añadir y componer servidores MCP bajo demanda durante las conversaciones, sin configuración manual. Tu agente puede buscar en el catálogo y añadir herramientas según sea necesario cuando te conectes al gateway.

## Cómo funciona el kit de herramientas de MCP

MCP introduce dos conceptos principales: clientes MCP y servidores MCP.

- Los clientes MCP suelen estar integrados en aplicaciones basadas en LLM, como la aplicación Claude Desktop. Solicitan recursos o acciones.
- Los servidores MCP son iniciados por el cliente para realizar las tareas solicitadas, utilizando cualquier herramienta, lenguaje o proceso necesario.

Docker estandariza el desarrollo, empaquetado y distribución de aplicaciones, incluidos los servidores MCP. Al empaquetar los servidores MCP como contenedores, Docker elimina los problemas relacionados con el aislamiento y las diferencias de entorno. Puedes ejecutar un contenedor directamente, sin gestionar dependencias ni configurar entornos de ejecución.

Dependiendo del servidor MCP, las herramientas que proporciona pueden ejecutarse dentro del mismo contenedor que el servidor o en contenedores dedicados para un mejor aislamiento.

El kit de herramientas de MCP organiza los servidores en perfiles: colecciones con nombre de servidores con sus configuraciones. Esto te permite mantener diferentes configuraciones de servidores para distintos proyectos o entornos. Cuando conectas un cliente, especificas qué perfil debe utilizar.

## Seguridad

El kit de herramientas de Docker MCP combina medidas pasivas y activas para reducir las superficies de ataque y garantizar un comportamiento seguro en el tiempo de ejecución.

### Seguridad pasiva

La seguridad pasiva se refiere a las medidas implementadas en el momento de la compilación, cuando el código del servidor MCP se empaqueta en una imagen de Docker.

- Firma y atestación de imágenes: todas las imágenes de servidor MCP bajo `mcp/` en el [catálogo de MCP](/ai/mcp-catalog-and-toolkit/toolkit/catalog/) son compiladas por Docker y firmadas digitalmente para verificar su origen e integridad. Cada imagen incluye una lista de materiales de software (SBOM) para una total transparencia.

### Seguridad activa

La seguridad activa se refiere a las medidas de seguridad en el tiempo de ejecución, antes y después de invocar las herramientas, aplicadas mediante limitaciones de recursos y accesos.

- Asignación de CPU: las herramientas de MCP se ejecutan en su propio contenedor. Están restringidas a 1 CPU, lo que limita el impacto de un posible uso indebido de los recursos informáticos.

- Asignación de memoria: los contenedores para las herramientas de MCP están limitados a 2 GB.

- Acceso al sistema de archivos: por defecto, los servidores MCP no tienen acceso al sistema de archivos del host. El usuario selecciona explícitamente los servidores a los que se les concederán montajes de archivos.

- Intercepción de solicitudes de herramientas: se bloquean las solicitudes hacia y desde las herramientas que contienen información sensible como secretos.

### Autenticación OAuth

Algunos servidores MCP requieren autenticación para acceder a servicios externos como GitHub, Notion y Linear. El kit de herramientas de MCP gestiona la autenticación OAuth automáticamente. Autorizas el acceso a través de tu navegador y el kit de herramientas gestiona las credenciales de forma segura. No necesitas crear tokens de API manualmente ni configurar la autenticación para cada servicio.

#### Autorizar un servidor con OAuth

1. En Docker Desktop, ve a **MCP Toolkit** y selecciona la pestaña **Catalog**.
2. Busca y añade un servidor MCP que requiera OAuth.
3. En la pestaña **Configuration** del servidor, selecciona el método de autenticación **OAuth**. Sigue el enlace para iniciar la autorización OAuth.
4. Tu navegador abrirá la página de autorización del servicio. Sigue las instrucciones en pantalla para completar la autenticación.
5. Regresa a Docker Desktop cuando la autenticación se haya completado.

Visualiza todos los servicios autorizados en la pestaña **OAuth**. Para revocar el acceso, selecciona **Revoke** junto al servicio que deseas desconectar.

## Ejemplos de uso

### Ejemplo: Usar Claude Desktop como cliente

Imagina que tienes instalado Claude Desktop y deseas utilizar el servidor MCP de GitHub y el servidor MCP de Puppeteer. No tienes que instalar los servidores en Claude Desktop. Puedes añadir estos 2 servidores MCP a tu perfil en el kit de herramientas de MCP y conectar Claude Desktop como cliente:

1. En el menú de **MCP Toolkit**, selecciona la pestaña **Catalog**, busca el servidor **Puppeteer** y añádelo a tu perfil.
2. Repite el proceso para el servidor **GitHub Official**.
3. En la pestaña **Clients**, selecciona **Connect** junto a **Claude Desktop**. Reinicia Claude Desktop si se está ejecutando, y ahora podrá acceder a todos los servidores en el kit de herramientas de MCP.
4. Dentro de Claude Desktop, realiza una prueba enviando el siguiente prompt utilizando el modelo Sonnet 3.5:

   ```text
   Toma una captura de pantalla de docs-docker.esdocu.com y luego invierte los colores
   ```

### Ejemplo: Usar Visual Studio Code como cliente

Puedes interactuar con todos tus servidores MCP instalados en Visual Studio Code:

1. Para habilitar el kit de herramientas de MCP:

   **Habilitar globalmente**


   1. Introduce lo siguiente en el archivo de usuario `mcp.json` de tu Visual Studio Code:

      ```json
      "mcp": {
       "servers": {
         "MCP_DOCKER": {
           "command": "docker",
           "args": [
             "mcp",
             "gateway",
             "run",
             "--profile",
             "my_profile"
           ],
           "type": "stdio"
         }
       }
      }
      ```

   **Habilitar para un proyecto específico**


   1. En tu terminal, navega a la carpeta de tu proyecto.
   2. Ejecuta:

      ```bash
      docker mcp client connect vscode --profile my_profile
      ```

      > [!NOTE]
      > Este comando crea un archivo `.vscode/mcp.json` en el directorio actual
      > que conecta VSCode a tu perfil. Al ser un archivo específico del usuario,
      > añádelo a tu archivo `.gitignore` para evitar subirlo al repositorio.
      >
      > ```console
      > echo ".vscode/mcp.json" >> .gitignore
      > ```

   

2. En Visual Studio Code, abre un nuevo chat y selecciona el modo **Agent**:

   ![Cambio de modo de Copilot](/ai/mcp-catalog-and-toolkit/images/copilot-mode.png)

3. También puedes comprobar las herramientas MCP disponibles:

   ![Mostrar herramientas en VSCode](/ai/mcp-catalog-and-toolkit/images/tools.png)

Para obtener más información sobre el modo Agent, consulta la [documentación de Visual Studio Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_use-mcp-tools-in-agent-mode).

## Lecturas adicionales

- [Usar el kit de herramientas de MCP desde la CLI](/ai/mcp-catalog-and-toolkit/cli/)
- [Catálogo de MCP](/ai/mcp-catalog-and-toolkit/catalog/)
- [Gateway de MCP](/ai/mcp-catalog-and-toolkit/mcp-gateway/)

