Clipform MCP

@clipform/mcp-server

Servidor MCP para Clipform: crea y gestiona formularios con estilo de 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 el nivel de tu 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 el nivel de tu 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"
      }
    }
  }
}

Genera una clave de API en tu panel de Clipform en Developers > API keys. El servidor local siempre necesita una: para probar Clipform sin una cuenta, conéctate a https://mcp.clipform.io en su lugar (consulta "Cómo funciona").

Variables de entorno

Variable	Requerida	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). Requerida por el servidor local.
API_URL	Sí	URL base de la API de Clipform (https://api.clipform.io, o tu API local o autoalojada).

Herramientas

Tu cliente MCP las lista automáticamente al conectarse (a través de 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 con estilo de 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, OAuth, 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 de opciones/acciones y las respuestas de texto abierto recientes de un formulario.
clipform_get_responses	Lista las respuestas individuales (envíos) de un formulario Clipform con filtrado por tiempo; complementa a clipform_get_results (agregados).
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 una carga de imagen fija con PUT firmado terminó, después de enviar los bytes a la upload_url devuelta 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	Busca artículos de noticias recientes de NewsAPI y The Guardian y los devuelve como resultados estructurados.
clipform_generate_tts	Genera audio de narración a partir de texto con subtítulos a nivel de palabra.
clipform_search_media	Busca imágenes o clips de video de archivo.
clipform_render_composition	Renderiza una composición de video especializada a MP4 o PNG: visuales animados personalizados que una plantilla de 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_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

Remota (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 de forma predeterminada. Una conexión llega a todos los espacios de trabajo de la misma empresa a los que perteneces: pasa workspace_id (ids de clipform_whoami) en clipform_create_form, clipform_import_form, clipform_list_forms, clipform_upload_media_asset o clipform_generate_tts, o un form_id de otro espacio de trabajo en cualquier herramienta de formularios, incluidos clipform_upload_media_asset, clipform_generate_tts y clipform_complete_media_upload, donde es solo una sugerencia de enrutamiento (el resultado aún se guarda en la biblioteca multimedia de ese espacio de trabajo, no en un nodo). La membresía se vuelve a verificar en cada llamada y los resultados nombran el espacio de trabajo.

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

Remota anónima (sin inicio de sesión): Conectarse a https://mcp.clipform.io sin iniciar sesión crea una cuenta temporal propia de la sesión. Los formularios permanecen como borradores con un enlace de vista previa privado: nada se publica y, mientras no se reclamen, el UUID del formulario es la credencial para editarlo. Los resultados de la creación incluyen una URL de reclamo de un solo uso que te inicia sesión en esa cuenta (en el primer formulario, periódicamente después y al alcanzar el límite de formularios); se aplican los límites del plan gratuito. El servidor stdio local siempre necesita CLIPFORM_API_KEY.

Estas herramientas necesitan una cuenta de Clipform con sesión iniciada (OAuth o una clave de API): clipform_list_forms, clipform_whoami, clipform_get_results, clipform_get_responses, clipform_delete_form. Una sesión remota anónima que llame a una de ellas recibirá una solicitud para iniciar sesión. Todo lo demás, incluidos clipform_get_guide, clipform_get_workflow y clipform_list_assets, funciona sin una cuenta.

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.