Controle o FormGuru pelo Claude (MCP Server)

O MCP Server do FormGuru permite que você opere sua conta conversando com um assistente de IA como o Claude. Em vez de abrir o painel e clicar, você pede em linguagem natural — "liste meus formulários", "quantas respostas o quiz recebeu esta semana?" — e o assistente executa a ação no FormGuru e devolve o resultado. Este artigo explica o que é o MCP, para que serve, como conectar e quais são os cuidados de segurança.

O que é o MCP

MCP (Model Context Protocol) é um padrão aberto que conecta assistentes de IA a ferramentas externas de forma estruturada. O FormGuru disponibiliza um MCP Server próprio: ao conectá-lo ao Claude, o assistente passa a "enxergar" sua conta e a executar um conjunto de ações permitidas — sempre em seu nome e com as permissões da sua conta.

Na prática, é uma ponte. O Claude não acessa o FormGuru sozinho: ele só consegue fazer isso depois que você fornece um token de conexão que liga as duas pontas.

Para que serve

Com o MCP conectado, você pode pedir ao Claude para:

• Listar e consultar formulários — ver quais formulários existem na sua conta e seus detalhes.
• Criar formulários — descrever o formulário que quer e deixar a IA montá-lo (apoiado pelo Guru Creator).
• Ver respostas — consultar respostas recebidas, filtrar por período e resumir o conteúdo.
• Ver estatísticas — número de respostas, taxa de conclusão e outras métricas, sem abrir o painel.

A grande vantagem é o fluxo conversacional: você combina perguntas e ações na mesma conversa ("liste meus formulários, depois me mostre as respostas do mais recente e resuma os principais pontos"), e ainda aproveita a capacidade de análise do próprio Claude em cima dos dados.

Como conectar

A conexão é feita por um token de conexão MCP, gerado dentro do FormGuru. Os passos abaixo seguem o fluxo geral; alguns rótulos de menu podem variar conforme a versão da interface.

1. No FormGuru, acesse as Configurações da sua conta.
2. Abra a área de Integrações e localize a opção de MCP (ou "Conexão com IA / Claude").
3. Gere um token de conexão. Copie e guarde esse token em local seguro — ele costuma ser exibido apenas uma vez.
4. No seu cliente do Claude (por exemplo, o app de desktop ou outro que suporte MCP), adicione o servidor MCP do FormGuru e cole o token quando solicitado.
5. Confirme a conexão. A partir daí, basta conversar com o Claude pedindo as ações descritas acima.

Se o seu cliente do Claude não listar o servidor automaticamente, será necessário configurá-lo manualmente apontando para o endpoint MCP do FormGuru e informando o token. Em caso de dúvida sobre o endpoint, consulte a documentação técnica em /docs/api.

Exemplos de comandos em linguagem natural

Você não precisa saber nenhuma sintaxe especial — basta descrever o que quer. Alguns exemplos:

• "Liste todos os meus formulários ativos."
• "Crie um formulário de captação de leads com nome, e-mail e telefone."
• "Quantas respostas o formulário de inscrição recebeu nos últimos 7 dias?"
• "Mostre as últimas 20 respostas do quiz e resuma as principais reclamações."
• "Qual a taxa de conclusão do meu formulário de pesquisa?"

O assistente interpreta o pedido, chama a ação correspondente no FormGuru e responde com os dados. Para análises mais profundas das respostas, vale combinar com os recursos de IA do produto descritos em Análise com IA.

Limitações e segurança

O token de conexão dá acesso à sua conta — trate-o como uma senha:

• Nunca compartilhe o token nem o cole em lugares públicos (mensagens, prints, repositórios de código).
• Guarde com cuidado: quem tiver o token pode executar as ações permitidas na sua conta pelo MCP.
• Revogue se vazar: se desconfiar que o token foi exposto, gere um novo nas Configurações e descarte o antigo.
• As ações disponíveis pelo MCP respeitam as permissões e os limites do seu plano. Recursos e cotas (como o limite de respostas) seguem valendo normalmente.

O MCP é uma alternativa conversacional ao acesso programático. Se você precisa de integração direta com sistemas, scripts ou outras ferramentas, a API REST costuma ser o caminho mais adequado.

Dúvidas comuns

MCP é o mesmo que a API REST?

Não. A API REST é voltada para integrações programáticas (chamadas HTTP em /api/v1, autenticadas por chave de API). O MCP é uma camada para assistentes de IA como o Claude executarem ações por linguagem natural. Por baixo, ambos operam sobre a mesma conta, mas o uso é diferente. Veja mais em API REST do FormGuru.

Preciso saber programar para usar o MCP?

Não para usar no dia a dia. Depois de conectado, você apenas conversa com o Claude. A única etapa técnica é a configuração inicial do servidor MCP no cliente do Claude, que pode exigir colar o endpoint e o token.

O Claude tem acesso a tudo na minha conta?

O acesso é limitado às ações que o MCP Server do FormGuru expõe e às permissões da sua conta. Ainda assim, como o token autoriza essas ações, trate-o como uma credencial sensível e revogue-o caso necessário.