# Perfiles de MCP 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](/ai/mcp-catalog-and-toolkit/catalog/) (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: ```console $ 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](/ai/mcp-catalog-and-toolkit/toolkit/#oauth-authentication) 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](/ai/mcp-catalog-and-toolkit/toolkit/#oauth-authentication) 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: ```json { "mcpServers": { "MCP_DOCKER": { "command": "docker", "args": ["mcp", "gateway", "run", "--profile", "claude-work"] } } } ``` Mientras que tu configuración de VS Code utiliza un perfil diferente: ```json { "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 - [Primeros pasos con el kit de herramientas de MCP](/ai/mcp-catalog-and-toolkit/get-started/) - [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/) - [Kit de herramientas de MCP](/ai/mcp-catalog-and-toolkit/toolkit/)