Clipform MCP

Servidor MCP oficial para Clipform - o construtor de formulários focado em vídeo.

Documentação

@clipform/mcp-server

Servidor MCP para Clipform - crie e gerencie formulários em estilo de vídeo a partir de qualquer cliente MCP (Claude, ChatGPT, Cursor, Windsurf, etc.).

Instalação

Existem duas maneiras de conectar: remota (recomendada, usa sua conta Clipform) e local (anônima, com limites do plano gratuito).

Remota (recomendada)

Use esta opção se você tiver uma conta Clipform. Os formulários são criados diretamente no seu workspace e o seu plano se aplica (sem limite de 3 nós no Pro).

Claude (claude.ai): Configurações → Conectores → Adicionar conector personalizado → insira https://mcp.clipform.io

ChatGPT: Configurações → Conectores → Avançado → ativar Modo de Desenvolvedor → Criar conector → insira https://mcp.clipform.io (requer Pro/Team/Enterprise)

Qualquer cliente MCP com OAuth: Aponte para https://mcp.clipform.io - descoberta, registro e autenticação são tratados automaticamente via OAuth 2.1 + Dynamic Client Registration (RFC 7591).

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

Use esta opção para clientes MCP baseados em stdio. Passe sua chave de API para autenticar com seu workspace e plano.

Claude Code:

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

Claude Desktop / Cursor / Windsurf / OpenClaw - adicione à sua configuração MCP:

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

A geração de chave de API self-service estará disponível em breve. Por enquanto, sua chave de API é fornecida durante o onboarding ou pelas configurações da sua conta - entre em contato com o suporte se precisar de uma.

Você também pode passar a chave como um sinalizador de CLI: npx -y @clipform/mcp-server --api-key=cf_xxx

Modo anônimo (sem chave de API): Os formulários vão para um workspace compartilhado com o limite de 3 nós do plano gratuito. Você receberá uma URL de reivindicação para mover os formulários para sua conta.

Variáveis de ambiente

Variável	Obrigatória	Finalidade
`CLIPFORM_API_KEY`	Para autenticação do workspace	Chave Bearer - os formulários vão para o workspace da chave com os limites do plano. Também desbloqueia as ferramentas criativas (busca, TTS, renderização de vídeo). Omita para o modo anônimo.
`API_URL`	Sim	URL base da API Clipform (`https://api.clipform.io`, ou sua API local/self-hosted).

Ferramentas

Seu cliente MCP lista estas automaticamente ao conectar (via tools/list). Referência completa - argumentos, esquemas e exemplos - está na documentação.

Ferramenta	Descrição
`clipform_create_form`	Crie um novo Clipform (formulário interativo em estilo de vídeo).
`clipform_list_forms`	Liste formulários no seu workspace com filtragem opcional.
`clipform_get_form`	Recupere os detalhes de um formulário, incluindo todos os nós em ordem sequencial.
`clipform_update_form`	Atualize o título, status de publicação, configurações ou tags de um formulário.
`clipform_delete_form`	Mova um formulário e todos os seus nós para a lixeira.
`clipform_add_node`	Adicione um novo nó a um formulário existente.
`clipform_update_node`	Atualize o texto, tipo, configuração ou opções de um ou mais nós existentes.
`clipform_delete_node`	Exclua um nó de um formulário.
`clipform_upload_media_asset`	Coloque um ou mais arquivos de mídia na biblioteca de mídia do seu workspace (máx. 10, enviados sequencialmente).
`clipform_complete_media_upload`	Confirme que o upload de imagem estática com PUT assinado terminou, após enviar os bytes para o upload_url retornado por clipform_upload_media_asset.
`clipform_attach_node_media`	Anexe um ativo de mídia existente do workspace (de clipform_upload_media_asset) a um ou mais nós (máx. 10).
`clipform_get_node_media`	Obtenha a mídia anexada a um nó, incluindo o status de processamento.
`clipform_delete_node_media`	Remova mídia de um nó.
`clipform_set_logic`	Defina a lógica de roteamento em um ou mais nós.
`clipform_log_generation`	Salve uma trilha de auditoria para um formulário gerado.
`clipform_search_news`	Consulta de notícias de fallback para clientes sem busca web nativa.
`clipform_youtube_transcript`	Extraia a transcrição, o título e as informações do canal de um vídeo do YouTube.
`clipform_generate_tts`	Gere áudio de narração a partir de texto com legendas em nível de palavra.
`clipform_generate_video`	Gere um vídeo a partir de imagens, clipes de vídeo ou ambos, sincronizado com uma faixa de áudio.
`clipform_search_media`	Pesquise imagens ou clipes de vídeo de banco de imagens.
`clipform_render_composition`	Renderize uma composição de vídeo especializada em MP4 ou PNG - visuais animados personalizados que o clipform_generate_video não pode fornecer, como animações geográficas ou gráficos em movimento projetados.
`clipform_search_music`	Pesquise faixas de música livres de royalties e sons ambientes.
`clipform_list_compositions`	Navegue pelas composições de vídeo disponíveis e seus esquemas de props esperados.
`clipform_list_video_templates`	Navegue pelos modelos de vídeo disponíveis - arranjos de cena selecionados (fundo + sobreposição + padrões sensatos) que renderizam através da composição Scene a partir de um pequeno objeto de controles.
`clipform_render_video_template`	Renderize um modelo de vídeo selecionado (uma Scene pré-arranjada: fundo + sobreposição + padrões sensatos) em MP4 ou PNG a partir de um pequeno objeto de controles, em vez de montar manualmente as camadas da Scene.
`clipform_list_assets`	Liste os ativos criativos disponíveis (efeitos sonoros, animações, fontes) para composições de vídeo.
`clipform_check_render`	Verifique o status dos trabalhos de renderização iniciados por clipform_generate_video, clipform_render_video_template ou clipform_render_composition.
`clipform_fetch_boundary`	Busque um polígono de limite GeoJSON para um país, cidade ou região.
`clipform_get_guide`	Recupere conhecimento de criação para construir um tipo específico de formulário.
`clipform_get_workflow`	Recupere um fluxo de trabalho de construção passo a passo para criar um tipo específico de formulário.

Exemplo

Crie um Clipform chamado "Feedback do Cliente" com uma pergunta de escolha perguntando "Como você avaliaria nosso serviço?" com opções Excelente, Bom, Razoável, Ruim, depois uma pergunta aberta perguntando "Algum comentário adicional?", e termine com uma tela final dizendo "Obrigado pelo seu feedback!"

Como funciona

Remoto (OAuth): Os tokens Bearer são vinculados ao público de https://mcp.clipform.io (RFC 8707) e limitados apenas a mcp. Os formulários vão diretamente para o workspace que você aprovou durante o consentimento.

Local com chave de API: O CLIPFORM_API_KEY é enviado como um cabeçalho Authorization: Bearer padrão. Os formulários são criados diretamente no workspace da chave com os limites do seu plano.

Local anônimo (sem chave): Os formulários vão para um workspace compartilhado não reivindicado. Nenhuma autenticação é necessária para editá-los - o UUID do formulário é a única credencial. Você receberá uma URL de reivindicação para transferir a propriedade. O limite de 3 nós do plano gratuito se aplica.

Os formulários são criados com um nó inicial e uma tela final automaticamente - você apenas adiciona os nós entre eles.

Links

Clipform - Crie formulários de vídeo interativos
Documentação - Guia completo com tipos de nós e mais

Os guias de criação (clipform://guides/*, clipform_get_guide) são buscados da API Clipform em tempo de execução, então o servidor precisa de um API_URL acessível e um CLIPFORM_API_KEY válido para fornecê-los.