Come collegare Freepik a Meta Muse — via MCP

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

Freepik + Meta Muse

Contenuti stock e immagini AI di Freepik tramite l'API di Freepik, ora gestita come Magnific API: cerca e scarica foto, vettoriali e PSD, cerca e scarica icone, cerca video stock e genera immagini con Mystic.

Prerequisiti

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

FREEPIK_API_KEY

Step 1 — Ottieni le credenziali

L'API di Freepik ora è pubblicata come Magnific API (https://api.magnific.com, documentazione su docs.magnific.com). Il catalogo stock resta quello di Freepik, e le chiavi API Freepik esistenti continuano a funzionare.

1. Su magnific.com apri il tuo account, poi Organization → API keys, e crea una chiave.
2. Incollala in FREEPIK_API_KEY. Il connettore la invia nell'header x-magnific-api-key. Non c'è OAuth; la chiave è un segreto lato server.
3. Parti da freepik_search_resources (foto, vettoriali, PSD), freepik_search_icons o freepik_search_videos, e controlla licenza e formati con freepik_get_resource prima di scaricare.

Crediti: l'API si paga a crediti. Ricerche e dettagli costano poco. Ogni chiamata a freepik_download_resource, freepik_download_resource_format e freepik_download_icon registra un download sull'account, e freepik_generate_image_mystic consuma crediti AI. Questi tool sono marcati come scritture, quindi il client AI chiede conferma prima di chiamarli. Un 402 significa che l'account ha finito i crediti.

Licenze: le risorse freemium richiedono l'attribuzione a Freepik o all'autore, a meno che l'account abbia un piano premium; le risorse premium richiedono un piano che le includa. Controlla licenses[].type prima di usare un asset a fini commerciali. Gli URL di download scadono dopo poco, quindi scarica subito il file.

Limiti: 10 richieste al secondo in media su due minuti e 50 al secondo per IP in una finestra di 5 secondi. La generazione Mystic è asincrona: interroga freepik_get_mystic_task finché status non è COMPLETED.

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 Freepik.

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

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
• Collega a Claude
• Collega a ChatGPT