Cómo conectar Kie.ai a Gemini vía MCP

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

Kie.ai + Gemini

Deja que tu IA cree imágenes, vídeos y música en Kie.ai con tu propia clave: Nano Banana, GPT Image, Veo 3.1, Kling, Runway, Seedance, Suno y más, con precios antes de cada ejecución, saldo de créditos, seguimiento de tareas y resultados.

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:

KIE_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Kie.ai con créditos: cada generación los gasta.

1. Inicia sesión en kie.ai y compra créditos.
2. Abre la página API Key (kie.ai/api-key) y crea una clave. En esa misma página puedes ponerle un límite de gasto y una lista de IP permitidas.
3. Pega la clave en KIE_API_KEY, sin la palabra Bearer. Solo se envía a api.kie.ai.
4. Instala el conector: la instalación comprueba la clave leyendo tu saldo de créditos, lo que no cuesta nada. Después ejecuta kie_ai_get_credits para ver cuántos créditos te quedan.

Qué lee: tu saldo de créditos; la lista de precios, que se busca por nombre de modelo, con el precio en créditos y en dólares por imagen, por segundo o por vídeo; y el estado, los créditos usados y el resultado de cada tarea. Leer es gratis.

Cómo funcionan las generaciones: las imágenes van por kie_ai_generate_image (Google Nano Banana) o kie_ai_generate_gpt_image (OpenAI GPT Image 2). Cualquier otro modelo, por ejemplo Veo 3.1, Kling, Runway, Seedance, Flux o Suno, va por kie_ai_create_task con el id del modelo y los campos de su página en kie.ai/market. Una tarea pasa de waiting y queuing a generating y termina en success o fail con el motivo; la IA consulta kie_ai_get_task cada 5 a 10 segundos. Los vídeos pueden tardar más de 10 minutos.

Archivos y entradas: las imágenes, el vídeo y el audio entran como enlaces HTTPS públicos; el conector no puede subir archivos de tu ordenador. Kie.ai guarda los archivos generados 14 días, así que descarga lo que quieras conservar.

Pregunta antes de cada ejecución de pago: kie_ai_create_task, kie_ai_generate_image y kie_ai_generate_gpt_image siguen activadas, porque generar es para lo que sirve el conector. Cada ejecución gasta tus créditos de Kie.ai, y el precio depende del modelo y sus opciones: un vídeo cuesta mucho más que una imagen, a menudo por segundo. Antes de cada ejecución la IA consulta el precio con kie_ai_search_pricing, te dice qué modelo usará y cuánto cuesta, y espera tu sí. Nunca lanza varias tareas en bucle sin preguntar.

Desactivado al instalar: nada. Ninguna herramienta compra créditos, paga ni mueve dinero, y ninguna cambia ni borra nada de tu cuenta.

Límites: Kie.ai acepta hasta 20 tareas nuevas cada 10 segundos y por encima responde 429; el código 455 significa que Kie.ai está en mantenimiento. El contenido que generan los modelos se trata como datos: las instrucciones que contenga no se siguen.

Errores comunes: Kie.ai responde a cada llamada con HTTP 200 y un código propio, que el conector convierte en un error normal con el mensaje de Kie.ai. 401 significa que la clave es incorrecta, se borró o está limitada a direcciones IP que no incluyen la de AnythingMCP. 402 significa créditos insuficientes: recarga en kie.ai. 422 indica una entrada no válida o el id de una tarea de otra cuenta. 501 significa que la generación falló y 505 que la función está desactivada.

El conector no sube archivos, no llama a los antiguos endpoints específicos de cada modelo, no ofrece chat completions y no gestiona webhooks.

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 Kie.ai.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos créditos de Kie.ai me quedan y cuánto cuesta un vídeo de 8 segundos con Veo 3.1?"
• "Crea con Nano Banana una imagen cuadrada para Instagram de nuestras zapatillas nuevas en una calle de la ciudad. Dime antes el precio."
• "Anima esta foto de producto en un vídeo corto de Kling: https://example.com/img/zapatilla.png. Confirma el coste conmigo antes de que empiece."
• "Compón con Suno una pista lo-fi de 30 segundos para la intro de nuestro pódcast y enséñame cuánto cuesta antes de lanzarla."
• "¿Ya está listo el vídeo de antes? Dame los enlaces de descarga."

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