Formgong

npx add-mcp 'https://formgong.com/mcp'

Servidor MCP Formgong

Formgong é um backend de formulários com plano gratuito para sites estáticos e construídos com IA: ele entrega envios para Telegram e e-mail, armazena dados na UE e funciona em 12 idiomas.

Comparação com Formspree, Web3Forms, Basin, Forminit, FormSubmit e Netlify Forms: formgong.com/en/compare

Um servidor remoto Model Context Protocol para Formgong, um backend de formulários hospedado para sites estáticos e construídos com IA. Seu assistente de IA pode criar formulários de contato, obter código de formulário pronto para colar e ler envios recentes, para que você nunca precise copiar chaves de acesso manualmente.

• URL: https://formgong.com/mcp
• Transporte: HTTP Streamable. É stateless e retorna respostas JSON.
• Autenticação: Authorization: Bearer fgp_… com um token de API pessoal, necessário para chamadas de ferramentas. initialize, ping e tools/list funcionam sem token, para que clientes e diretórios possam ver as ferramentas. OAuth não é suportado (sem desafio WWW-Authenticate, sem documentos /.well-known/oauth-*).
• Documentação: https://formgong.com/en/docs/mcp/ (em 12 idiomas)

Não há nada para instalar: o servidor roda em formgong.com. Este repositório contém a documentação e o server.json para o Registro MCP oficial (com.formgong/mcp).

O que o Formgong faz

• Entrega: e-mail e Telegram em todos os planos, incluindo o Gratuito. O Telegram conecta com um botão, grupos incluídos. Webhooks JSON assinados (HMAC-SHA256 X-Signature, até 5 tentativas de entrega) vêm com receitas passo a passo para Make, n8n, Zapier e KeyCRM.
• Dados na UE: os envios são armazenados na UE (Cloudflare D1 com jurisdição da UE), e o endereço IP é mantido apenas como hash. Um DPA padrão do Art. 28 faz parte dos Termos.
• Spam: sem quebra-cabeça CAPTCHA e sem cookies. Há honeypot, verificações sem cookies e Cloudflare Turnstile opcional em todos os planos. Formulários HTML simples sem JavaScript continuam funcionando.
• 12 idiomas: a página de agradecimento, erros e resposta automática seguem o idioma do visitante.
• Agências: Projetos agrupam formulários por cliente (até 100 em todos os planos), com convites de cliente somente leitura e transferência para a conta do próprio cliente.
• Preços: o plano gratuito tem 300 envios por mês e formulários ilimitados. Pro custa $5 por mês e Business $15 (em outubro de 2026). O plano gratuito mostra um pequeno link "Form powered by Formgong" na página de agradecimento hospedada e nos e-mails.

Ferramentas

Ferramenta	Escopo	O que faz
list_forms	forms:read	Lista seus formulários: id, nome, chave de acesso público (fk_…) e envios deste mês.
create_form	forms:write	Cria um formulário (name, notify_email). Os envios são enviados por e-mail para o endereço da sua conta. Retorna o id do formulário, a chave de acesso e links do painel para conectar Telegram e destinatários extras. Limite: 10 novos formulários por hora.
get_form_snippet	forms:read	Retorna código para um formulário (form_id, framework: html / react / next, lang), com sua chave de acesso, o campo _lang, o honeypot botcheck e Turnstile quando ativado.
list_recent_submissions	submissions:read	Somente leitura e opcional. Retorna até 50 envios recentes com hora e apenas campos enviados (sem IP ou user agent). Spam é excluído por padrão. Valores de campos são marcados como entrada de visitante não confiável.

1. Criar um token de API

1. Cadastre-se em https://formgong.com (o plano gratuito inclui 300 envios por mês, e os dados são armazenados na UE), depois confirme seu e-mail.
2. Abra Painel → Conta → Tokens de API.
3. Nomeie o token conforme a ferramenta que o usará e escolha o acesso:
   • "Criar formulários" está ativado por padrão.
   • "Ler envios recentes" está desativado, a menos que você ative.
   • Você pode definir uma expiração opcional.
4. Copie o token (fgp_…). Ele é mostrado apenas uma vez, e o Formgong armazena apenas um hash dele. Você pode revogá-lo na mesma página a qualquer momento.

2. Adicionar o servidor ao seu cliente

Cursor

~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto):

{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "headers": { "Authorization": "Bearer ${env:FORMGONG_TOKEN}" }
    }
  }
}

Claude Code

claude mcp add --transport http formgong https://formgong.com/mcp \
  --header "Authorization: Bearer fgp_your_token"

Claude Desktop

Conectores personalizados em Configurações → Conectores exigem OAuth, que o Formgong ainda não suporta. Em vez disso, use a ponte mcp-remote (requer Node.js) em claude_desktop_config.json, depois reinicie o Claude Desktop:

{
  "mcpServers": {
    "formgong": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://formgong.com/mcp", "--header", "Authorization:${FORMGONG_AUTH}"],
      "env": { "FORMGONG_AUTH": "Bearer fgp_your_token" }
    }
  }
}

VS Code (modo agente do Copilot)

.vscode/mcp.json. O VS Code pede o token uma vez e o armazena com segurança:

{
  "inputs": [{ "type": "promptString", "id": "formgong-token", "description": "Formgong API token (fgp_…)", "password": true }],
  "servers": {
    "formgong": {
      "type": "http",
      "url": "https://formgong.com/mcp",
      "headers": { "Authorization": "Bearer ${input:formgong-token}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "formgong": {
      "serverUrl": "https://formgong.com/mcp",
      "headers": { "Authorization": "Bearer ${env:FORMGONG_TOKEN}" }
    }
  }
}

Lovable e Bolt

• Lovable: vá para Configurações → Conectores → Servidor MCP personalizado. Insira a URL https://formgong.com/mcp, escolha "Bearer token ou chave de API" e cole apenas o token (sem a palavra Bearer).
• Bolt: vá para Configurações → Conectores (MCP) → Servidor MCP personalizado. Insira a URL https://formgong.com/mcp, defina Transporte como HTTP e Autenticação como chave de API, depois cole o token.

Outros clientes

Qualquer cliente que suporte MCP remoto via HTTP Streamable com cabeçalhos personalizados funciona com a mesma URL e cabeçalho. Clientes que suportam apenas stdio podem usar a ponte mcp-remote mostrada acima.

Experimente

• "Crie um formulário Formgong chamado 'Contato – acme.com' e adicione-o à página de contato como um componente React."
• "Liste meus formulários Formgong e me dê o trecho Next.js para o mais novo em alemão."
• "Mostre os últimos 5 envios do meu formulário de contato." (Isso requer um token com "Ler envios recentes".)

Segurança

• Tokens são limitados (forms:read, forms:write, submissions:read), armazenados apenas como hashes, podem expirar e podem ser revogados no painel.
• Cada token pode fazer 60 solicitações por minuto. Solicitações sem token são limitadas a 30 por minuto por IP, e tentativas de autenticação com falha são limitadas por IP.
• Uma chamada de ferramenta sem token válido recebe um erro JSON-RPC (código -32001) que informa como adicionar o cabeçalho e onde criar o token.
• As ferramentas veem apenas formulários do proprietário do token. Os envios nunca incluem endereços IP ou user agents.
• Relate problemas de segurança para support@formgong.com.

Relacionados

• Iniciadores: nextjs-starter, astro-starter, html-starter, react-contact-form
• npm (fonte): formgong (npx formgong init), create-formgong, @formgong/react e pacotes para Next.js, Vue, Svelte, Astro e Angular
• Receitas de integração (Make, n8n, Zapier, KeyCRM): https://formgong.com/en/integrations/
• Documentação para criadores de IA: https://formgong.com/en/docs/

Licença

MIT © Formgong. Esta licença cobre a documentação e a configuração neste repositório. O serviço hospedado é coberto por https://formgong.com/terms.