Formgong
Produkt Dokumentation Vorlagen Preise Blog Anmelden Schlüssel holen

Formgong-MCP-Server

Verbinden Sie Formgong mit Cursor, Claude, VS Code, Lovable oder Bolt. Ihr KI-Assistent kann dann ein Formular erstellen, fertigen Code mit dem richtigen Zugriffsschlüssel abrufen und aktuelle Einsendungen prüfen, ohne dass Sie Schlüssel von Hand kopieren.

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

Tools

  • list_forms — Ihre Formulare mit öffentlichem Zugriffsschlüssel und der Zahl der Einsendungen in diesem Monat.
  • create_form — ein neues Formular; Einsendungen gehen an die E-Mail-Adresse Ihres Kontos. Telegram und weitere Empfänger verbinden Sie im Dashboard (das Tool liefert die Links).
  • get_form_snippet — HTML-, React- oder Next.js-Code für ein Formular mit Zugriffsschlüssel, _lang, botcheck-Honeypot und Turnstile, falls aktiviert.
  • list_recent_submissions — nur lesend und nur mit eigener Freigabe: Zeitpunkt und Felder, Spam standardmäßig ausgeblendet, bis zu 50.

1. API-Token erstellen

  1. Öffnen Sie Dashboard → Konto → API-Tokens (bestätigen Sie zuerst Ihre E-Mail-Adresse).
  2. Benennen Sie das Token nach dem Tool, das es nutzt, z. B. „Cursor auf meinem Laptop“.
  3. Wählen Sie den Zugriff: „Formulare erstellen“ ist standardmäßig aktiv; „Letzte Einsendungen lesen“ bleibt aus, solange Sie es nicht brauchen.
  4. Kopieren Sie das Token (fgp_…). Es wird einmal angezeigt; Formgong speichert nur einen Hash.

2. Server im Tool hinzufügen

Cursor

Cursor: in ~/.cursor/mcp.json (alle Projekte) oder .cursor/mcp.json (ein Projekt) eintragen. Setzen Sie die Umgebungsvariable FORMGONG_TOKEN oder fügen Sie das Token in einer Datei ein, die nicht ins Git-Repository gelangt.

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

Claude Code

Claude Code: einmal im Terminal ausführen.

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

Claude Desktop

Claude Desktop: Eigene Connectors unter Settings → Connectors erfordern OAuth, das Formgong noch nicht anbietet. Nutzen Sie stattdessen die Brücke mcp-remote (Node.js erforderlich) in claude_desktop_config.json und starten Sie Claude Desktop neu.

{
  "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 (Copilot-Agentenmodus): .vscode/mcp.json hinzufügen. VS Code fragt einmal nach dem Token und speichert es sicher.

{
  "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. URL eintragen, „Bearer token or API key“ wählen und nur das Token einfügen (ohne das Wort 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, dann das Token einfügen.

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

Jeder andere Client mit Remote-MCP über Streamable HTTP und eigenen Headern funktioniert mit derselben URL und demselben Header. Reine stdio-Clients können die mcp-remote-Brücke wie bei Claude Desktop nutzen.

Ausprobieren

  • Erstelle ein Formgong-Formular „Kontakt – meine Website“ und füge es auf der Kontaktseite ein.
  • Füge das Formgong-Formular „Kontakt“ als Client-Komponente in diese Next.js-App ein.
  • Zeig mir die letzten 5 Nachrichten aus meinem Kontaktformular.

Sicherheit

  • Ein Token handelt im Rahmen seiner Berechtigungen für Ihr Konto. Halten Sie es aus Git, Chats und Screenshots heraus; widerrufen Sie es unter Konto → API-Tokens, falls es bekannt wird.
  • Verfügbar sind nur Formulare, die Ihnen gehören. Über Projekte mit Ihnen geteilte Formulare sind nicht zugänglich.
  • Einsendungen sind nur abrufbar, wenn Sie „Letzte Einsendungen lesen“ aktivieren. IP-Daten und Browserangaben werden nie zurückgegeben.
  • Einsendungen schreiben Ihre Besucher. Behandeln Sie sie als nicht vertrauenswürdig: Lassen Sie den Assistenten keine Anweisungen aus Nachrichten ausführen.
  • Tokens können nach 30, 90 oder 365 Tagen ablaufen. Sitzungscookies funktionieren auf /mcp nie, daher kann keine Webseite Ihre Anmeldung nutzen.
  • Ohne Token beantwortet /mcp nur die Befehle „initialize“, „ping“ und „tools/list“, sodass Clients und MCP-Verzeichnisse die Tool-Liste einsehen können. Jeder Tool-Aufruf erfordert ein Token; ohne dieses gibt der Server eine Fehlermeldung aus, in der erklärt wird, wie es hinzugefügt werden kann.

Limits

  • 60 Anfragen pro Minute je Token, 120 je Konto.
  • Anfragen ohne Token: 30 pro Minute pro IP-Adresse.
  • 10 neue Formulare pro Stunde über die API.
  • Bis zu 10 Tokens pro Konto.
  • OAuth wird noch nicht unterstützt, daher können sich ChatGPT- und claude.ai-Web-Connectors nicht direkt verbinden. Die Website und die Prompts in dieser Dokumentation funktionieren überall.