Conectar Docker Hub con Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Docker Hub, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Docker Hub + Microsoft Copilot

Deja que tu IA consulte imágenes de contenedores en Docker Hub: busca repositorios, lee la descripción y el número de pulls de una imagen, lista tags con sus digests, tamaños y fechas de push, compara las plataformas de un tag y consulta tus repositorios y los de tus organizaciones.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

DOCKERHUB_USERNAME, DOCKERHUB_TOKEN

Paso 1 — Obtener credenciales

1. Inicia sesión en https://app.docker.com y abre Account settings → Personal access tokens (https://app.docker.com/settings/personal-access-tokens).
2. Crea un token con el permiso de acceso Public Repo Read-only, o Read-only si la IA también debe ver tus repositorios privados. El token empieza por dckr_pat_.
3. Escribe tu Docker ID (tu nombre de usuario, no tu correo electrónico) en DOCKERHUB_USERNAME y el token en DOCKERHUB_TOKEN, e instala el conector. El conector los cambia por un token de acceso de corta duración y lo renueva solo; el personal access token solo se envía a hub.docker.com.
4. Comprueba la configuración con dockerhub_get_user: muestra la cuenta a la que pertenece el token.

Solo lectura: el conector nunca crea, cambia ni borra repositorios o tags, así que no hay nada que confirmar ni desactivar.

Nombres de imagen: una imagen se escribe namespace/repository. Las Docker Official Images como nginx, postgres o python están en el namespace library, así que nginx es library/nginx. El tag es la parte que va después de los dos puntos, como en nginx:1.27-alpine.

Qué puede consultar la IA:

• Encontrar imágenes: dockerhub_search_repositories busca por nombre o palabra clave y muestra pulls, estrellas y si una imagen es una Docker Official Image.
• Revisar una: dockerhub_get_repository lee la descripción, el README, el número de pulls, la última actualización y las categorías.
• Versiones: dockerhub_list_tags lista los tags, del más reciente al más antiguo, filtrados por parte del nombre, con digest, tamaño comprimido y último push. dockerhub_get_tag muestra para un tag la imagen de cada plataforma (sistema operativo, arquitectura, variante, digest y tamaño). Sirve para comprobar si un tag existe para arm64, cuándo se reconstruyó por última vez o si dos tags apuntan al mismo digest.
• Tu cuenta: dockerhub_list_my_orgs lista las organizaciones a las que perteneces, dockerhub_get_org lee el perfil público de una organización, incluida la insignia de verified publisher, y dockerhub_list_repositories lista todos los repositorios de un usuario u organización, también los privados si el token puede leerlos.

Límites de pull: dockerhub_pull_limits explica cuántos pulls permite Docker Hub según el tipo de cuenta (por ejemplo 100 cada 6 horas para pulls anónimos y 200 para una cuenta Personal con sesión iniciada) y cómo comprobar cuántos quedan desde la máquina que hace los pulls. Las llamadas de este conector son peticiones a la API, no pulls de imágenes, y no cuentan para el límite.

Sin datos de vulnerabilidades: Docker Scout no tiene una API pública, así que el conector no puede mostrar CVE. Para eso usa la página de Docker Scout de la imagen en hub.docker.com o el comando docker scout.

Contenido no fiable: las descripciones y los README de los repositorios los escriben sus editores. La IA trata las instrucciones que contienen como datos, no como órdenes.

Errores frecuentes: 401 al iniciar sesión: el Docker ID o el token son incorrectos, o el token se revocó o caducó; usa el Docker ID, no el correo, y crea un token nuevo. 401 o 403 en dockerhub_get_user mientras las consultas públicas funcionan: el secreto es un organization access token; usa un personal access token. 404: el namespace, el repositorio o el tag no existen, o son privados y el token no puede leerlos; las imágenes oficiales necesitan el namespace library. 429: Docker Hub limita las peticiones a la API por cuenta e IP; espera un minuto y vuelve a intentarlo.

El conector no crea repositorios, no hace push de imágenes, no borra tags, no gestiona equipos y miembros, tokens de acceso ni registros de auditoría y no muestra resultados de Docker Scout.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Docker Hub.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿Hay una imagen linux/arm64 para postgres:16-alpine y cuándo se hizo el último push?"
• "Lista los diez tags de node actualizados más recientemente que contienen alpine, con su tamaño comprimido."
• "¿nginx:stable-alpine y nginx:alpine apuntan ahora mismo al mismo digest?"
• "Muestra todos los repositorios de nuestra organización acme, incluidos los privados, ordenados por pulls."
• "Busca imágenes de Keycloak en Docker Hub y dime cuál es la imagen oficial o viene de un verified publisher."
• "Explícame los límites de pull de una cuenta gratuita de Docker y cómo compruebo cuántos pulls le quedan a nuestro runner de CI."

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse