Compartir comentarios
Las respuestas se generan en base a la documentación.

Perfiles de MCP

Tabla de contenidos
Disponibilidad: Acceso anticipado
Requiere: Docker Desktop 4.63 y posterior

Los perfiles organizan tus servidores MCP en colecciones con nombre. Sin perfiles, tendrías que configurar los servidores por separado para cada aplicación de IA que utilices. Cada vez que quisieras cambiar qué servidores están disponibles, tendrías que actualizar Claude Desktop, VS Code, Cursor y otras herramientas de forma individual. Los perfiles resuelven esto al centralizar las configuraciones de tus servidores.

Qué hacen los perfiles

Un perfil es una colección con nombre de servidores MCP con sus configuraciones y ajustes. Seleccionas servidores del catálogo de MCP (la fuente de servidores disponibles) y los añades a tus perfiles (tus colecciones de servidores configurados para trabajos específicos). Piensa en el catálogo como una biblioteca de herramientas y en los perfiles como tus cajas de herramientas organizadas para diferentes tareas.

Tu perfil "web-dev" podría incluir GitHub, Playwright y servidores de bases de datos. Tu perfil "data-analysis" podría incluir servidores de hojas de cálculo, API y visualización. Conecta diferentes clientes de IA a perfiles distintos, o cambia entre perfiles a medida que cambies de tarea.

Cuando ejecutas el Gateway de MCP o conectas un cliente sin especificar un perfil, Docker MCP utiliza tu perfil predeterminado. Si estás actualizando desde una versión anterior del kit de herramientas de MCP, tus configuraciones de servidores existentes ya estarán en el perfil predeterminado.

Capacidades de los perfiles

Cada perfil mantiene su propia colección aislada de servidores y configuraciones. Tu perfil "web-dev" puede incluir servidores de GitHub, Playwright y bases de datos, mientras que tu perfil "data-analysis" incluye servidores de hojas de cálculo, API y visualización. Crea tantos perfiles como necesites, cada uno conteniendo únicamente los servidores relevantes para ese contexto.

Puedes conectar diferentes aplicaciones de IA a perfiles distintos. Cuando conectas un cliente, especificas qué perfil debe utilizar. Esto significa que Claude Desktop y VS Code pueden tener acceso a colecciones de servidores diferentes si es necesario.

Los perfiles se pueden compartir con tu equipo. Sube un perfil a tu registro y los miembros del equipo podrán descargarlo para obtener exactamente la misma colección de servidores y configuración que utilizas tú.

Crear y gestionar perfiles

Crear un perfil

  1. En Docker Desktop, selecciona MCP Toolkit y ve a la pestaña Profiles.
  2. Selecciona Create profile.
  3. Introduce un nombre para tu perfil (por ejemplo, "web-dev").
  4. Opcionalmente, busca y añade servidores a tu perfil ahora, o añádelos más tarde.
  5. Opcionalmente, busca y añade clientes para conectarlos a tu perfil.
  6. Selecciona Create.

Tu nuevo perfil aparecerá en la lista de perfiles.

Ver detalles del perfil

Selecciona un perfil en la pestaña Profiles para ver sus detalles. La vista de perfil tiene dos pestañas:

  • Overview: muestra los servidores en tu perfil, la configuración de secretos y los clientes conectados. Usa los botones + para añadir más servidores o clientes.
  • Tools: enumera todas las herramientas disponibles de los servidores de tu perfil. Puedes habilitar o deshabilitar herramientas individuales.

Eliminar un perfil

  1. En la pestaña Profiles, busca el perfil que deseas eliminar.
  2. Selecciona el icono de tres puntos (⋮) junto al nombre del perfil y luego Delete.
  3. Confirma la eliminación.
Caution

Al eliminar un perfil se borran todas las configuraciones y ajustes de sus servidores, y se actualiza la configuración del cliente (se elimina MCP Toolkit). Esta acción no se puede deshacer.

Perfil predeterminado

Cuando ejecutas el Gateway de MCP o utilizas el kit de herramientas de MCP sin especificar un perfil, Docker MCP utiliza un perfil llamado default, o una configuración vacía si el perfil default no existe.

Si estás actualizando desde una versión anterior del kit de herramientas de MCP, las configuraciones de tus servidores existentes se migrarán automáticamente al perfil default. No es necesario que recrees tu configuración manualmente: todo seguirá funcionando como antes.

Siempre puedes especificar un perfil diferente utilizando la bandera --profile con el comando del gateway:

$ docker mcp gateway run --profile web-dev

Añadir servidores a los perfiles

Los perfiles contienen los servidores MCP que seleccionas del catálogo. Añade servidores para organizar tus herramientas para flujos de trabajo específicos.

Añadir un servidor

Puedes añadir servidores a un perfil de dos maneras.

Desde la pestaña Catalog:

  1. Selecciona la pestaña Catalog.
  2. Selecciona la casilla de verificación junto a los servidores que deseas añadir para ver a qué perfil añadirlos.
  3. Elige tu perfil en el menú desplegable.

Desde dentro de un perfil:

  1. Selecciona la pestaña Profiles y elige tu perfil.
  2. En la sección Servers, selecciona el botón +.
  3. Busca y selecciona los servidores que deseas añadir.

Si un servidor requiere OAuth autenticación, se te solicitará que lo autorices. Consulta Autenticación OAuth para obtener más detalles.

Listar servidores en un perfil

Selecciona un perfil en la pestaña Profiles para ver todos los servidores que contiene.

Eliminar un servidor

  1. Selecciona la pestaña Profiles y elige tu perfil.
  2. En la sección Servers, busca el servidor que deseas eliminar.
  3. Selecciona el icono de eliminar junto al servidor.

Configurar perfiles

Configuración del servidor

Algunos servidores requieren una configuración que va más allá de la autenticación. Configura los ajustes del servidor dentro de tu perfil.

  1. Selecciona la pestaña Profiles y elige tu perfil.
  2. En la sección Servers, selecciona el icono de configuración junto al servidor.
  3. Ajusta los valores de configuración del servidor según sea necesario.

Credenciales de OAuth

Las credenciales de OAuth se comparten en todos los perfiles. Cuando autorizas el acceso a un servicio como GitHub o Notion, esa autorización está disponible para cualquier servidor en cualquier perfil que la necesite.

Esto significa que todos los perfiles utilizan las mismas credenciales de OAuth para un servicio determinado. Si necesitas usar cuentas diferentes para distintos proyectos, tendrás que revocar y volver a autorizar el acceso entre los cambios de perfil.

Consulta Autenticación OAuth para obtener detalles sobre cómo autorizar servidores.

Persistencia de la configuración

Las configuraciones de los perfiles persisten en tu instalación de Docker. Cuando reinicias Docker Desktop o tu sistema, tus perfiles, servidores y configuraciones permanecen intactos.

Compartir perfiles

Los perfiles se pueden compartir con tu equipo subiéndolos a registros compatibles con OCI como artefactos. Esto es útil para distribuir configuraciones estandarizadas de MCP en toda tu organización. Las credenciales no se incluyen en los perfiles compartidos por motivos de seguridad. Los miembros del equipo configuran OAuth por separado después de realizar la descarga (pull).

Subir un perfil

  1. Selecciona el perfil que deseas compartir en la pestaña Profiles.
  2. Selecciona Push to Registry.
  3. Introduce el destino del registro (por ejemplo, registro.ejemplo.com/perfiles/web-dev:v1).
  4. Completa la autenticación si es necesario.

Descargar un perfil

  1. Selecciona Pull from Registry en la pestaña Profiles.
  2. Introduce la referencia del registro (por ejemplo, registro.ejemplo.com/perfiles/team-standard:latest).
  3. Completa la autenticación si es necesario.

El perfil se descargará y se añadirá a tu lista de perfiles. Configura cualquier credencial de OAuth requerida por separado.

Flujo de trabajo de colaboración en equipo

Un flujo de trabajo típico para compartir perfiles en un equipo:

  1. Crea y configura un perfil con los servidores que tu equipo necesita.
  2. Prueba el perfil para asegurarte de que funciona como se espera.
  3. Sube el perfil al registro de tu equipo con una etiqueta de versión (por ejemplo, registro.ejemplo.com/perfiles/team-dev:v1).
  4. Comparte la referencia del registro con tu equipo.
  5. Los miembros del equipo descargan el perfil y configuran las credenciales de OAuth necesarias.

Esto asegura que todos utilicen la misma colección de servidores y configuración, reduciendo el tiempo de configuración y las inconsistencias.

Usar perfiles con clientes

Cuando conectas un cliente de IA al Gateway de MCP, especificas a qué servidores de perfil puede acceder el cliente.

Ejecutar el gateway con un perfil

Conecta clientes a tu perfil a través de la sección Clients en el MCP Toolkit. Puedes añadir clientes al crear un perfil o añadirlos a perfiles existentes más tarde.

Configurar clientes para perfiles específicos

Al configurar un cliente manualmente, puedes especificar qué perfil utiliza el cliente. Esto permite que diferentes clientes se conecten a perfiles distintos.

Por ejemplo, tu configuración de Claude Desktop podría usar:

{
  "mcpServers": {
    "MCP_DOCKER": {
      "command": "docker",
      "args": ["mcp", "gateway", "run", "--profile", "claude-work"]
    }
  }
}

Mientras que tu configuración de VS Code utiliza un perfil diferente:

{
  "mcp": {
    "servers": {
      "MCP_DOCKER": {
        "command": "docker",
        "args": ["mcp", "gateway", "run", "--profile", "vscode-dev"],
        "type": "stdio"
      }
    }
  }
}

Cambiar entre perfiles

Para cambiar el perfil que utilizan tus clientes, actualiza la configuración del cliente para especificar un valor de --profile diferente en los argumentos del comando del gateway.

Lecturas adicionales