Formgong
Produto Guia Modelos Preços Blog Entrar Obter chave

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 · 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.

1. 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” 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.

2. Adicione o servidor à sua ferramenta

Cursor

Cursor: adicione a ~/.cursor/mcp.json (todos os projetos) ou a .cursor/mcp.json (um projeto). Defina FORMGONG_TOKEN em seu ambiente ou cole o token no lugar da variável em um arquivo que não seja submetido ao controle de versão.

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

Claude Code

Claude Code: execute uma vez no seu terminal.

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

Claude Desktop

Claude Desktop: os conectores personalizados em Settings → Connectors requerem o OAuth, que Formgong ainda não oferece. Utilize, em vez disso, a ponte mcp-remote (requer Node.js) em claude_desktop_config.json e, em seguida, reinicie 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: Settings → Connectors → Custom MCP server. Insira a URL, selecione “Bearer token or API key” e cole apenas o token (sem a palavra “Bearer”).

URL: https://formgong.com/mcp
Authentication: Bearer token or API key
Token: fgp_your_token

Bolt

Bolt: Settings → Connectors (MCP) → Custom MCP server. Transport: HTTP. Authentication: API key e, em seguida, cole o token.

Name: Formgong
URL: https://formgong.com/mcp
Transport: HTTP
Authentication: API key → fgp_your_token

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.
  • 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 Ainda não há suporte para isso; portanto, os conectores da web ChatGPT e claude.ai não podem se conectar diretamente. O site e as instruções de copiar e colar contidas nesses documentos continuam funcionando em todos os lugares.