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 no Claude web e mobile usa OAuth, sem expor uma chave na URL. Clientes técnicos que permitem cabeçalhos HTTP também podem usar uma chave de API com Bearer token.

1. No Claude, abra Configurações → Conectores → Adicionar conector personalizado.
2. Use o nome FormGuru e a URL https://app.formguru.com.br/api/mcp.
3. Clique em Adicionar e depois em Conectar.
4. Entre na sua conta FormGuru, escolha o workspace e revise as permissões.
5. Autorize a conexão. A partir daí, basta conversar com o Claude pedindo as ações descritas acima.

No Claude Code ou em outro cliente que aceite cabeçalhos personalizados, você também pode usar o endpoint acima com Authorization: Bearer sk_live_xxx. Em caso de dúvida, 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

Uma autorização OAuth ou chave de API dá acesso às ações consentidas na sua conta:

• Nunca compartilhe chaves de API nem as cole em lugares públicos (mensagens, prints, repositórios de código).
• Revogue quando necessário: remova o conector no Claude para encerrar o uso por OAuth; se uma chave de API vazar, revogue-a nas Configurações.
• 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. Depois de conectado, você apenas conversa com o Claude. No Claude web, basta cadastrar o endpoint e autorizar sua conta pelo fluxo de login do FormGuru.

O Claude tem acesso a tudo na minha conta?

O acesso é limitado às ações que o MCP Server do FormGuru expõe, ao workspace escolhido e às permissões consentidas. Você pode remover o conector no Claude para interromper o acesso.