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 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?"

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.com/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.com/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.com/api/mcp

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

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

Cursor

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

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

Windsurf

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

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

VS Code (GitHub Copilot)

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

{
  "servers": {
    "nueform": {
      "url": "https://nueform.com/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.com/api/mcp
• Autenticação: OAuth 2.0 (o cliente deve conduzir o fluxo automaticamente)

Ferramentas Disponíveis

O servidor MCP do NueForm expõe 40 ferramentas em 6 categorias:

Formulários (8 ferramentas)

Análises (5 ferramentas)

Respostas (5 ferramentas)

Webhooks (6 ferramentas)

Equipes (12 ferramentas)

Geral (4 ferramentas)

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.

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.

Limite de requisições

O servidor MCP do NueForm segue os mesmos limites de requisição da API REST. Se você estiver fazendo muitas requisições em sequência rápida, a IA pode precisar aguardar entre as chamadas.