Servidor MCP do Formgong

Conecte Formgong a Cursor, Claude, VS Code, Lovable ou Bolt. Seu assistente de IA poderá, então, criar um formulário, obter um código pronto para colar com a chave de acesso correta e verificar os envios recentes sem que você precise copiar as chaves manualmente.

URL: https://formgong.com/mcp · Streamable HTTP · OAuth 2.1 or Authorization: Bearer fgp_…

Ferramentas

  • list_forms — seus formulários, com suas chaves de acesso público e o número de envios deste mês.
  • create_form — um novo formulário; os envios são encaminhados para o e-mail da sua conta. Telegram e os destinatários adicionais são configurados no painel de controle (a ferramenta fornece os links).
  • get_form_snippet — HTML, React ou Next.js (código para um formulário, com chave de acesso), _lang, botcheck honeypot e Turnstile, quando ativados.
  • list_recent_submissions — somente leitura, adesão voluntária: apenas a hora e os campos preenchidos, spam excluído por padrão, até 50.
  • list_webhooks, create_webhook, delete_webhook — gerenciam os webhooks de um formulário para que n8n, Make ou Zapier registrem sua URL; create_webhook devolve o segredo de assinatura.
  • list_website_templates — modelos de site completos e gratuitos (demo, download HTML, código) cujo formulário de contato já envia para o Formgong; comece por um em vez de gerar o site do zero.

1. Ligar com início de sessão

O Cursor, o Claude e o VS Code podem abrir o Formgong no navegador. Entra com a mesma ligação de e-mail ou conta Google que já usa e escolhe o que a ferramenta pode fazer. Não há nada para colar.

  1. Cursor: guarde a configuração abaixo. CLIENT_ID é o identificador público cursor (não há segredo). forms:read e forms:write permitem listar e criar formulários. Acrescente submissions:read só se o assistente deve ler as mensagens.
  2. Claude na web ou Claude Desktop: adicione um conector personalizado com o URL do MCP. O Claude regista um cliente público e abre a mesma página de aprovação. O endereço de retorno é https://claude.ai/api/mcp/auth_callback (ou https://claude.com/api/mcp/auth_callback).
  3. Claude Code: execute o comando da secção seguinte e aprove a página no navegador. O VS Code regista-se sozinho, ou pode usar o identificador vscode. Ferramentas locais podem usar http://127.0.0.1 ou http://localhost.
  4. forms:read está sempre incluído. Na página de aprovação, deixe «Ler envios recentes» desligado se não precisar. Pode desligar a aplicação em Painel → Conta → Aplicações ligadas.

2. Crie um token do API

  1. Acesse o Painel → Conta → Tokens de “API” (confirme primeiro seu e-mail).
  2. Dê ao token o nome da ferramenta que o utilizará, por exemplo, “Cursor” no meu laptop.
  3. Escolha o acesso: a opção “Criar formulários e adicionar ou remover webhooks” está ativada por padrão; a opção “Ler envios recentes” está desativada, a menos que você precise dela.
  4. Copie o token (fgp_…). Ele é exibido apenas uma vez; o site Formgong armazena apenas um hash dele.
{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FORMGONG_TOKEN}"
      }
    }
  }
}

3. Adicione o servidor à sua ferramenta

Cursor

Cursor: guarde a configuração OAuth abaixo em .cursor/mcp.json (este projeto) ou ~/.cursor/mcp.json (todos os projetos). Entre no Formgong e aprove as permissões. O identificador público cursor não é um segredo.

{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "auth": {
        "CLIENT_ID": "cursor",
        "scopes": [
          "forms:read",
          "forms:write"
        ]
      }
    }
  }
}

Claude Code

Claude Code: execute uma vez no seu terminal.

claude mcp add --transport http formgong https://formgong.com/mcp

Claude Desktop

Claude Desktop: Settings → Connectors → adicione o URL do MCP. O Claude abre o início de sessão do Formgong. Para colar um token de API, use a ponte mcp-remote (requer Node.js) em claude_desktop_config.json e 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

VS Code (Modo de agente do Copilot): adicione .vscode/mcp.json. O site VS Code solicita o token uma única 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}"
      }
    }
  }
}

Lovable

Lovable: Connectors → + → MCP server. Nome: Formgong. Introduza o URL, mantenha Direct connection e OAuth, clique em Add & authorize. Entre no Formgong e aprove as permissões. Alternativa: Bearer token or API key com apenas o seu token pessoal.

URL: https://formgong.com/mcp
Authentication: OAuth
Add & authorize → Formgong

Bolt

Bolt: Settings → Connectors (MCP) → Custom MCP server. Nome: Formgong. Transport: HTTP. Authentication: MCP OAuth. Clique em Connect, entre no Formgong e aprove as permissões; ative o conector no projeto. API key também aceita um token pessoal do Formgong.

Name: Formgong
URL: https://formgong.com/mcp?auth=required
Transport: HTTP
Authentication: MCP OAuth
Connect → Formgong

Qualquer outro cliente que ofereça suporte à função “MCP” remota por meio de Streamable HTTP com cabeçalhos personalizados funciona com a mesma URL e o mesmo cabeçalho. Clientes que utilizam apenas o Stdio podem usar a ponte mcp-remote apresentada em Claude Desktop.

Experimente

  • Crie um formulário do Formgong chamado “Contato – meu site” e adicione-o à página de contato.
  • Adicione o formulário “Contato” do site Formgong a este aplicativo Next.js como um componente cliente.
  • Mostre-me as últimas 5 mensagens do meu formulário de contato.

Segurança

  • Um token atua em sua conta dentro de seus escopos. Evite divulgá-lo em git, conversas e capturas de tela; revogue-o em Conta → Tokens de API caso haja vazamento.
  • Estão disponíveis apenas os formulários de que o senhor é proprietário. Os formulários compartilhados com o senhor por meio de projetos não são exibidos.
  • As submissões nunca ficam disponíveis, a menos que você marque a opção “Ler submissões recentes”. Dados de IP e detalhes do navegador nunca são fornecidos.
  • O texto enviado é redigido pelos seus visitantes. Considere-o como não confiável: não permita que um assistente siga instruções encontradas em uma mensagem.
  • Os tokens podem expirar após 30, 90 ou 365 dias. Os cookies de sessão nunca funcionam no site /mcp; portanto, uma página da web não pode utilizar seu login.
  • Os tokens de acesso e de atualização do OAuth são armazenados apenas como um hash. O token de atualização muda a cada uso; reenviar um antigo revoga essa conexão. Desconecte os aplicativos em Conta → Aplicativos conectados. O registro aceita apenas callbacks MCP conhecidos e http://localhost ou http://127.0.0.1.
  • Sem um token, /mcp responde apenas a initialize, ping e tools/list, para que os clientes e os diretórios MCP possam ver a lista de ferramentas. Cada chamada de ferramenta requer um token; sem ele, o servidor devolve um erro que explica como o adicionar.

Limites

  • 60 solicitações por minuto por token, 120 por conta.
  • Pedidos sem token: 30 por minuto por endereço IP.
  • 10 novos formulários por hora por meio do site API.
  • Até 10 tokens por conta.
  • OAuth aceita os callbacks indicados para Cursor, Claude e VS Code, endereços HTTPS em lovable.dev e bolt.new (sem subdomínios, parâmetros ou fragmentos) e endereços HTTP locais. Cada cliente fica vinculado ao endereço de retorno exato. Outros clientes usam um token API. Login e troca de tokens limitados por IP. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.

AI builder prompts · Agent rules files