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 formas 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ê tem 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 → ative o Modo 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 + Registro Dinâmico de Clientes (RFC 7591).
Local - Claude Code / Claude Desktop / Cursor / etc.
Use esta opção para clientes MCP baseados em stdio. Informe 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"
}
}
}
}
Gere uma chave de API no seu painel Clipform em Desenvolvedores > Chaves de API. O servidor local sempre precisa de uma - para testar o Clipform sem conta, conecte-se a https://mcp.clipform.io (veja "Como funciona").
Variáveis de ambiente
| Variável | Obrigatória | Finalidade |
|---|---|---|
CLIPFORM_API_KEY | Para autenticação no workspace | Chave Bearer - os formulários são criados no workspace da chave com os limites do plano. Também desbloqueia as ferramentas criativas (busca, TTS, renderização de vídeo). Obrigatória para o servidor local. |
API_URL | Sim | URL base da API Clipform (https://api.clipform.io, ou sua API local/auto-hospedada). |
Ferramentas
Seu cliente MCP lista estas ferramentas automaticamente ao conectar (via tools/list). Referência completa - argumentos, esquemas e exemplos - está na documentação.
| Ferramenta | Descrição |
|---|---|
clipform_create_form | Cria um novo Clipform (formulário interativo em estilo de vídeo). |
clipform_import_form | Converte um Google Form, Typeform ou Tally público em um novo Clipform. |
clipform_list_forms | Lista formulários no seu workspace com filtragem opcional. |
clipform_whoami | Mostra a identidade atual: modo de autenticação (chave de API, oauth, sessão ou anônimo), workspace ativo e limites do plano. |
clipform_get_form | Recupera os detalhes de um formulário, incluindo todos os nós em ordem sequencial e seu roteamento. |
clipform_update_form | Atualiza o título, status de publicação, configurações ou tags de um formulário. |
clipform_delete_form | Move um formulário e todos os seus nós para a lixeira. |
clipform_get_results | Exibe contagens de respostas, detalhamento de respostas de escolha/ação e respostas de texto aberto recentes de um formulário. |
clipform_get_responses | Lista as respostas individuais (envios) de um formulário Clipform com filtro de tempo - complementa o clipform_get_results (agregados). |
clipform_add_node | Adiciona um novo nó a um formulário existente. |
clipform_update_node | Atualiza o texto, tipo, configuração ou opções de um ou mais nós existentes. |
clipform_delete_node | Exclui um nó de um formulário. |
clipform_upload_media_asset | Coloca um ou mais arquivos de mídia na biblioteca de mídia do seu workspace (máx. 10, enviados sequencialmente). |
clipform_complete_media_upload | Confirma que um upload de imagem estática com PUT assinado foi concluído, após enviar os bytes para a upload_url retornada pelo clipform_upload_media_asset. |
clipform_attach_node_media | Anexa um ativo de mídia existente do workspace (do clipform_upload_media_asset) a um ou mais nós (máx. 10). |
clipform_get_node_media | Obtém a mídia anexada a um nó, incluindo o status de processamento. |
clipform_delete_node_media | Remove mídia de um nó. |
clipform_set_logic | Define o próximo nó para um ou mais nós, criando uma rota linear (A para B para C). |
clipform_log_generation | Etapa de auditoria interna executada por um fluxo de trabalho de geração de formulários. |
clipform_search_news | Busca artigos de notícias recentes da NewsAPI e do The Guardian e os retorna como resultados estruturados. |
clipform_generate_tts | Gera áudio de narração a partir de texto com legendas em nível de palavra. |
clipform_search_media | Busca imagens ou clipes de vídeo de banco de imagens. |
clipform_render_composition | Renderiza uma composição de vídeo especializada em MP4 ou PNG - visuais animados personalizados que um modelo de vídeo não pode fornecer, como animações geográficas ou motion graphics projetados. |
clipform_search_music | Busca faixas musicais livres de royalties e sons ambientes. |
clipform_list_compositions | Navega pelas composições de vídeo disponíveis e seus esquemas de props esperados. |
clipform_list_video_templates | Navega pelos modelos de vídeo disponíveis - arranjos de Scene curados (base + 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 | Renderiza um modelo de vídeo curado (uma Scene pré-arranjada: base + 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 | Lista ativos criativos disponíveis (efeitos sonoros, animações, fontes) para composições de vídeo. |
clipform_check_render | Verifica o status de trabalhos de renderização iniciados pelo clipform_render_video_template ou clipform_render_composition. |
clipform_fetch_boundary | Busca um polígono de limite GeoJSON para um país, cidade ou região. |
clipform_get_guide | Recupera conhecimento de criação para construir um tipo específico de formulário. |
clipform_get_workflow | Recupera 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 as opções Excelente, Bom, Razoável, Ruim, depois uma pergunta aberta perguntando "Algum comentário adicional?", e finalize com uma tela final dizendo "Obrigado pelo seu feedback!"
Como funciona
Remota (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 são criados diretamente no workspace que você aprovou durante o consentimento por padrão. Uma conexão alcança todos os workspaces da mesma empresa: passe workspace_id (ids de clipform_whoami) em clipform_create_form, clipform_import_form, clipform_list_forms, clipform_upload_media_asset ou clipform_generate_tts, ou um form_id de outro workspace em qualquer ferramenta de formulário - incluindo clipform_upload_media_asset, clipform_generate_tts e clipform_complete_media_upload, onde é apenas uma dica de roteamento (o resultado ainda é salvo na biblioteca de mídia desse workspace, não em um nó). A associação é verificada novamente a cada chamada, e os resultados nomeiam o workspace.
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.
Remota anônima (sem login): Conectar-se a https://mcp.clipform.io sem entrar cria uma conta temporária da própria sessão. Os formulários permanecem como rascunhos com um link de pré-visualização privado - nada é publicado - e enquanto não forem reivindicados, o UUID do formulário é a credencial para editá-lo. Os resultados da criação incluem um URL de reivindicação único que faz login nessa conta (no primeiro formulário, periodicamente depois e no limite de formulários); os limites do plano gratuito se aplicam. O servidor local stdio sempre precisa de CLIPFORM_API_KEY.
Estas ferramentas precisam de uma conta Clipform com login (OAuth ou chave de API): clipform_list_forms, clipform_whoami, clipform_get_results, clipform_get_responses, clipform_delete_form. Uma sessão remota anônima que chamar uma delas será solicitada a fazer login. Todo o resto, incluindo clipform_get_guide, clipform_get_workflow e clipform_list_assets, funciona sem conta.
Os formulários são criados com um nó inicial e uma tela final automaticamente - você só adiciona os nós intermediários.
Links
- Clipform - Crie formulários de vídeo interativos
- Documentação - Guia completo com tipos de nós e mais
Guias de criação (
clipform://guides/*,clipform_get_guide) são buscados na API Clipform em tempo de execução, então o servidor precisa de umAPI_URLacessível e umCLIPFORM_API_KEYválido para fornecê-los.