Servidor MCP para Cline: genera imágenes desde tu editor

Un servidor MCP remoto en Cline es un conjunto de herramientas alojadas que el agente invoca a través de HTTP: agregas un único bloque a la configuración JSON de MCP y Cline adquiere capacidades que ningún modelo de lenguaje tiene por sí solo. Generar un archivo de imagen es el ejemplo más claro. Cline refactoriza tus componentes, ejecuta las pruebas y escribe la migración, pero se detiene en seco al llegar a «y aquí es donde va la foto del producto».

La configuración completa para los impacientes. Crea una clave en tu perfil de BananaBanana, abre la configuración MCP de Cline y añade:

{
  "mcpServers": {
    "bananabanana": {
      "type": "streamableHttp",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": ["list_models", "get_account", "get_result"]
    }
  }
}

Aparecerán diez herramientas. Las imágenes se cobran desde $0.03 cada una contra un saldo prepago, y el video desde $0.10. La línea type no es opcional, y la razón es un fallo especialmente molesto que explicaré más adelante.

¿Por qué añadir un generador de imágenes a Cline?

Toda la dinámica de Cline se basa en «describir el resultado y dejar que el agente haga las iteraciones». Esto funciona perfecto hasta que el resultado incluye una imagen. En ese punto el ciclo se rompe y te toca hacer el trabajo manual: abrir el navegador, escribir el prompt, descargar, renombrar, mover a public/, volver al editor y retomar el hilo. Cinco minutos por recurso, y la interrupción de contexto cuesta más que esos cinco minutos.

Con una herramienta MCP, el agente se encarga de todo el ciclo. Redacta el prompt, llama a generate_image, guarda el archivo terminado en la carpeta que indicaste y actualiza el código. Lo que tú revisas es simplemente un diff.

El modelo económico también encaja a la perfección con la comunidad de Cline. Cline utiliza el enfoque de «trae tu propio modelo», por lo que sus usuarios ya están acostumbrados a pagar por uso en lugar de cuotas mensuales. Los precios de generación funcionan igual. Sin planes, sin suscripciones ni mínimos mensuales. Imágenes desde $0.03, video desde $0.10, a partir de un saldo que recargas cuando lo necesitas.

La alternativa es un servidor MCP local de imágenes, lo que implica ejecutar un proceso Node o Python en tu equipo más tu propia clave de proveedor, con cuotas y facturación en tu cuenta. Un endpoint remoto elimina ambas molestias. La generación ocurre en nuestros servidores mediante el mismo pipeline que el generador web, y tu única credencial es una clave revocable.

¿Cómo añadir un servidor MCP remoto en Cline?

Hay tres vías con el mismo resultado. Los detalles a continuación están verificados con la documentación oficial de Cline MCP al 20 de agosto de 2026.

A través de la interfaz. Haz clic en el icono de MCP Servers en la barra de herramientas del panel de Cline, abre la pestaña Remote Servers, introduce un nombre para el servidor, la URL https://bananabanana.pro/api/mcp y selecciona Streamable HTTP como transporte. Pulsa Add Server. Luego añade el encabezado Authorization: el formulario es la forma más rápida de crearlo, pero la clave reside en el JSON.

Editando el JSON. Mismo icono, pestaña Configure, y botón Configure MCP Servers para abrir el archivo de configuración de la extensión. Se encuentra en el almacenamiento global de VS Code, bajo la carpeta saoudrizwan.claude-dev (el ID de la extensión conserva el nombre del autor original, lo que suele confundir a quienes buscan una carpeta llamada «cline»). En la CLI la ruta es simplemente ~/.cline/mcp.json, y cline mcp abre un asistente interactivo con los mismos campos.

Desde la terminal. El comando cline config mcp --json muestra la configuración cargada actualmente, que es la forma más rápida de confirmar que tus cambios se aplicaron.

Sea cual sea la vía que elijas, el endpoint es https://bananabanana.pro/api/mcp. No /mcp, que es la página de documentación para humanos y devuelve HTML a cualquier petición POST. Nuestra página de documentación de MCP mantiene el snippet genérico y la tabla de compatibilidad de clientes verificados:

Haz una prueba de humo gratuita antes de gastar saldo. get_account devuelve tu saldo, el nombre de la clave y su límite diario; list_models muestra todos los modelos disponibles con sus precios actuales. Ninguno de los dos cobra nada y ambos validan la autenticación en un segundo.

Caso práctico: lote de marcadores de catálogo en modo Act

Aquí es donde Cline demuestra su verdadero valor, y es una tarea muy distinta a «generar una sola imagen para el hero». Primero el modo Plan: describes el catálogo, doce productos que necesitan una foto de marcador con un estilo visual coherente, y dejas que Cline planifique el ciclo antes de modificar archivos. Luego el modo Act lo ejecuta.

El estilo visual es una cláusula fija que se reutiliza en cada llamada, cambiando únicamente el objeto principal. La consistencia entre elementos proviene de la parte invariable del prompt, no de que el modelo recuerde lo que hizo un minuto antes:

→ generate_image {"prompt": "A photorealistic overhead product shot of a
   small monstera in a matte terracotta pot on a pale linen backdrop, soft
   diffused window light from the left, 50mm lens, subtle natural shadow,
   generous empty space around the subject, no text",
   "model": "nano-banana-pro", "aspect_ratio": "4:5"}
← {"job_id": "…", "status": "processing", "cost_charged_usd": 0.11,
   "balance_remaining_usd": 1110.65}

Segundo producto, misma cláusula de estilo, planta y ángulo distintos:

Doce imágenes como estas en Nano Banana Pro cuestan $1.32. En el modelo estándar nano-banana-2-lite son $0.36, y para marcadores provisionales que luego reemplazará un diseñador, es la opción que yo elegiría; nuestra guía de Lite detalla dónde este modelo económico empieza a quedarse corto. En este artículo utilicé Pro porque ambos ejemplos se muestran a tamaño completo.

La generación por lotes es justo la situación donde necesitas medidas de seguridad. Tienes dos disponibles. Cada clave MCP admite un límite diario en dólares en Perfil → MCP API Keys, de modo que si un bucle falla, el gasto se detiene en la cifra que fijaste y no vacía tu saldo. Además, las solicitudes de múltiples imágenes (number_of_images mayor a 1) funcionan como el video: la primera llamada devuelve un presupuesto y no cobra nada hasta que el agente la repite con confirm_cost.

El video funciona desde el mismo chat y con la misma regla de confirmación. Un clip mudo de 4 segundos en 720p con Veo 3.1 Lite parte de $0.10, y Omni Flash cuesta $0.10 por segundo siempre con audio, sumando $0.30 por un clip de 3 segundos. El renderizado tarda entre 1 y 10 minutos, y como generate_video devuelve un ID de tarea al instante, Cline sigue trabajando en tu código y consulta get_result cuando termina.

Particularidades de Cline que conviene conocer antes de empezar

Cinco detalles técnicos, ordenados según la cantidad de tiempo que pueden ahorrarte.

1. "type": "streamableHttp" debe escribirse exactamente así; omitirlo causa un error silencioso. La documentación es tajante: si se omite el campo, se recurre por defecto al transporte heredado sse por compatibilidad. SSE heredado implica que el cliente abre una conexión GET esperando un flujo de eventos. Nuestro endpoint utiliza Streamable HTTP sin estado, por lo que una petición GET recibe un 405 Method Not Allowed (lo volví a comprobar al redactar esto: curl -i https://bananabanana.pro/api/mcp devuelve 405). En Cline esto se traduce en un servidor que no conecta con un mensaje de error que no menciona el campo faltante. Escribir streamable-http con guion falla igual.

2. La clave se almacena en texto plano en el archivo de configuración. La documentación de Cline sugiere usar variables de entorno, pero la interpolación de variables dentro del objeto headers en servidores remotos no está documentada, a diferencia de ${env:…} en Cursor o ${file:…} en Windsurf. La ventaja es su ubicación: el archivo de la extensión reside en el almacenamiento global de VS Code y no en tu repositorio, por lo que no hay riesgo real de subirlo por error a git. Aun así, trátalo como un secreto: define un límite diario y revoca la clave desde el perfil si dejas de usar ese equipo.

3. Auto Approve es menos granular de lo que parece. En el panel de Auto Approve de Cline, «Use MCP servers» es un único interruptor para todas las herramientas MCP, por lo que activarlo autoriza tanto las gratuitas como las de pago. El control individual por herramienta se gestiona en la configuración mediante el array autoApprove. Mi lista permitida incluye las tres consultas gratuitas (list_models, get_account, get_result), lo que elimina la fatiga de confirmaciones en tareas por lotes mientras cada renderizado de pago sigue pidiendo aprobación.

4. El modo YOLO junto con herramientas de pago requiere precaución. El modo YOLO de Cline autoaprueba cualquier acción: cambios en archivos, comandos de terminal, navegación web y herramientas MCP. La documentación lo cataloga como peligroso por buenas razones. Nuestro paso de confirmación de costos no te protegerá aquí, ya que un agente totalmente autónomo aprobará ambas partes del flujo de confirmación. Lo que sí te protege es el límite diario por clave. Configúralo antes de activar YOLO, no después.

5. No hay instalación desde catálogo y los entornos empresariales tienen su propia vía. La extensión de VS Code basada en el SDK oficial ya no incluye la interfaz de exploración del MCP Marketplace, por lo que la configuración manual del JSON es la vía común. Los administradores disponen de otro mecanismo: remoteMCPServers en la configuración remota de la organización despliega el servidor a todos los usuarios, y blockPersonalRemoteMCPServers impide añadir servidores personales. Si lo implementas en un equipo, configúralo de forma centralizada y asigna a cada desarrollador su propia clave.

Una limitación honesta de nuestro lado: generate_speech devuelve un enlace firmado a un archivo WAV en lugar de un reproductor integrado en el panel de Cline, por lo que para escuchar el audio hay que abrir el archivo. Las imágenes, en cambio, muestran una vista previa junto a la URL. Cline añadió soporte para imágenes en los resultados de herramientas en 2025, por lo que en cualquier versión actual la vista previa se renderiza correctamente.

¿Admite Cline autenticación OAuth en servidores MCP remotos?

De forma documentada no, y conviene aclararlo porque la situación varía según el cliente. La documentación de Cline cubre stdio, SSE y Streamable HTTP, describiendo la autenticación mediante encabezados personalizados. OAuth no está soportado. Hay una solicitud abierta para soporte de OAuth en el repositorio de Cline desde agosto de 2025 que sigue abierta a fecha de 20 de agosto de 2026.

En la práctica esto no supone ningún inconveniente. Nuestro servidor admite tanto tokens OAuth 2.1 como claves de API Bearer, y este último formato es para el que está diseñado Cline. Es además la vía que recomiendo: las claves son gratuitas, puedes crear varias y cada una mantiene su propio registro de uso (herramienta, modelo, costo y vista previa del prompt) junto con el límite diario. Cuando un colaborador termina su contrato, revocas su clave y nadie más se ve afectado.

Si quieres aislar proyectos, genera una clave por cada uno en lugar de compartir una sola. Así el registro de uso te mostrará exactamente cuánto costó el trabajo del panel interno frente a la web pública, algo muy útil al momento de facturar.

¿Cuánto costaron las imágenes de demostración de este artículo?

Precios habituales por generación, exactamente los mismos que list_models reporta al agente:

Detalle útil si vas a recargar saldo: los depósitos a partir de $50 añaden un 5% extra, a partir de $100 un 10%, y un código promocional activo suma otro 10% adicional. Ambos bonos se calculan sobre la base del depósito, por lo que $100 con código acreditan $120.

La misma clave sirve en cualquier otro cliente: si utilizas Cursor o VS Code, no necesitas crear nada nuevo: mismo saldo, mismo historial y un solo endpoint. La guía de Cursor y la configuración de VS Code explican cómo usarlos. Crea una clave y pídele a Cline tu primer lote de imágenes.

FAQ

¿Admite Cline servidores MCP remotos mediante Streamable HTTP?

Sí, y es el transporte recomendado en la propia documentación de Cline. Un servidor remoto se define con una url, un type fijado en streamableHttp y un objeto opcional headers para autenticación, manteniéndose SSE solo por compatibilidad. Indica siempre el type de forma explícita: omitirlo recurre a SSE y fallará contra un endpoint moderno sin estado. Verificado con la documentación oficial al 20 de agosto de 2026.

¿Dónde está el archivo de configuración MCP de Cline?

En dos ubicaciones según cómo lo ejecutes. La extensión de VS Code lo guarda en el almacenamiento global del editor, dentro de la carpeta con el ID de la extensión saoudrizwan.claude-dev; la forma más segura de abrirlo es con el botón Configure MCP Servers en la pestaña Configure del panel MCP. La CLI utiliza ~/.cline/mcp.json. Ambas admiten la misma estructura de objeto mcpServers.

¿Necesito una cuenta propia de servicios en la nube para generar imágenes en Cline?

No. Un servidor MCP local requiere una clave de proveedor externo con cuotas y facturación en su plataforma. El servidor remoto procesa las generaciones en nuestra infraestructura, por lo que la única credencial requerida es la clave bb_live_ de tu perfil. Las cuentas nuevas reciben $0.20 de saldo inicial, suficiente para seis imágenes en el modelo básico antes de realizar cualquier pago.

¿Cómo evito que un agente gaste demasiado saldo?

Aplica los tres controles disponibles. Limita autoApprove a las herramientas gratuitas para que cada renderizado solicite confirmación. Establece un límite diario en dólares en Perfil → MCP API Keys, que es el único mecanismo que sigue operativo si activas el modo YOLO. Y aprovecha la confirmación de costo: las llamadas de video y de múltiples imágenes devuelven un presupuesto inicial y no cobran nada hasta que el agente repite la petición con el parámetro confirm_cost.

¿Por qué mi servidor MCP de Cline no se conecta?

Comprueba estos puntos por orden. Verifica que "type": "streamableHttp" esté presente y escrito exactamente en camelCase, ya que de lo contrario Cline intentará conectar por SSE y el endpoint responderá 405 al GET. Asegúrate de que la URL termine en /api/mcp y no en /mcp. Comprueba que el encabezado de autorización sea exactamente Bearer bb_live_... sin espacios adicionales (una clave incorrecta o revocada devuelve 401). Si conecta pero no muestra herramientas, reinicia el servidor desde el panel MCP. En redes corporativas, comprueba si los servidores remotos personales están bloqueados por políticas internas.