Integração MCP

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA interajam diretamente com serviços externos. O servidor MCP do NueForm dá à sua IA acesso completo ao seu workspace — formulários, respostas, análises, equipes, webhooks, Voice Studio e mais.

O Que Você Pode Fazer?

Com o MCP conectado, você pode pedir à sua IA coisas como:

• "Qual é a minha taxa de conclusão em todos os formulários neste mês?"
• "Crie uma pesquisa de satisfação do cliente com pontuação NPS."
• "Exporte todas as respostas do primeiro trimestre como CSV."
• "Adicione sarah@company.com à equipe de Marketing."
• "Quais perguntas levam mais tempo para serem respondidas?"
• "Leia este aviso com a voz da Rosa. Não gaste mais de 2.000 créditos."
• "Quantos créditos ainda tenho este mês?"

Sua IA traduz essas solicitações em linguagem natural para as chamadas apropriadas da API do NueForm automaticamente.

Pré-requisitos

• Uma conta NueForm (o plano gratuito funciona)
• Um cliente de IA compatível com MCP (veja os guias de configuração abaixo)

Guias de Configuração

URL do servidor MCP do NueForm:

https://nueform.io/api/mcp

A autenticação é feita via OAuth — seu cliente de IA abrirá uma janela do navegador para você entrar com sua conta NueForm. Nenhuma chave de API é necessária.

Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Reinicie o Claude Desktop. Você será solicitado a entrar com sua conta NueForm no primeiro uso.

Claude Code (CLI)

Execute o seguinte comando:

claude mcp add nueform --transport http https://nueform.io/api/mcp

Ou adicione-o ao seu .claude/settings.json:

{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Cursor

Adicione ao .cursor/mcp.json na raiz do seu projeto (ou nas configurações globais):

{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Windsurf

Adicione à sua configuração MCP nas configurações do Windsurf:

{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Adicione ao .vscode/mcp.json no seu workspace:

{
  "servers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Outros Clientes MCP

Qualquer cliente que suporte o transporte HTTP Streamable do MCP pode se conectar ao NueForm. Aponte-o para:

• URL do servidor: https://nueform.io/api/mcp
• Autenticação: OAuth 2.0 (o cliente deve conduzir o fluxo automaticamente)

Ferramentas Disponíveis

O servidor MCP do NueForm expõe 75 ferramentas em 11 categorias:

Formulários (8 ferramentas)

Os formulários são salvos como rascunho. publish_form — ou published: true em create_form e update_form — executa as mesmas verificações do botão Publicar do editor: formulários de equipe só podem ser publicados por administradores e proprietários da equipe, os recursos Pro seguem o plano do dono do formulário, e as perguntas de agendamento, as etapas de e-mail, as perguntas Fuse e os composites precisam estar totalmente configurados. Se alguma verificação falhar, nada é publicado e a ferramenta retorna o motivo, as perguntas a corrigir e uma dica para a sua IA. Um formulário criado com published: true é criado mesmo assim como rascunho quando a publicação é bloqueada.

Análises (5 ferramentas)

Respostas (5 ferramentas)

Webhooks (6 ferramentas)

Equipes (12 ferramentas)

Sessões Fuse (9 ferramentas)

Compostos (6 ferramentas)

Geral (6 ferramentas)

Voice Studio (8 ferramentas)

Studio Apps (7 ferramentas)

Créditos (3 ferramentas)

Gastando créditos

As ferramentas que gastam créditos (voice_generate, voice_design, voice_save, voice_clone, studio_audio_merge, studio_voice_drop, studio_time_capsule, studio_podcast e studio_talking_qr) exigem max_credits: o máximo que uma chamada pode gastar (10.000 créditos = US$ 1). Sem ele, ou quando a chamada custaria mais, nada é gasto e a ferramenta responde com o custo exato, para que a sua IA possa confirmar com você antes.

• A fala custa 1 crédito por caractere falado, em qualquer idioma. Fazer o mesmo clipe de novo em até 30 dias é grátis, e as falas que falham são devolvidas automaticamente.
• Uma voz nova, criada e salva ou clonada, custa 50.000 créditos (US$ 5).
• Valem as mesmas regras do app: o texto é verificado com a política de uso antes de qualquer cobrança, e para salvar ou clonar uma voz é preciso uma primeira compra de créditos e um e-mail confirmado. Só clone uma voz que você tem o direito de usar.
• Se uma chamada passar do tempo limite, faça a mesma chamada de novo com os mesmos argumentos e o mesmo idempotency_key (8 a 100 letras, números, - ou _; toda resposta traz o que está em uso): você recebe o resultado da primeira chamada em vez de pagar duas vezes.
• Os links de áudio funcionam por 15 minutos. library_get gera um novo.
• A fala, as vozes novas e as Studio Apps que geram fala são pagas com o que você escolheu em Pagar o Voice Studio com na sua Carteira: seus próprios créditos, a menos que tenha escolhido uma equipe (aí uma voz que você criar é da equipe). credits_balance mostra quanto isso permite gastar. studio_voice_drop e studio_time_capsule sempre usam seus próprios créditos. Se a equipe não puder pagar, nada é gasto e a resposta diz por quê.
• Não é possível comprar, dar ou recarregar créditos automaticamente pelo MCP: faça isso na sua Carteira no NueForm.

Para grandes volumes a partir do seu próprio código, a Voice API cobra 0,4 crédito por caractere.

Exemplos de Uso

Analisando o Desempenho de um Formulário

Você: "Qual é a taxa de conclusão do meu formulário de Feedback de Clientes neste mês?"

IA: Usa get_form_analytics com filtros de data e então relata: "Seu formulário de Feedback de Clientes tem uma taxa de conclusão de 73% neste mês (219 concluídas de 300 respostas no total). Uma alta em relação aos 68% do mês passado."

Criando um Formulário

Você: "Crie uma pesquisa rápida de satisfação do cliente com 3 perguntas: uma avaliação, uma caixa de comentário e um campo de e-mail."

IA: Usa create_form com um array de perguntas e então confirma: "Pronto! Criei a 'Pesquisa de Satisfação do Cliente' com 3 perguntas. Quer que eu a publique?"

Gerenciando Respostas

Você: "Exporte todas as respostas do meu formulário de Candidatura de Emprego como CSV para que eu possa revisá-las em uma planilha."

IA: Usa export_responses_csv e retorna os dados CSV, que você pode salvar em um arquivo.

Criando uma Locução

Você: "Leia o nosso novo horário de funcionamento com a voz da Rosa. Não gaste mais de 2.000 créditos."

IA: Usa voices_list para encontrar a Rosa, depois voice_generate com max_credits: 2000, e responde: "Pronto. Foram usados 612 créditos. Aqui está o áudio; o link funciona por 15 minutos."

Solução de Problemas

"Authentication failed"

Certifique-se de estar conectado à conta NueForm correta. Tente desconectar e reconectar o servidor MCP no seu cliente de IA.

"Permission denied" em ferramentas de webhook ou de equipe

Algumas ferramentas exigem níveis de plano específicos (Pro ou Enterprise) ou papéis de equipe (administrador ou proprietário). Verifique seu plano na página de cobrança.

Ferramentas não aparecem

Reinicie seu cliente de IA depois de adicionar a configuração MCP. Alguns clientes exigem uma reinicialização completa para detectar novos servidores MCP.

"not_started" em uma ferramenta do Voice Studio

Nada foi gasto: a chamada não tinha max_credits, ou o custo era maior. A resposta traz o custo exato; envie a chamada de novo com max_credits pelo menos desse valor.

Limite de requisições

O servidor MCP do NueForm aplica os mesmos limites por minuto da API REST (100 requisições por minuto, 500 no Enterprise), contados por usuário e separadamente das suas chaves de API. Cada requisição conta, inclusive cada uma dentro de um lote, e um lote pode conter no máximo 10 requisições. Se você estiver fazendo muitas requisições em sequência rápida, a IA pode precisar aguardar entre as chamadas.