Clipia MCP

Servidor MCP remoto alojado para generación de imágenes y video con IA desde un único endpoint HTTP Streamable.

Documentación

Clipia MCP

Crea imágenes, video, voz, música y presentaciones con IA dentro de Claude, Cursor y ChatGPT: más de 60 modelos en un solo endpoint MCP.

Clipia es una plataforma de creación con IA. Este servidor remoto alojado de Protocolo de Contexto de Modelos (MCP) permite que cualquier agente compatible con MCP genere imágenes, video, voz y música; converse con modelos de texto; planifique y componga videos; cree y edite presentaciones; consulte resultados; explore modelos; busque plantillas de prompts; y lea su saldo de créditos, sin SDK ni código requerido.

Endpoint: https://mcp.clipia.ai/mcp — HTTP Streamable sin estado, autenticado con una clave API de Clipia.

Inicio rápido

Conecta Clipia a Claude Code con un solo comando (reemplaza el marcador de posición con tu clave):

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Luego solo pregunta en el chat: "Genera una imagen de ciudad neón con Clipia" — la vista previa aparece directamente en la terminal.

Dónde obtener una clave: crea una en la Consola de Desarrollador de Clipia. La clave se muestra una sola vez.

Sandbox sin cargos: las claves con el prefijo clipia_test_ funcionan en un sandbox: resultados simulados instantáneos, sin gastar créditos. Usa una clave clipia_test_* para validar tu integración antes de salir a producción.

Conéctate desde cualquier cliente

El endpoint es el mismo en todas partes: https://mcp.clipia.ai/mcp. Los IDE y CLI se autentican con una clave API de la Consola de Desarrollador; claude.ai y ChatGPT se conectan iniciando sesión en tu cuenta de Clipia mediante OAuth (sin necesidad de clave).

Las configuraciones listas para pegar están en examples/.

Cliente	Cómo conectarse	Autenticación
Claude Code	`claude mcp add --transport http clipia …` (ver Inicio rápido)	Clave API
Claude Desktop	Puente `mcp-remote` en `claude_desktop_config.json`	Clave API
claude.ai (web/escritorio/móvil)	Configuración → Conectores → Añadir conector personalizado	OAuth
Cursor	`~/.cursor/mcp.json` (o `.cursor/mcp.json` del proyecto)	Clave API
VS Code	`.vscode/mcp.json` (`servers` + `inputs`)	Clave API
Cline	`cline_mcp_settings.json` (`mcpServers`)	Clave API
Windsurf	`~/.codeium/windsurf/mcp_config.json` (`serverUrl`)	Clave API
Codex CLI	`~/.codex/config.toml` (`bearer_token_env_var`)	Clave API (env)
Gemini CLI	`gemini mcp add --transport http clipia …`	Clave API
ChatGPT	Modo desarrollador → Apps y conectores → Crear	OAuth

Claude Code

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Claude Desktop

Claude Desktop se conecta a servidores HTTP remotos a través de mcp-remote. Añade a claude_desktop_config.json (Configuración → Desarrollador → Editar configuración) y luego reinicia Claude Desktop:

{
  "mcpServers": {
    "clipia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.clipia.ai/mcp",
        "--header",
        "Authorization: Bearer <CLIPIA_API_KEY>"
      ]
    }
  }
}

claude.ai (web / escritorio / móvil)

Abre Configuración → Conectores.
Haz clic en Añadir conector personalizado y pega la URL: https://mcp.clipia.ai/mcp
Haz clic en Conectar e inicia sesión en tu cuenta de Clipia: no se necesita clave (OAuth).
En un nuevo chat, pide una imagen o un video: aparece una tarjeta Clipia en vivo con el progreso y el resultado dentro del mensaje.

Los créditos se cargan a la cuenta de Clipia conectada.

Cursor

Añade a ~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto) y luego reinicia Cursor:

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

VS Code

Crea .vscode/mcp.json en tu espacio de trabajo (o usa el comando MCP: Añadir servidor). VS Code solicita la clave en el primer uso y la almacena de forma segura:

{
  "servers": {
    "clipia": {
      "type": "http",
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:clipia_api_key}" }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "clipia_api_key",
      "description": "Clipia API Key",
      "password": true
    }
  ]
}

Cline

Cline lee mcpServers desde su cline_mcp_settings.json (Servidores MCP → Configurar servidores MCP en el panel de Cline):

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

Cline también puede instalar este servidor por sí mismo: consulta llms-install.md.

Windsurf

Añade a ~/.codeium/windsurf/mcp_config.json (nota el campo serverUrl específico de Windsurf) y luego actualiza Cascade → MCPs:

{
  "mcpServers": {
    "clipia": {
      "serverUrl": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

Codex CLI

Añade un bloque a ~/.codex/config.toml y exporta la clave a tu entorno: Codex inyecta Authorization: Bearer desde la variable automáticamente:

# ~/.codex/config.toml
[mcp_servers.clipia]
url = "https://mcp.clipia.ai/mcp"
bearer_token_env_var = "CLIPIA_API_KEY"

# in your environment:
# export CLIPIA_API_KEY=<CLIPIA_API_KEY>

Gemini CLI

gemini mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Verifica la conexión con gemini mcp list.

ChatGPT (Modo desarrollador)

En ChatGPT (web): Configuración → Apps y conectores → Configuración avanzada → activa Modo desarrollador (Plus, Pro, Business, Enterprise).
Vuelve a Apps y conectores → Crear. Nómbralo Clipia, URL del servidor MCP: https://mcp.clipia.ai/mcp.
Autenticación: OAuth, marca "Confío en esta aplicación", haz clic en Crear.
Inicia sesión en tu cuenta de Clipia en la ventana emergente. En un chat, presiona + → Más → Clipia y luego pregunta en texto plano.

Esquemas de encabezado de autenticación compatibles: Authorization: Bearer clipia_* (recomendado), Authorization: Key <key> o X-Api-Key: <key>.

Herramientas

El servidor siempre expone 10 herramientas principales al agente. A partir del 26 de julio de 2026, producción expone 15 herramientas de agente: las 10 principales más chat, planificación de escenarios, composición de video del lado del servidor, generación de presentaciones y edición de presentaciones. Siete ayudantes solo de aplicación están ocultos para el agente de IA. Los esquemas compactos mantienen ligera la ventana de contexto del agente.

Herramienta	Qué hace
`generate_image`	Genera imagen(es) a partir de un prompt de texto, opcionalmente con imágenes de referencia (edición / imagen a imagen). Espera brevemente y normalmente devuelve la imagen terminada en línea (URL + vista previa pequeña). Se devuelve el costo en créditos.
`generate_video`	Inicia una generación de video a partir de un prompt de texto (texto a video) o de una imagen inicial (imagen a video, pasa `image_url`). Devuelve `request_id` y el costo en créditos de inmediato: los renders tardan 1–10 min, consulta con `wait_generation`.
`generate_audio`	Genera voz a partir de texto con una voz e idioma seleccionados. Devuelve un MP3 cuando termina.
`generate_music`	Genera música de fondo o una banda sonora a partir de una descripción de ambiente, género y tempo.
`wait_generation`	Espera a que una generación termine (long-poll hasta `wait_seconds`, luego devuelve el estado actual). Llama repetidamente hasta `COMPLETED`, `FAILED` o `CANCELED`. Devuelve URLs de salida (y una vista previa en línea) cuando termina.
`get_generation`	Obtiene el estado/resultado actual de una generación sin esperar. Cuando `COMPLETED`, `output.images[].url` es la vista previa webp en línea y `output.images[].original_url` es el PNG/JPG de calidad completa.
`list_models`	Lista los modelos de IA disponibles con tipo (texto/imagen/video/audio), capacidades y precios en créditos. Los modelos de texto exponen tarifas por 1K de entrada/salida; los modelos de generación exponen un precio base. Filtra por `type` / `search`.
`get_model`	Obtiene detalles del modelo y precios: `input_schema` para modelos de generación; límites de contexto y tarifas por 1K de entrada/salida para modelos de texto.
`get_balance`	Obtiene el saldo de créditos de la cuenta de Clipia conectada y el uso de los últimos 30 días de la clave API actual.
`search_templates`	Busca más de 3500 plantillas de prompts seleccionadas (búsqueda híbrida texto + semántica, consulta en ruso o inglés). Cada resultado tiene un prompt listo para usar y un modelo recomendado.
`chat`	Actualmente habilitado, con restricción de funciones: chatea con un LLM de texto usando un prompt o un array de mensajes; devuelve texto de respuesta, uso de tokens y costo en créditos.
`generate_scenario`	Actualmente habilitado, con restricción de funciones: convierte un brief en prompts de video por escena y un prompt de banda sonora.
`compose_video`	Actualmente habilitado, con restricción de funciones: une 2–20 escenas terminadas en un MP4 final con voz en off, banda sonora y subtítulos opcionales.
`generate_presentation`	Actualmente habilitado, con restricción de funciones: renderiza un PPTX editable, PDF y vistas previas a partir de una especificación de presentación estructurada.
`edit_presentation`	Actualmente habilitado, con restricción de funciones: edita una presentación existente, reordena o reemplaza diapositivas, cambia texto y tema, y reutiliza ilustraciones sin cambios.
`app_get_generation`	Interno / solo aplicación: sondeo de estado usado por la tarjeta de visualización de generación de Clipia (MCP Apps). Oculto del modelo; prefiere `get_generation`.

Modelos predeterminados (usados cuando no se pasa un slug): nano-banana-2 para imágenes, seedance-2-fast-t2v / seedance-2-fast-i2v para video. Anula con un slug de modelo de list_models.

Por qué Clipia

Paga desde Rusia y CEI — tarjetas bancarias rusas, SBP, MIR, sin necesidad de VPN. Los procesadores occidentales rechazan estas; Clipia está construido para este mercado (y también funciona internacionalmente).
Más de 60 modelos insignia, un solo endpoint — modelos occidentales y chinos lado a lado: Veo 3.1, Sora, Kling 3, Seedance 2, Hailuo, Wan 2.7, Nano Banana, FLUX, Midjourney V7, Imagen 4 y más. Sin gestionar múltiples suscripciones extranjeras.
Sandbox sin cargos — las claves clipia_test_* devuelven resultados simulados instantáneos sin gastar créditos, perfecto para configurar una integración o CI.
Vista previa en vivo en el chat (MCP Apps) — en claude.ai (web/escritorio/móvil) cada generación renderiza una tarjeta interactiva con progreso en vivo, el medio terminado y un botón "Original". En Claude Code, la vista previa aparece en línea en la terminal para iteración basada en visión.
Más de 3500 plantillas de prompts — search_templates le da al agente prompts seleccionados y listos para usar (búsqueda híbrida, RU/EN), cada uno con un modelo recomendado.
Costo en cada respuesta — cada generación devuelve su costo exacto en créditos, y get_balance muestra el saldo restante. Sin margen oculto de MCP.
Superficie de herramientas compacta — 10 herramientas principales con esquemas ajustados mantienen ligera la ventana de contexto del agente; las capacidades habilitadas solo añaden las herramientas que necesitan.

SDK

¿Prefieres llamar a Clipia desde tu propio código en lugar de un agente? Usa los SDK oficiales contra la misma API pública (cola estilo fal.ai submit → status → result, facturación basada en créditos):

TypeScript / Node: clipia-ai — npm install clipia-ai (también incluye una CLI clipia).
Python: clipia — pip install clipia (clientes síncronos y asíncronos).

Ambos admiten webhooks con verificación de firma HMAC-SHA256 y las mismas claves de sandbox clipia_test_*.

Entorno de ejecución del servidor Glama

El repositorio incluye un entorno de ejecución Docker mínimo para que Glama pueda iniciar la entrada del servidor público e inspeccionar sus definiciones de herramientas MCP. El contenedor es un puente stdio hacia el endpoint alojado; no contiene la aplicación Clipia ni credenciales.

Configura CLIPIA_API_KEY como secreto en Glama. Usa una clave de sandbox con el prefijo clipia_test_ para que la validación nunca gaste créditos. El ajuste opcional CLIPIA_MCP_URL tiene como valor predeterminado https://mcp.clipia.ai/mcp y solo acepta URLs HTTPS.

docker build -t clipia-mcp-glama .
docker run --rm -i \
  -e CLIPIA_API_KEY='<CLIPIA_TEST_API_KEY>' \
  clipia-mcp-glama

Precios

La facturación se realiza en créditos desde tu cuenta Clipia conectada — el mismo saldo que en el sitio web. Cada generación devuelve su costo exacto en créditos, y get_balance muestra lo que queda. Diferentes modelos cuestan diferentes créditos según la resolución, duración y calidad.

Las cuentas nuevas reciben un pequeño paquete de créditos de bienvenida para evaluar la plataforma; después se requiere una suscripción. Cuatro planes mensuales (Basic / Standard / Pro / Ultima) — consulta clipia.ai/tariffs.

Las claves de sandbox clipia_test_* devuelven resultados simulados sin cargo de créditos — úsalas para desarrollar y probar sin gastar.

🇷🇺 Para Rusia y la CEI

Clipia — plataforma de IA para generar imágenes, videos, voz, música y presentaciones, así como chats de IA de texto y ensamblaje de videos listos. Para usuarios de Rusia y la CEI están disponibles pago con tarjeta rusa, SBP y MIR, sin VPN. Más de 60 modelos occidentales y chinos (Veo 3.1, Sora, Kling 3, Seedance 2, Nano Banana, FLUX, Midjourney V7) funcionan a través de un único endpoint MCP directamente desde Claude, Cursor y ChatGPT.

Conexión en un solo comando (la clave — en la consola de desarrollador):

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Las claves clipia_test_* — sandbox sin cargo de créditos para depuración. Facturación en créditos, el costo de cada generación se devuelve en la respuesta. Tarifas: clipia.ai/tariffs.

Enlaces

Desarrolladores / API REST y SDK: clipia.ai/developers
Página de MCP: clipia.ai/mcp
Catálogo de modelos: clipia.ai/models
Precios: clipia.ai/tariffs
Obtén una clave API: clipia.ai/en/developer

Soporte y legal

Sitio web: clipia.ai
Documentación: clipia.ai/en/docs/mcp
Política de privacidad: clipia.ai/privacy
Términos: clipia.ai/terms
Soporte: support@clipia.ai

Clipia MCP

Documentación

Clipia MCP

Inicio rápido

Conéctate desde cualquier cliente

Claude Code

Claude Desktop

claude.ai (web / escritorio / móvil)

Cursor

VS Code

Cline

Windsurf

Codex CLI

Gemini CLI

ChatGPT (Modo desarrollador)

Herramientas

Por qué Clipia

SDK

Entorno de ejecución del servidor Glama

Precios

🇷🇺 Para Rusia y la CEI

Enlaces

Soporte y legal

Licencia