Conectar Groq MCP con Gemini CLI

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

Groq + Gemini

GroqCloud con tu propia clave API: chat completions rápidas con modelos abiertos como Llama, GPT-OSS y Qwen, transcripción y traducción al inglés de archivos de audio desde un enlace público con Whisper, y los modelos, trabajos batch y archivos de la organización.

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:

GROQ_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de GroqCloud; el plan gratuito funciona dentro de sus límites de frecuencia.

1. Inicia sesión en https://console.groq.com y abre API Keys (https://console.groq.com/keys).
2. Haz clic en Create API Key, ponle un nombre y cópiala. Empieza por gsk_ y Groq la muestra una sola vez.
3. Pégala en GROQ_API_KEY, sin la palabra Bearer. El conector la envía como Authorization: Bearer y solo a Groq.
4. Instala el conector y ejecuta groq_list_models: lista los modelos que la clave puede usar y confirma la clave.

Qué herramientas cuestan dinero: groq_chat_completion, groq_transcribe_audio y groq_translate_audio ejecutan un modelo. En el plan gratuito no cuestan nada pero están limitadas; en el plan Developer cada llamada se factura a la organización: el texto por token de entrada y salida, Whisper por hora de audio con un mínimo de 10 segundos por petición. La IA te pregunta antes de llamadas grandes o repetidas y fija max_completion_tokens para limitar la respuesta. groq_list_models, groq_get_model, groq_list_batches, groq_get_batch, groq_list_files y groq_get_file son gratuitas.

Modelos: groq_list_models muestra cada modelo que la clave puede usar con propietario, context_window, max_completion_tokens y si está activo; groq_get_model lee uno y responde 404 si la clave no puede usarlo. Los ids cambian a menudo: los modelos preview pueden desaparecer con poco aviso, los de producción son estables. Ids habituales son llama-3.3-70b-versatile, llama-3.1-8b-instant (el más barato), openai/gpt-oss-120b, openai/gpt-oss-20b y qwen/qwen3.8-27b; para audio whisper-large-v3-turbo (más barato) y whisper-large-v3.

Texto: groq_chat_completion recibe model y messages y devuelve la respuesta completa de una vez (sin streaming). response_format pide JSON o un esquema JSON, tools añade function calling, y reasoning_effort y reasoning_format ajustan los modelos de razonamiento (GPT-OSS acepta low, medium o high; Qwen acepta none o default).

Audio: groq_transcribe_audio transcribe la voz en su propio idioma, groq_translate_audio la convierte en texto en inglés (solo whisper-large-v3 traduce). Ambas reciben un enlace público en url: Groq descarga el archivo por sí mismo, así que no se sube nada. Formatos: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm. Indicar language (ISO-639-1, por ejemplo es) lo hace más rápido y preciso. response_format verbose_json añade segmentos con marcas de tiempo, timestamp_granularities word los tiempos de cada palabra.

Trabajos batch y archivos: groq_list_batches y groq_get_batch muestran los batches iniciados en otro lugar con su estado (validating, in_progress, finalizing, completed, failed, expired, cancelling, cancelled), el número de peticiones y output_file_id y error_file_id. groq_list_files y groq_get_file muestran nombre de archivo, tamaño en bytes, propósito (batch o batch_output) y fecha de creación, no el contenido.

Formatos de datos: una completion devuelve choices[0].message.content, finish_reason (stop, length cuando se alcanzó max_completion_tokens, tool_calls) y usage con recuentos de tokens y tiempos en segundos; los modelos de razonamiento pueden poner su razonamiento en choices[0].message.reasoning. El resultado también trae _headers con las peticiones y tokens que quedan en el límite. Una transcripción devuelve text. Marcas como created son segundos Unix, en UTC.

Paginación: las herramientas de listado no tienen parámetros de página; devuelven lo que Groq envía en una sola respuesta.

Desactivadas al instalar: ninguna. Las 9 herramientas están activas y ninguna borra nada.

Límites: los límites de frecuencia se aplican por organización y modelo, como peticiones y tokens por minuto y por día (https://console.groq.com/settings/limits). Los enlaces de audio pueden apuntar a archivos de hasta 25 MB en el plan gratuito y de hasta 100 MB en los planes de pago.

Errores comunes: 400 indica un parámetro que el modelo no admite o un audio ilegible; 401 una clave errónea o borrada; 403 que el proyecto no puede usar ese modelo; 404 un modelo, batch o archivo desconocido; 413 un archivo de audio demasiado grande; 429 el límite de frecuencia alcanzado (la IA espera los segundos de retry-after en lugar de reintentar en bucle); 498 sin capacidad en el tier flex; 500 y 503 son problemas de Groq, reintenta una vez más tarde.

El conector no transmite respuestas en streaming, no sube ni descarga el contenido de archivos y no crea ni cancela trabajos batch.

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

Herramientas disponibles

Ejemplos de prompts

• "¿Qué modelos de Groq puede usar ahora mi clave y cuál es la ventana de contexto de cada uno?"
• "Resume este correo de soporte en tres puntos con llama-3.1-8b-instant y quédate por debajo de 200 tokens."
• "Transcribe el episodio del podcast en alemán de https://example.com/audio/episode-12.mp3 con marcas de tiempo por segmento."
• "Traduce a texto en inglés el mensaje de voz en italiano de https://example.com/voice/note.m4a."
• "Muéstrame el estado de mis trabajos batch de Groq y cuántas peticiones fallaron en el último."

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