Cómo conectar Freepik a Gemini — via MCP

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

Freepik + Gemini

Contenido de stock e imágenes con IA de Freepik a través de la API de Freepik, que ahora funciona como Magnific API: busca y descarga fotos, vectores y PSD, busca y descarga iconos, busca vídeos de stock y genera imágenes con Mystic.

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:

FREEPIK_API_KEY

Paso 1 — Obtener credenciales

La API de Freepik se publica ahora como Magnific API (https://api.magnific.com, documentación en docs.magnific.com). El catálogo de stock sigue siendo el de Freepik, y las claves de API de Freepik existentes siguen funcionando.

1. En magnific.com, abre tu cuenta, luego Organization → API keys, y crea una clave.
2. Pégala en FREEPIK_API_KEY. El conector la envía en la cabecera x-magnific-api-key. No hay OAuth; la clave es un secreto del lado del servidor.
3. Empieza con freepik_search_resources (fotos, vectores, PSD), freepik_search_icons o freepik_search_videos, y comprueba la licencia y los formatos con freepik_get_resource antes de descargar.

Créditos: la API se factura en créditos. Las búsquedas y los detalles cuestan poco. Cada llamada a freepik_download_resource, freepik_download_resource_format y freepik_download_icon registra una descarga en la cuenta, y freepik_generate_image_mystic gasta créditos de IA. Estas herramientas están marcadas como escrituras, así que el cliente de IA pide confirmación antes de llamarlas. Un 402 significa que la cuenta se ha quedado sin créditos.

Licencias: los recursos freemium requieren atribución a Freepik o al autor, salvo que la cuenta tenga un plan premium; los recursos premium requieren un plan que los incluya. Revisa licenses[].type antes de usar un recurso con fines comerciales. Las URL de descarga caducan al poco tiempo, así que descarga el archivo enseguida.

Límites: 10 solicitudes por segundo de media en dos minutos y 50 por segundo por IP en una ventana de 5 segundos. La generación con Mystic es asíncrona: consulta freepik_get_mystic_task hasta que status sea COMPLETED.

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

Herramientas disponibles

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