Clipform MCP

@clipform/mcp-server

Servidor MCP para Clipform: crea y gestiona formularios estilo video desde cualquier cliente MCP (Claude, ChatGPT, Cursor, Windsurf, etc.).

Instalación

Hay dos formas de conectarse: remota (recomendada, usa tu cuenta de Clipform) y local (anónima, con límites del plan gratuito).

Remota (recomendada)

Úsala si tienes una cuenta de Clipform. Los formularios se crean directamente en tu espacio de trabajo y se aplica tu nivel de plan (sin límite de 3 nodos en Pro).

Claude (claude.ai): Configuración → Conectores → Agregar conector personalizado → ingresa https://mcp.clipform.io

ChatGPT: Configuración → Conectores → Avanzado → habilita el Modo Desarrollador → Crear conector → ingresa https://mcp.clipform.io (requiere Pro/Team/Enterprise)

Cualquier cliente MCP con OAuth: Apúntalo a https://mcp.clipform.io: el descubrimiento, el registro y la autenticación se manejan automáticamente mediante OAuth 2.1 + Registro Dinámico de Clientes (RFC 7591).

Local: Claude Code / Claude Desktop / Cursor / etc.

Úsala para clientes MCP basados en stdio. Pasa tu clave de API para autenticarte con tu espacio de trabajo y tu nivel de plan.

Claude Code:

claude mcp add clipform -e CLIPFORM_API_KEY=cf_xxx -- npx -y @clipform/mcp-server

Claude Desktop / Cursor / Windsurf / OpenClaw: agrégalo a tu configuración de MCP:

{
  "mcpServers": {
    "clipform": {
      "command": "npx",
      "args": ["-y", "@clipform/mcp-server"],
      "env": {
        "CLIPFORM_API_KEY": "cf_xxx",
        "API_URL": "https://api.clipform.io"
      }
    }
  }
}

La generación de claves de API de autoservicio estará disponible próximamente. Por ahora, tu clave de API se proporciona durante la incorporación o mediante la configuración de tu cuenta; contacta al soporte si necesitas una.

También puedes pasar la clave como un indicador de CLI: npx -y @clipform/mcp-server --api-key=cf_xxx

Modo anónimo (sin clave de API): los formularios van a un espacio de trabajo compartido con el límite de 3 nodos del plan gratuito. Recibirás una URL de reclamación para mover los formularios a tu cuenta.

Variables de entorno

Variable	Obligatoria	Propósito
CLIPFORM_API_KEY	Para autenticación del espacio de trabajo	Clave Bearer: los formularios se guardan en el espacio de trabajo de la clave con sus límites de plan. También desbloquea las herramientas creativas (búsqueda, TTS, renderizado de video). Omítela para el modo anónimo.
API_URL	Sí	URL base de la API de Clipform (https://api.clipform.io, o tu API local/autohospedada).

Herramientas

Tu cliente MCP las lista automáticamente al conectarse (mediante tools/list). La referencia completa (argumentos, esquemas y ejemplos) está en la documentación.

Herramienta	Descripción
clipform_create_form	Crea un nuevo Clipform (formulario interactivo estilo video).
clipform_import_form	Convierte un Google Form, Typeform o Tally público en un nuevo Clipform.
clipform_list_forms	Lista los formularios de tu espacio de trabajo con filtrado opcional.
clipform_whoami	Muestra la identidad actual: modo de autenticación (clave de API, sesión o anónimo), espacio de trabajo activo y límites del plan.
clipform_get_form	Recupera los detalles de un formulario, incluidos todos los nodos en orden secuencial y su enrutamiento.
clipform_update_form	Actualiza el título, el estado de publicación, la configuración o las etiquetas de un formulario.
clipform_delete_form	Mueve un formulario y todos sus nodos a la papelera.
clipform_get_results	Consulta los recuentos de respuestas, el desglose de respuestas por opción/acción y las respuestas de texto abierto recientes de un formulario.
clipform_add_node	Agrega un nuevo nodo a un formulario existente.
clipform_update_node	Actualiza el texto, el tipo, la configuración o las opciones de uno o más nodos existentes.
clipform_delete_node	Elimina un nodo de un formulario.
clipform_upload_media_asset	Coloca uno o más archivos multimedia en la biblioteca multimedia de tu espacio de trabajo (máx. 10, se suben secuencialmente).
clipform_complete_media_upload	Confirma que finalizó la subida de una imagen fija con PUT firmado, después de enviar los bytes a upload_url devuelto por clipform_upload_media_asset.
clipform_attach_node_media	Adjunta un recurso multimedia existente del espacio de trabajo (de clipform_upload_media_asset) a uno o más nodos (máx. 10).
clipform_get_node_media	Obtiene el contenido multimedia adjunto a un nodo, incluido el estado de procesamiento.
clipform_delete_node_media	Elimina contenido multimedia de un nodo.
clipform_set_logic	Establece el siguiente nodo para uno o más nodos, conectando una ruta lineal (de A a B a C).
clipform_log_generation	Paso de auditoría interna ejecutado por un flujo de trabajo de generación de formularios.
clipform_search_news	Búsqueda de noticias de respaldo para clientes sin búsqueda web nativa.
clipform_generate_tts	Genera audio de narración a partir de texto con subtítulos a nivel de palabra.
clipform_generate_video	Genera un video a partir de imágenes, clips de video o ambos, sincronizado con una pista de audio.
clipform_search_media	Busca imágenes o clips de video de stock.
clipform_render_composition	Renderiza una composición de video especializada a MP4 o PNG: visuales animados personalizados que clipform_generate_video no puede proporcionar, como animaciones geográficas o gráficos en movimiento diseñados.
clipform_search_music	Busca pistas de música libres de regalías y sonidos ambientales.
clipform_list_compositions	Explora las composiciones de video disponibles y sus esquemas de props esperados.
clipform_list_video_templates	Explora las plantillas de video disponibles: arreglos de Scene seleccionados (fondo + superposición + valores predeterminados sensatos) que se renderizan mediante la composición Scene desde un objeto de controles pequeño.
clipform_render_video_template	Renderiza una plantilla de video seleccionada (una Scene preconfigurada: fondo + superposición + valores predeterminados sensatos) a MP4 o PNG desde un objeto de controles pequeño, en lugar de ensamblar manualmente las capas de Scene.
clipform_list_assets	Lista los recursos creativos disponibles (efectos de sonido, animaciones, fuentes) para composiciones de video.
clipform_check_render	Verifica el estado de los trabajos de renderizado iniciados por clipform_generate_video, clipform_render_video_template o clipform_render_composition.
clipform_fetch_boundary	Obtiene un polígono de límite GeoJSON para un país, ciudad o región.
clipform_get_guide	Recupera el conocimiento de creación para construir un tipo de formulario específico.
clipform_get_workflow	Recupera un flujo de trabajo de construcción paso a paso para crear un tipo de formulario específico.

Ejemplo

Crea un Clipform llamado "Comentarios de clientes" con una pregunta de opción múltiple que pregunte "¿Cómo calificarías nuestro servicio?" con las opciones Excelente, Bueno, Regular, Malo, luego una pregunta abierta que pregunte "¿Algún comentario adicional?", y termina con una pantalla final que diga "¡Gracias por tus comentarios!"

Cómo funciona

Remoto (OAuth): Los tokens Bearer están vinculados a la audiencia de https://mcp.clipform.io (RFC 8707) y limitados solo a mcp. Los formularios se guardan directamente en el espacio de trabajo que aprobaste durante el consentimiento.

Local con clave de API: El CLIPFORM_API_KEY se envía como un encabezado estándar Authorization: Bearer. Los formularios se crean directamente en el espacio de trabajo de la clave con los límites de tu nivel de plan.

Local anónimo (sin clave): Los formularios van a un espacio de trabajo compartido sin reclamar. No se necesita autenticación para editarlos: el UUID del formulario es la única credencial. Recibirás una URL de reclamación para transferir la propiedad. Se aplica el límite de 3 nodos del plan gratuito.

Los formularios se crean automáticamente con un nodo de inicio y una pantalla final: solo agregas los nodos intermedios.

Enlaces

• Clipform: crea formularios de video interactivos
• Documentación: guía completa con tipos de nodos y más

Las guías de creación (clipform://guides/*, clipform_get_guide) se obtienen de la API de Clipform en tiempo de ejecución, por lo que el servidor necesita un API_URL accesible y un CLIPFORM_API_KEY válido para servirlas.