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

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

Stability AI + Gemini

Crea y edita imágenes con Stability AI: genera imágenes con Stable Image Ultra, Core y Stable Diffusion 3.5, aumenta la resolución, elimina o sustituye fondos, borra objetos, repinta zonas, amplía la imagen, busca y reemplaza objetos, guía la generación con bocetos, estructura y referencias de estilo, y crea música con Stable Audio 3. Las imágenes vuelven como imágenes; también lee el saldo de créditos. De pago por generación en créditos.

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:

STABILITY_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una cuenta de Stability AI con créditos; las cuentas nuevas reciben 25 créditos gratis.

1. Crea una cuenta en https://platform.stability.ai y compra créditos en Billing si hace falta.
2. Abre API keys (https://platform.stability.ai/dashboard/api-keys), copia una clave (empieza por sk-) y pégala en STABILITY_API_KEY. Se envía como Authorization: Bearer.
3. Instala el conector y ejecuta stability_ai_get_balance: muestra el saldo de créditos y confirma la clave. La clave actúa por la organización predeterminada de su usuario, y los créditos se descuentan de esa organización.

Costes: 1 crédito = 0,01 $, y las generaciones fallidas son gratis. Cada herramienta de generación, edición, escalado y audio cuesta créditos:

• Crear a partir de texto: stability_ai_generate_image_core 3, stability_ai_generate_image_ultra 8, stability_ai_generate_image_sd3 6,5 (sd3.5-large), 4 (sd3.5-large-turbo, el predeterminado aquí), 3,5 (sd3.5-medium) o 2,5 (sd3.5-flash).
• Escalar: stability_ai_upscale_fast 2, stability_ai_upscale_conservative 40, stability_ai_upscale_creative 60.
• Editar: stability_ai_erase, stability_ai_inpaint, stability_ai_search_and_replace, stability_ai_search_and_recolor y stability_ai_remove_background 5 cada una, stability_ai_outpaint 4, stability_ai_replace_background_and_relight 8.
• Guiar con una imagen: stability_ai_control_sketch, stability_ai_control_structure y stability_ai_control_style 5 cada una, stability_ai_control_style_transfer 8.
• Audio: stability_ai_generate_audio 8.

Gratis: stability_ai_get_balance, stability_ai_get_account, stability_ai_list_engines, stability_ai_get_result y stability_ai_get_audio_result. Antes de cada llamada de pago la IA te dice el coste y espera tu sí; en caso de duda consulta primero el saldo.

Qué crea y edita:

• Imágenes a partir de texto: Core es rápido y la opción predeterminada más barata; Ultra da la mejor calidad y fotorrealismo (alrededor de 1 megapíxel) y también puede partir de una imagen con strength; Stable Diffusion 3.5 ofrece Large, Large Turbo, Medium y Flash, también de imagen a imagen con mode, image_url y strength. Proporciones de 21:9 a 9:21.
• Más resolución: el escalador rápido amplía 4 veces sin reinterpretar la imagen, el conservador llega a unos 4 megapíxeles y se mantiene fiel, el creativo llega hasta 4K y añade detalle guiado por un prompt.
• Ediciones: quitar el fondo (PNG o WebP transparente), borrar objetos o imperfecciones con una máscara, repintar una zona enmascarada (inpainting), ampliar el lienzo en cualquier dirección (outpainting), encontrar un objeto por su descripción y reemplazarlo o cambiarle el color sin máscara, y poner un sujeto sobre un fondo nuevo con la luz ajustada.
• Generación guiada: convertir un boceto en una imagen terminada, mantener la estructura de una imagen de entrada, copiar el estilo de una referencia o transferir el estilo de una imagen a otra.
• Música y efectos de sonido con Stable Audio 3, de 1 a 380 segundos, en MP3 o WAV.
• La cuenta: saldo de créditos, el usuario con sus organizaciones y los motores v1 antiguos (SDXL y anteriores; los servicios actuales no aparecen ahí).

Imágenes de entrada: cada parámetro *_url es un enlace https público a un archivo JPEG, PNG o WebP de hasta 10 MB. AnythingMCP lo descarga y lo sube a Stability AI como archivo, así que una imagen que solo pegaste en el chat tiene que publicarse antes en línea. En una máscara, el blanco marca la zona que se cambia; sin máscara se usan las zonas transparentes de la imagen.

Trabajos asíncronos: stability_ai_upscale_creative, stability_ai_replace_background_and_relight y stability_ai_generate_audio devuelven al momento un id de 64 caracteres. La IA llama con él a stability_ai_get_result (imágenes) o stability_ai_get_audio_result (audio) tras unos 10 segundos, y de nuevo mientras status sea in-progress. Los resultados quedan disponibles 24 horas y solo para la misma clave.

Formatos de datos: las imágenes terminadas se adjuntan al resultado de la herramienta como imágenes visibles, y el audio como archivo. Las herramientas de imagen también devuelven finish_reason y seed; la misma semilla con el mismo prompt reproduce una imagen. Las imágenes son JPEG por defecto para que pesen poco; pide png o webp cuando necesites transparencia. Los prompts funcionan mejor en inglés y describen sujeto, entorno, estilo, colores e iluminación; lo que hay que evitar va en negative_prompt, y style_preset (photographic, cinematic, anime, digital-art, 3d-model, ...) orienta el aspecto.

Paginación: no hay nada que paginar. Cada llamada devuelve una imagen, un trabajo de audio o un registro de la cuenta.

Desactivadas al instalar: ninguna herramienta. Todas están activas; las de pago quedan protegidas por la confirmación del coste.

Límites: 150 peticiones en 10 segundos; por encima, las peticiones se bloquean durante 60 segundos. Los prompts admiten hasta 10.000 caracteres.

Errores comunes: 400 enumera los parámetros incorrectos en errors. 401 significa una clave no válida. 402, créditos insuficientes. 403, que la moderación de contenido marcó el prompt o la imagen. 413, una subida demasiado grande. 422, que la entrada no se puede procesar, por ejemplo un tamaño de imagen fuera de rango o un idioma no compatible. 429 es el límite de frecuencia. finish_reason CONTENT_FILTERED significa que el resultado incumplía la política de contenido y se difuminó: reformula el prompt. Cada error trae un id para citar al soporte de Stability.

El conector no genera modelos 3D (Stable Fast 3D, SPAR3D), no hace audio a audio ni inpainting de audio, y no usa los endpoints de Stable Audio 2 ni la antigua generación SDXL v1.

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 Stability AI.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos créditos de Stability AI quedan en la cuenta?"
• "Crea con Stable Image Ultra una imagen fotorrealista de un faro en una costa rocosa al atardecer en 16:9. Dime antes el coste."
• "Quita el fondo de https://example.com/product.jpg y dame un PNG transparente."
• "En https://example.com/street.jpg, sustituye el coche rojo por una bicicleta azul."
• "Haz una pista lo-fi de piano tranquila de 30 segundos a 80 BPM para la intro de un podcast."

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