Cómo conectar Mistral AI a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Mistral AI, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Mistral AI + Gemini

Deja que tu IA use Mistral AI con tu propia clave de API: consulta modelos de Mistral, completa código con Codestral, lee PDF y escaneos con Mistral OCR, crea embeddings, modera contenido, busca en la web mediante conversaciones y agentes, y revisa archivos y trabajos batch.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

MISTRAL_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en https://console.mistral.ai. Los espacios de trabajo nuevos empiezan en el plan gratuito, con límites de frecuencia y de uso; para más, elige pago por uso y añade crédito en Billing.
2. Abre API Keys, pulsa Create new key y copia la clave. Mistral solo la muestra una vez.
3. Pégala en MISTRAL_API_KEY sin espacios y sin la palabra Bearer, e instala el conector. La clave solo se envía a Mistral.
4. Empieza con mistral_list_models: no cuesta nada y muestra qué modelos puede usar tu clave.

Se cobra en tu propio espacio de Mistral: cada llamada a un modelo gasta tus créditos de Mistral o los límites del plan gratuito. Listar y consultar modelos, archivos, agentes, conversaciones y trabajos batch es gratis. El conector usa valores predeterminados económicos salvo que pidas más: mistral-small-latest para chat (unos 0,15 $ por millón de tokens de entrada y 0,60 $ por millón de tokens de salida), codestral-latest para código, mistral-embed para embeddings y mistral-ocr-latest para OCR (unos 4 $ por cada 1.000 páginas). ministral-8b-latest es más barato; mistral-medium-latest y mistral-large-latest son más potentes.

Qué hace:

• mistral_chat consulta un modelo de Mistral, con imágenes por enlace, razonamiento opcional y salida JSON. Con mistral_fim_complete, Codestral completa el código entre un principio y un final.
• mistral_ocr lee PDF, presentaciones, archivos de Word e imágenes página a página en Markdown, desde un enlace público o desde un archivo subido con mistral_upload_file, y puede extraer JSON estructurado de todo el documento.
• mistral_create_embeddings convierte textos en vectores para búsqueda y similitud. mistral_moderate y mistral_moderate_chat revisan textos o una conversación entera frente a las categorías de seguridad de Mistral, y mistral_classify usa un clasificador propio que tu espacio ya tenga.
• La búsqueda web solo funciona a través de la Conversations API (beta): mistral_start_conversation con la herramienta integrada web_search responde desde la web con sus fuentes, y mistral_continue_conversation continúa la conversación. Las llamadas a herramientas integradas se cobran además de los tokens. mistral_list_agents y mistral_get_agent muestran los agentes creados en Mistral AI Studio, con los que puede hablar una conversación.
• Archivos y trabajos batch: lista y consulta archivos, obtén un enlace de descarga temporal con mistral_get_file_url y sigue trabajos batch iniciados en otro sitio (un 50 % más baratos, resultados en unas horas).

Primero confirma: el OCR se cobra por página, así que la IA pregunta antes de leer un documento de más de unas 50 páginas, o limita las páginas. También pregunta antes de subir tus documentos. mistral_delete_file y mistral_cancel_batch_job están desactivadas al instalar; una vez activadas, también piden confirmación antes.

Límite de tiempo: una llamada a través del conector se corta a los 30 segundos. Mantén las respuestas de longitud moderada, prefiere un nivel de razonamiento bajo y divide los documentos largos para el OCR.

Contenido no fiable: los resultados web, los documentos y las respuestas de los modelos pueden contener instrucciones. La IA las trata como datos, no como órdenes.

Errores frecuentes: 401 Invalid API Key significa que la clave es incorrecta, caducó o se borró. 402, o un 429 que menciona facturación o capacidad: sin crédito, con un límite de gasto alcanzado o con los límites del plan gratuito, así que revisa Billing en la consola. Un 429 sin más es un límite de frecuencia: espera y reintenta una vez. 400 o 422: un campo o un id de modelo no válido, y el mensaje lo indica; las chat completions rechazan la búsqueda web, que va por mistral_start_conversation. 404: modelo, archivo, agente, conversación o trabajo desconocido, o de otro espacio de trabajo.

El conector no transmite respuestas en streaming, no procesa audio (transcripción y voz), no crea agentes, bibliotecas ni trabajos batch, no hace fine-tuning (Mistral ya no ofrece trabajos de fine-tuning por API) y no administra el espacio de trabajo.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Mistral AI.

Herramientas disponibles

Ejemplos de prompts

• "Lee el PDF de este enlace con Mistral OCR y dame la tabla de precios de la página 3 en Markdown."
• "Pregunta a Mistral con búsqueda web qué ha cambiado este año en el calendario de la Ley de IA de la UE, y enumera las fuentes."
• "Revisa estas tres reseñas de clientes con la moderación de Mistral y dime cuáles se marcan y por qué."
• "¿Qué trabajos batch de Mistral siguen en marcha y cuántas solicitudes han terminado ya?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT