Collegare Groq a Gemini CLI via MCP

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

Groq + Gemini

GroqCloud con la tua chiave API: chat completion veloci con modelli aperti come Llama, GPT-OSS e Qwen, trascrizione e traduzione in inglese di file audio da un link pubblico con Whisper, e i modelli, i batch job e i file dell'organizzazione.

Prerequisiti

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

GROQ_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account GroqCloud; il piano gratuito funziona entro i suoi limiti di frequenza.

1. Accedi a https://console.groq.com e apri API Keys (https://console.groq.com/keys).
2. Clicca Create API Key, dai un nome alla chiave e copiala. Inizia con gsk_ e Groq la mostra una sola volta.
3. Incollala in GROQ_API_KEY, senza la parola Bearer. Il connettore la invia come Authorization: Bearer e solo a Groq.
4. Installa il connettore ed esegui groq_list_models: elenca i modelli che la chiave può usare e conferma la chiave.

Quali strumenti costano: groq_chat_completion, groq_transcribe_audio e groq_translate_audio eseguono un modello. Con il piano gratuito non costano nulla ma sono limitati; con il piano Developer ogni chiamata viene addebitata all'organizzazione: il testo per token di input e output, Whisper per ora di audio con un minimo di 10 secondi per richiesta. L'AI ti chiede conferma prima di chiamate grandi o ripetute e imposta max_completion_tokens per limitare la risposta. groq_list_models, groq_get_model, groq_list_batches, groq_get_batch, groq_list_files e groq_get_file sono gratuiti.

Modelli: groq_list_models mostra ogni modello che la chiave può usare con proprietario, context_window, max_completion_tokens e se è attivo; groq_get_model ne legge uno e risponde 404 per un modello non disponibile per la chiave. Gli id dei modelli cambiano spesso: i modelli preview possono sparire con poco preavviso, quelli production sono stabili. Id comuni sono llama-3.3-70b-versatile, llama-3.1-8b-instant (il più economico), openai/gpt-oss-120b, openai/gpt-oss-20b e qwen/qwen3.8-27b; per l'audio whisper-large-v3-turbo (più economico) e whisper-large-v3.

Testo: groq_chat_completion riceve model e messages e restituisce la risposta intera in una volta (niente streaming). response_format chiede JSON o uno schema JSON, tools aggiunge il function calling, e reasoning_effort e reasoning_format regolano i modelli di ragionamento (GPT-OSS accetta low, medium o high; Qwen accetta none o default).

Audio: groq_transcribe_audio trascrive il parlato nella sua lingua, groq_translate_audio lo trasforma in testo inglese (traduce solo whisper-large-v3). Entrambi ricevono un link pubblico in url: Groq scarica il file da sé, quindi non si carica nulla. Formati: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Indicare language (ISO-639-1, ad esempio it) rende la trascrizione più veloce e precisa. response_format verbose_json aggiunge segmenti con timestamp, timestamp_granularities word i tempi delle singole parole.

Batch job e file: groq_list_batches e groq_get_batch mostrano i batch avviati altrove con stato (validating, in_progress, finalizing, completed, failed, expired, cancelling, cancelled), numero di richieste e output_file_id ed error_file_id. groq_list_files e groq_get_file mostrano nome del file, dimensione in byte, scopo (batch o batch_output) e data di creazione, non il contenuto.

Formati dei dati: una completion restituisce choices[0].message.content, finish_reason (stop, length quando si è raggiunto max_completion_tokens, tool_calls) e usage con i conteggi dei token e i tempi in secondi; i modelli di ragionamento possono mettere il ragionamento in choices[0].message.reasoning. Il risultato contiene anche _headers con le richieste e i token rimasti nel limite. Una trascrizione restituisce text. Timestamp come created sono secondi Unix, in UTC.

Paginazione: gli strumenti di elenco non hanno parametri di pagina; restituiscono ciò che Groq invia in un'unica risposta.

Disattivati all'installazione: nessuno. Tutti i 9 strumenti sono attivi e nessuno cancella dati.

Limiti: i limiti di frequenza valgono per organizzazione e modello, come richieste e token al minuto e al giorno (https://console.groq.com/settings/limits). I link audio possono puntare a file fino a 25 MB sul piano gratuito e fino a 100 MB sui piani a pagamento.

Errori comuni: 400 indica un parametro che il modello non supporta o un audio illeggibile; 401 una chiave errata o cancellata; 403 che il progetto non può usare quel modello; 404 un modello, batch o file sconosciuto; 413 un file audio troppo grande; 429 il limite di frequenza raggiunto (l'AI attende i secondi indicati in retry-after invece di riprovare in loop); 498 la capacità del tier flex esaurita; 500 e 503 sono problemi di Groq, riprova una volta più tardi.

Il connettore non trasmette le risposte in streaming, non carica né scarica il contenuto dei file e non crea né annulla batch job.

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

Tool disponibili

Esempi di prompt

• "Quali modelli Groq può usare adesso la mia chiave, e qual è la finestra di contesto di ciascuno?"
• "Riassumi questa email di assistenza in tre punti con llama-3.1-8b-instant, restando sotto i 200 token."
• "Trascrivi la puntata del podcast tedesco su https://example.com/audio/episode-12.mp3 con i timestamp per segmento."
• "Traduci in testo inglese il messaggio vocale italiano su https://example.com/voice/note.m4a."
• "Mostrami lo stato dei miei batch job Groq e quante richieste sono fallite nell'ultimo."

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
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot