Server MCP per Cline: genera immagini dall’editor

Un server MCP remoto in Cline è un set di tool ospitato che l’agente chiama via HTTP: aggiungi un blocco al JSON delle impostazioni MCP e Cline riesce a fare cose che nessun modello linguistico fa da solo. Generare un file immagine è l’esempio più chiaro. Cline ti rifattorizza i componenti, lancia i test e scrive la migrazione, poi si ferma di colpo su «e qui va la foto del prodotto».

Tutta la configurazione, per chi ha fretta. Crea una chiave nel tuo profilo BananaBanana, apri le impostazioni MCP di Cline e aggiungi:

{
  "mcpServers": {
    "bananabanana": {
      "type": "streamableHttp",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": ["list_models", "get_account", "get_result"]
    }
  }
}

Compaiono dieci tool, le immagini costano da $0.03 l’una e si pagano da un saldo prepagato, i video da $0.10. La riga type non è facoltativa, e il motivo è un malfunzionamento davvero subdolo di cui parlo più avanti.

Perché aggiungere un generatore di immagini a Cline?

Tutta la logica di Cline è «descrivi il risultato, lascia che l’agente faccia i passaggi». Funziona finché il risultato non include un’immagine: lì il ciclo si rompe e tocca a te il lavoro manuale. Scheda del browser, prompt, download, rinomina, sposta in public/, torna indietro, ritrova il punto dov’eri. Cinque minuti ad asset, e l’interruzione costa più dei cinque minuti.

Con un tool MCP il ciclo lo fa l’agente. Scrive il prompt, chiama generate_image, scarica il file finito nella cartella che hai indicato e aggiorna il markup. Tu rivedi un diff.

Anche i conti tornano per chi usa Cline. Cline funziona con il modello che porti tu, quindi chi lo usa è già abituato a pagare a unità e non al mese, e i prezzi delle generazioni seguono la stessa logica. Niente piano, niente postazioni, nessun minimo mensile. Immagini da $0.03, video da $0.10, da un saldo che ricarichi quando ti pare.

L’alternativa è un server MCP locale per le immagini: un processo Node o Python che gira sulla tua macchina più una tua chiave del provider a monte, con quote e fatturazione sul tuo account. Un endpoint ospitato elimina entrambe le cose. La generazione avviene da noi, sulla stessa pipeline del generatore web, e l’unica credenziale che hai è una stringa revocabile.

Come si aggiunge un server MCP remoto in Cline?

Tre strade, stesso risultato. I dettagli qui sotto sono verificati sulla documentazione MCP ufficiale di Cline al 20 agosto 2026.

Dall’interfaccia. Clicca l’icona MCP Servers nella barra del pannello di Cline, apri la scheda Remote Servers e compila nome del server, URL https://bananabanana.pro/api/mcp e scegli Streamable HTTP come trasporto. Add Server. Poi torna indietro e aggiungi l’header Authorization: il modulo è la via più rapida per partire, ma la credenziale vive nel JSON.

Modificando il JSON. Stessa icona, scheda Configure, poi il pulsante Configure MCP Servers, che apre il file delle impostazioni dell’estensione. Il file sta nello storage globale di VS Code, in una cartella chiamata saoudrizwan.claude-dev (l’ID dell’estensione porta ancora il nome del publisher dell’autore originale, e chi cerca qualcosa che si chiami «cline» ci resta spiazzato). Nella CLI è semplicemente ~/.cline/mcp.json, e cline mcp apre una procedura guidata interattiva con gli stessi campi.

Dal terminale. cline config mcp --json stampa ciò che è davvero caricato: è il modo più veloce per confermare che la modifica ha preso.

Qualunque strada scegli, l’endpoint è https://bananabanana.pro/api/mcp. Non /mcp, che è la pagina di documentazione per le persone e risponde con HTML a qualsiasi POST. La nostra pagina del server MCP riporta lo snippet generico e una tabella di compatibilità dei client che abbiamo verificato:

Fai un test con una chiamata gratuita prima di spendere qualcosa. get_account restituisce il saldo, il nome della chiave e il suo tetto giornaliero; list_models restituisce tutti i modelli con i prezzi attuali. Nessuna delle due costa nulla, ed entrambe confermano l’autenticazione in circa un secondo.

Caso d’uso: un lotto di segnaposto per il catalogo in modalità Act

Qui Cline si guadagna lo stipendio, ed è un lavoro diverso da «fammi un’immagine hero». Prima la modalità Plan: descrivi il catalogo, dodici prodotti che hanno bisogno di uno scatto segnaposto nello stesso stile di casa, e lascia che Cline abbozzi il ciclo prima di toccare qualcosa. Poi la modalità Act lo esegue.

Lo stile di casa è una frase riusata in ogni chiamata, cambiando solo il soggetto. La coerenza di un set viene dalla parte invariante del prompt, non dal modello che si ricorda cosa ha fatto un minuto fa:

→ generate_image {"prompt": "A photorealistic overhead product shot of a
   small monstera in a matte terracotta pot on a pale linen backdrop, soft
   diffused window light from the left, 50mm lens, subtle natural shadow,
   generous empty space around the subject, no text",
   "model": "nano-banana-pro", "aspect_ratio": "4:5"}
← {"job_id": "…", "status": "processing", "cost_charged_usd": 0.11,
   "balance_remaining_usd": 1110.65}

Secondo prodotto, stessa frase di stile, pianta diversa e angolazione diversa:

Dodici di queste con Nano Banana Pro fanno $1.32. Con il predefinito nano-banana-2-lite sono $0.36, e per riempitivi di griglia che un designer sostituirà comunque è la scelta che farei io; la nostra guida a Lite spiega dove il modello economico smette di reggere. Qui ho usato Pro perché queste due finiscono su questa pagina a dimensione piena.

Un lotto è anche proprio la situazione in cui vuoi una cintura di sicurezza. Ce ne sono due. Ogni chiave MCP accetta un tetto giornaliero in USD facoltativo in Profilo → Chiavi API MCP, così un ciclo che va storto si ferma a una cifra scelta da te e non al tuo saldo. E le chiamate con più immagini (number_of_images sopra 1) si comportano come i video: la prima chiamata restituisce un preventivo e non addebita nulla finché l’agente non la ripete con confirm_cost.

I video partono dalla stessa chat, con la stessa regola di conferma. Veo 3.1 Lite a 720p senza audio parte da $0.10 per quattro secondi, e Omni Flash costa $0.10 al secondo con l’audio sempre attivo, quindi una clip di tre secondi fa $0.30. Il rendering richiede da uno a dieci minuti, e siccome generate_video restituisce subito un job id, Cline continua a lavorare sul tuo codice e interroga get_result quando è pronto.

Stranezze di Cline da conoscere prima di andare in produzione

Cinque, più o meno in ordine di quanto tempo ti faranno perdere.

1. "type": "streamableHttp" si scrive esattamente così, e se lo ometti le cose si rompono in silenzio. La documentazione è netta: senza quel campo, per retrocompatibilità si ricade sul vecchio trasporto sse. SSE legacy vuol dire che il client apre un GET verso il tuo URL e aspetta uno stream di eventi. Il nostro endpoint è Streamable HTTP senza stato, quindi un GET riceve 405 Method Not Allowed (l’ho ricontrollato mentre scrivevo: curl -i https://bananabanana.pro/api/mcp restituisce 405). In Cline vedi un server che non si connette, con un errore che non dice nulla di un campo mancante nella config. Con il trattino, streamable-http, fallisce allo stesso modo.

2. La chiave sta in quel file in chiaro. La documentazione di Cline consiglia di tenere i segreti nelle variabili d’ambiente, ma l’interpolazione delle variabili dentro l’oggetto headers remoto non è una funzione documentata, a differenza di ${env:…} di Cursor o ${file:…} di Windsurf. La consolazione è la posizione: il file di impostazioni dell’estensione vive nello storage globale di VS Code, non nel tuo repo, quindi non c’è un modo realistico di committarlo per sbaglio. Resta comunque una credenziale su disco. Dagli un tetto giornaliero e revocala dalla pagina del profilo nel momento in cui una macchina esce dalle tue mani.

3. Auto Approve è più grossolano di quanto pensi. Nel pannello Auto Approve di Cline, «Use MCP servers» è un unico interruttore che copre i tool MCP come categoria, quindi attivarlo approva quelli che spendono soldi insieme a quelli gratuiti. Il controllo per singolo tool sta invece nella config, nell’array autoApprove del server. La mia lista consentita sono le tre chiamate gratuite (list_models, get_account, get_result) e nient’altro: elimina la fatica delle approvazioni durante un lotto, mentre ogni rendering si ferma comunque a chiedere.

4. La modalità YOLO con tool a pagamento merita un attimo di riflessione. La modalità YOLO di Cline approva automaticamente tutto: modifiche ai file, comandi da terminale, azioni nel browser, tool MCP. La documentazione la definisce pericolosa, e a ragione. Il nostro passaggio di conferma del costo qui non ti salva, perché un agente completamente autonomo approverà volentieri entrambe le metà dello scambio preventivo-conferma. Quello che ti salva è il tetto giornaliero per chiave. Impostalo prima di accendere YOLO, non dopo.

5. Non c’è installazione da marketplace, e i controlli enterprise hanno una strada a parte. Cline non espone più una superficie MCP Marketplace per sfogliare e installare nell’estensione VS Code basata sull’SDK, quindi il JSON manuale è la strada per tutti. Gli admin hanno un’altra leva: remoteMCPServers nella configurazione remota dell’organizzazione distribuisce a ogni utente un server remoto preconfigurato, e blockPersonalRemoteMCPServers impedisce alle persone di aggiungerne di propri. Se lo stai distribuendo a un team, spingilo centralmente e dai a ogni sviluppatore la sua chiave.

Un limite onesto da parte nostra, visto che stiamo elencando gli spigoli: generate_speech restituisce un WAV come link firmato e non come qualcosa che Cline possa riprodurre nel pannello, quindi per l’audio devi aprire il file. Le immagini tornano con una piccola anteprima inline accanto all’URL, che è il più utile dei due comportamenti. Cline ha aggiunto il supporto ai contenuti immagine nei risultati dei tool già nel 2025, quindi su qualsiasi build attuale l’anteprima si vede.

Cline supporta OAuth per i server MCP remoti?

Non in modo documentato, no, e vale la pena dirlo chiaramente perché la risposta cambia da client a client. La documentazione MCP di Cline copre stdio, SSE e Streamable HTTP, con l’autenticazione descritta come header che fornisci tu. OAuth non c’è. Una richiesta di funzionalità per personalizzare OAuth è aperta sul repo di Cline da agosto 2025 e risulta ancora aperta al 20 agosto 2026.

In pratica, qui va benissimo così. Il nostro server accetta sia un token OAuth 2.1 sia una chiave API Bearer, e la strada della chiave è quella per cui Cline è costruito. È anche quella che sceglierei comunque: le chiavi sono gratis, puoi averne diverse e ognuna ha il suo registro d’uso (tool, modello, costo, anteprima del prompt) più quel tetto giornaliero. Quando il portatile di un collaboratore esterno se ne va, revochi una chiave e il setup di nessun altro se ne accorge.

Se vuoi isolare i progetti, crea una chiave per progetto invece di una per tutto. Il registro d’uso ti dice poi quanto è costato davvero il lavoro sulla «dashboard interna» rispetto al sito marketing, una domanda che salta fuori proprio al momento della fatturazione.

Quanto sono costati i media demo di questo articolo?

Prezzi standard per generazione, le stesse cifre che list_models passa all’agente:

Utile da sapere se stai ricaricando e non solo provando: i depositi da $50 in su aggiungono il 5% al saldo, da $100 in su il 10%, e un codice promo attivo aggiunge un altro 10% del deposito. Entrambi si calcolano sulla stessa base, quindi $100 con un codice accreditano $120.

La stessa chiave funziona in tutti gli altri client, quindi se usi anche Cursor o VS Code non si crea nulla di nuovo: stesso saldo, stessa cronologia, un solo endpoint. La guida per Cursor e la configurazione per VS Code coprono quei due, e i casi d’uso si trasferiscono quasi invariati. Crea una chiave e chiedi a Cline il primo lotto.

FAQ

Cline supporta i server MCP remoti via Streamable HTTP?

Sì, ed è il trasporto consigliato dalla documentazione stessa di Cline. Un server remoto è un url, un type impostato su streamableHttp e un oggetto headers facoltativo per l’autenticazione, con SSE legacy ancora disponibile per i server più vecchi. Imposta type in modo esplicito: se lo ometti si ricade su SSE per retrocompatibilità, che fallisce contro un endpoint moderno senza stato. Verificato sulla documentazione ufficiale al 20 agosto 2026.

Dove si trova il file delle impostazioni MCP di Cline?

In due posti, a seconda di come lo usi. L’estensione VS Code lo tiene nello storage globale di VS Code, in una cartella che porta l’ID dell’estensione saoudrizwan.claude-dev, e il modo affidabile per aprirlo è il pulsante Configure MCP Servers nella scheda Configure del pannello MCP, invece di andare a caccia tra le cartelle. La CLI usa ~/.cline/mcp.json. Entrambi accettano lo stesso oggetto mcpServers.

Mi serve un account cloud mio per generare immagini in Cline?

No. Un server MCP per immagini in locale richiede una chiave del provider a monte con quote e fatturazione sul tuo account. Il server remoto esegue la generazione sul nostro pool di chiavi gestito, quindi l’unica credenziale che maneggi è la chiave bb_live_ del tuo profilo. I nuovi account partono con $0.20 di saldo, che coprono sei immagini sul modello più economico prima che tu paghi qualcosa.

Come evito che un agente spenda troppo?

Tre controlli, e io li userei tutti e tre. Limita autoApprove ai tool gratuiti, così ogni rendering chiede prima. Imposta un tetto giornaliero in USD sulla chiave in Profilo → Chiavi API MCP: è l’unico che funziona ancora se attivi la modalità YOLO. E lascia fare il suo lavoro al passaggio di conferma del costo: le chiamate video e multi-immagine restituiscono un preventivo alla prima chiamata e non addebitano nulla finché l’agente non ripete la chiamata con confirm_cost impostato sull’importo del preventivo.

Perché il mio server MCP in Cline non si connette?

Controlla in quest’ordine. C’è "type": "streamableHttp", scritto in camelCase? Senza, Cline prova SSE legacy e il nostro endpoint risponde 405 al GET. L’URL finisce con /api/mcp e non con /mcp? L’header Authorization è esattamente Bearer bb_live_..., senza spazi di troppo? Una chiave sbagliata o revocata restituisce 401. Se si connette ma mancano i tool, riavvia il server dal pannello MCP; se sei su un piano enterprise, i server remoti personali potrebbero essere bloccati dalla configurazione della tua organizzazione.