Conectar Groq MCP con Microsoft Copilot

💡 ¿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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Groq.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse