Cómo conectar Docker Hub a Claude 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 + Claude

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 Claude

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.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Docker Hub, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

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

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

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