Come collegare Canva a Gemini via MCP

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

Canva + Gemini

Fai lavorare la tua AI in Canva: trova e leggi i design, creane di nuovi, esportali in PDF, PNG, PowerPoint o video con link per il download, organizza le cartelle, carica immagini da un link, leggi i modelli del brand e commenta i design.

Prerequisiti

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

CANVA_CLIENT_ID, CANVA_CLIENT_SECRET

Step 1 — Ottieni le credenziali

1. Attiva l'autenticazione a più fattori con un'app di autenticazione per il tuo account Canva: Settings → Login & security. Canva abilita l'accesso alle REST API per gli sviluppatori solo quando è attiva.
2. Apri il Canva Developer Portal su https://www.canva.com/developers/apps, fai clic su Create an app e scegli a chi è destinata. Un'app privata viene approvata dagli admin del tuo team e richiede un team Canva Enterprise. Un'app pubblica funziona subito per te che la sviluppi; gli altri utenti Canva possono collegarla solo dopo la revisione di Canva. Poi apri Outside Canva → Start integrating per usare le REST API.
3. In Configuration → Scopes spunta questi dodici scope: profile:read, design:meta:read, design:content:read, design:content:write, folder:read, folder:write, asset:read, asset:write, brandtemplate:meta:read, brandtemplate:content:read, comment:read, comment:write. Il connettore li chiede tutti, e Canva rifiuta un accesso che chiede uno scope non spuntato.
4. In Authentication aggiungi l'URL di reindirizzamento https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP in proprio, è <your AnythingMCP URL>/api/mcp-oauth/callback. Canva rifiuta gli URL di reindirizzamento con localhost, quindi in un'installazione locale usa 127.0.0.1: imposta SERVER_URL su http://127.0.0.1:<port> e registra http://127.0.0.1:<port>/api/mcp-oauth/callback.
5. Copia il Client ID in CANVA_CLIENT_ID. Fai clic su Generate secret e incollalo subito in CANVA_CLIENT_SECRET: Canva lo mostra una sola volta.
6. Installa il connettore, fai clic su Authorize with Provider e consenti l'accesso in Canva. L'accesso usa OAuth 2.0 con PKCE: AnythingMCP non vede mai la tua password di Canva e rinnova da solo i token di accesso (validi circa quattro ore). Ogni refresh token funziona una volta e viene sostituito a ogni rinnovo.
7. Inizia con canva_get_me: restituisce l'id del tuo utente e del tuo team Canva, un controllo rapido che l'autorizzazione funziona.

Le esportazioni arrivano come link per il download: canva_create_export avvia un job e canva_get_export dice quando è finito, con un link per file (le immagini di più pagine ne danno uno per pagina). I link restano validi 24 ore. canva_get_design_export_formats mostra i formati supportati da un design: PDF, JPG, PNG, SVG, PowerPoint, GIF, MP4 e altri, a seconda del tipo di design. I design con elementi premium senza licenza falliscono con license_required. Canva consente 75 esportazioni per utente ogni 5 minuti e 500 al giorno.

Caricamenti da un link: canva_upload_asset_from_url mette un'immagine o un video nella cartella Uploads, e canva_get_asset_upload dice quando è arrivato. Canva scarica il file da sé, quindi il link deve rispondere 200 al downloader di Canva. I siti che rifiutano i download automatici fanno fallire il job con fetch_failed.

Cartelle e design: root indica il livello principale dei tuoi Progetti e uploads la cartella Uploads. L'id di un design è la parte dopo /design/ in un link di Canva, per esempio DAFVztcvd9z in https://www.canva.com/design/DAFVztcvd9z/.... canva_create_design crea un doc, un'email, una presentazione o una lavagna vuoti, oppure un formato personalizzato in pixel, e restituisce il link per modificarlo. I link delle miniature scadono dopo 15 minuti, quelli di modifica e di visualizzazione dopo 30 giorni.

Quale piano: design, cartelle, caricamenti, esportazioni e commenti funzionano con ogni piano Canva, anche Free. I modelli del brand richiedono un piano che li includa (Pro, Teams o Enterprise); canva_get_capabilities elenca brand_template se il tuo li ha.

Prima conferma: commenti e risposte (canva_create_comment, canva_reply_to_comment) sono visibili ai tuoi collaboratori, quindi l'AI ti mostra il testo prima di pubblicarlo. canva_delete_folder e canva_delete_asset, che spostano gli elementi nel Cestino, sono disattivati all'installazione.

Solo lettura: togli la spunta agli scope :write nel Developer Portal e nelle impostazioni OAuth del connettore, autorizza di nuovo e disattiva i tool che creano, modificano o spostano qualcosa.

API in anteprima: commenti e caricamenti da un link usano API di Canva in anteprima, che possono cambiare senza preavviso, e un'app pubblica che le usa non supera la revisione di Canva. Per un'app pubblica disattiva canva_upload_asset_from_url, canva_get_asset_upload e i quattro tool dei commenti.

Errori comuni: invalid_access_token o revoked_access_token vuol dire che devi autorizzare di nuovo. missing_scope: spunta lo scope nel portale e nelle impostazioni OAuth del connettore, poi autorizza di nuovo. permission_denied o design_not_found (anche folder_not_found, asset_not_found): l'id è sbagliato o il tuo account non vede quell'elemento. Un 403 "requires one of capabilities" indica una funzione a pagamento come i modelli del brand. too_many_requests: la maggior parte delle chiamate consente da 10 a 100 richieste al minuto per utente, quindi aspetta un minuto.

Il connettore non modifica il contenuto di un design, non compila i modelli del brand (autofill), non ridimensiona i design, non importa file, non genera con l'AI, non legge le statistiche dei design e non configura webhook.

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Canva.

Tool disponibili

Esempi di prompt

• "Trova i miei design con 'pitch deck' nel titolo e dammi il link per modificare il più recente."
• "Esporta la presentazione 'Q4 sales review' in PDF e dammi il link per scaricarla."
• "Carica nel mio Canva la foto prodotto a questo link e crea con essa un nuovo post da 1080 × 1080."
• "Crea una cartella 'Campagna autunno' e spostaci tutti i design della campagna della settimana scorsa."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

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