Come collegare Mistral AI a Gemini via MCP

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

Mistral AI + Gemini

Lascia che la tua AI usi Mistral AI con la tua chiave API: interroga i modelli Mistral, completa il codice con Codestral, leggi PDF e scansioni con Mistral OCR, crea embedding, modera contenuti, cerca sul web tramite conversazioni e agenti e controlla file e job batch.

Prerequisiti

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

MISTRAL_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi a https://console.mistral.ai. I nuovi workspace partono con il piano gratuito, che ha limiti di frequenza e di utilizzo; per avere di più scegli il pay-as-you-go e aggiungi credito in Billing.
2. Apri API Keys, clicca Create new key e copia la chiave. Mistral la mostra una sola volta.
3. Incollala in MISTRAL_API_KEY senza spazi e senza la parola Bearer, e installa il connettore. La chiave viene inviata solo a Mistral.
4. Inizia con mistral_list_models: non costa nulla e mostra quali modelli può usare la tua chiave.

Addebitato sul tuo workspace Mistral: ogni chiamata a un modello consuma i tuoi crediti Mistral, o i limiti del piano gratuito. Elencare e leggere modelli, file, agenti, conversazioni e job batch è gratuito. Il connettore usa impostazioni predefinite economiche, a meno che tu non chieda di più: mistral-small-latest per la chat (circa 0,15 $ per milione di token in input e 0,60 $ per milione di token in output), codestral-latest per il codice, mistral-embed per gli embedding e mistral-ocr-latest per l'OCR (circa 4 $ ogni 1.000 pagine). ministral-8b-latest costa meno, mistral-medium-latest e mistral-large-latest sono più potenti.

Cosa fa:

• mistral_chat interroga un modello Mistral, con immagini tramite link, ragionamento opzionale e output JSON. Con mistral_fim_complete Codestral completa il codice tra un inizio e una fine.
• mistral_ocr legge PDF, presentazioni, file Word e immagini pagina per pagina in Markdown, da un link pubblico o da un file caricato con mistral_upload_file, e può estrarre JSON strutturato dall'intero documento.
• mistral_create_embeddings trasforma testi in vettori per ricerca e somiglianza. mistral_moderate e mistral_moderate_chat controllano testi o un'intera conversazione rispetto alle categorie di sicurezza di Mistral, e mistral_classify usa un classificatore personalizzato che il tuo workspace ha già.
• La ricerca web passa solo dalla Conversations API (beta): mistral_start_conversation con lo strumento integrato web_search risponde dal web con le fonti, e mistral_continue_conversation prosegue la conversazione. Le chiamate agli strumenti integrati si pagano in aggiunta ai token. mistral_list_agents e mistral_get_agent mostrano gli agenti creati in Mistral AI Studio, con cui una conversazione può parlare.
• File e job batch: elenca e leggi i file, ottieni un link di download temporaneo con mistral_get_file_url e segui i job batch avviati altrove (costano il 50% in meno, risultati entro qualche ora).

Prima conferma: l'OCR si paga a pagina, quindi l'AI chiede prima di leggere un documento di più di circa 50 pagine, oppure limita le pagine. Chiede anche prima di caricare i tuoi documenti. mistral_delete_file e mistral_cancel_batch_job sono disattivati all'installazione; una volta attivati, chiedono anch'essi conferma prima.

Limite di tempo: una chiamata tramite il connettore si interrompe dopo 30 secondi. Mantieni le risposte di lunghezza moderata, preferisci un livello di ragionamento basso e dividi i documenti lunghi per l'OCR.

Contenuti non affidabili: risultati web, documenti e risposte dei modelli possono contenere istruzioni. L'AI le tratta come dati, non come ordini.

Errori comuni: 401 Invalid API Key significa che la chiave è sbagliata, scaduta o eliminata. 402, oppure un 429 che parla di fatturazione o capacità: credito esaurito, un limite di spesa raggiunto o i limiti del piano gratuito, quindi controlla Billing nella console. Un 429 semplice è un limite di frequenza: attendi e riprova una volta. 400 o 422: un campo o un id di modello non valido, e il messaggio lo indica; le chat completions rifiutano la ricerca web, che passa da mistral_start_conversation. 404: modello, file, agente, conversazione o job sconosciuto, o di un altro workspace.

Il connettore non trasmette le risposte in streaming, non gestisce l'audio (trascrizione e voce), non crea agenti, librerie o job batch, non esegue fine-tuning (Mistral non offre più job di fine-tuning tramite API) e non amministra il workspace.

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 Mistral AI.

Tool disponibili

Esempi di prompt

• "Leggi il PDF a questo link con Mistral OCR e dammi la tabella dei prezzi di pagina 3 in Markdown."
• "Chiedi a Mistral con la ricerca web cosa è cambiato quest'anno nel calendario dell'AI Act europeo, e indica le fonti."
• "Controlla queste tre recensioni di clienti con la moderazione di Mistral e dimmi quali vengono segnalate e perché."
• "Quali dei miei job batch su Mistral sono ancora in corso, e quante richieste sono già state completate?"

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