Come collegare Docker Hub a Meta Muse via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Docker Hub, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Docker Hub + Meta Muse

Fai cercare alla tua AI le immagini container su Docker Hub: cerca repository, leggi la descrizione e il numero di pull di un'immagine, elenca i tag con digest, dimensioni e date di push, confronta le piattaforme di un tag e consulta i repository tuoi e delle tue organizzazioni.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

DOCKERHUB_USERNAME, DOCKERHUB_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi a https://app.docker.com e apri Account settings → Personal access tokens (https://app.docker.com/settings/personal-access-tokens).
2. Crea un token con il permesso di accesso Public Repo Read-only, oppure Read-only se l'AI deve vedere anche i tuoi repository privati. Il token inizia con dckr_pat_.
3. Inserisci il tuo Docker ID (il nome utente, non l'indirizzo e-mail) in DOCKERHUB_USERNAME e il token in DOCKERHUB_TOKEN, poi installa il connettore. Il connettore li scambia con un token di accesso di breve durata e lo rinnova da solo; il personal access token viene inviato solo a hub.docker.com.
4. Verifica la configurazione con dockerhub_get_user: mostra l'account a cui appartiene il token.

Sola lettura: il connettore non crea, modifica né elimina mai repository o tag, quindi non c'è nulla da confermare o disattivare.

Nomi delle immagini: un'immagine si scrive namespace/repository. Le Docker Official Images come nginx, postgres o python stanno nel namespace library, quindi nginx è library/nginx. Il tag è la parte dopo i due punti, come in nginx:1.27-alpine.

Cosa può consultare l'AI:

• Trovare immagini: dockerhub_search_repositories cerca per nome o parola chiave e mostra numero di pull e di stelle e se un'immagine è una Docker Official Image.
• Esaminarne una: dockerhub_get_repository legge descrizione, README, numero di pull, ultimo aggiornamento e categorie.
• Versioni: dockerhub_list_tags elenca i tag, dal più recente, filtrati per parte del nome, con digest, dimensione compressa e ultimo push. dockerhub_get_tag mostra per un tag l'immagine di ogni piattaforma (sistema operativo, architettura, variante, digest e dimensione). Serve per verificare se un tag esiste per arm64, quando è stato ricostruito l'ultima volta o se due tag puntano allo stesso digest.
• Il tuo account: dockerhub_list_my_orgs elenca le organizzazioni di cui fai parte, dockerhub_get_org legge il profilo pubblico di un'organizzazione, compreso il badge di verified publisher, e dockerhub_list_repositories elenca tutti i repository di un utente o di un'organizzazione, anche quelli privati se il token può leggerli.

Limiti di pull: dockerhub_pull_limits spiega quanti pull consente Docker Hub per tipo di account (per esempio 100 ogni 6 ore per i pull anonimi e 200 per un account Personal autenticato) e come verificare quanti ne restano dalla macchina che fa i pull. Le chiamate di questo connettore sono richieste API, non pull di immagini, e non contano ai fini del limite.

Niente dati sulle vulnerabilità: Docker Scout non ha un'API pubblica, quindi il connettore non può mostrare le CVE. Per quelle usa la pagina Docker Scout dell'immagine su hub.docker.com o il comando docker scout.

Contenuti non affidabili: descrizioni e README dei repository sono scritti da chi li pubblica. L'AI tratta le istruzioni che contengono come dati, non come ordini.

Errori comuni: 401 all'accesso: Docker ID o token errati, oppure il token è stato revocato o è scaduto; usa il Docker ID, non l'indirizzo e-mail, e crea un nuovo token. 401 o 403 su dockerhub_get_user mentre le ricerche pubbliche funzionano: il segreto è un organization access token; usa un personal access token. 404: namespace, repository o tag non esistono, oppure sono privati e il token non può leggerli; le immagini ufficiali richiedono il namespace library. 429: Docker Hub limita le richieste API per account e IP; attendi un minuto e riprova.

Il connettore non crea repository, non fa push di immagini, non elimina tag, non gestisce team e membri, token di accesso o audit log e non mostra i risultati di Docker Scout.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Muse

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di Docker Hub.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Esiste un'immagine linux/arm64 per postgres:16-alpine e quando è stato fatto l'ultimo push?"
• "Elenca i dieci tag di node aggiornati più di recente che contengono alpine, con la loro dimensione compressa."
• "nginx:stable-alpine e nginx:alpine puntano allo stesso digest in questo momento?"
• "Mostra tutti i repository della nostra organizzazione acme, privati compresi, ordinati per numero di pull."
• "Cerca su Docker Hub immagini di Keycloak e dimmi quale è l'immagine ufficiale o viene da un verified publisher."
• "Spiegami i limiti di pull per un account Docker gratuito e come verifico quanti pull restano al nostro runner di CI."

FAQ

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT