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 · OAuth 2.1 or 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.
  • list_webhooks, create_webhook, delete_webhook — Webhooks eines Formulars verwalten, damit n8n, Make oder Zapier ihre Trigger-URL selbst eintragen; create_webhook gibt das Signatur-Secret zurück.
  • list_website_templates — kostenlose fertige Website-Vorlagen (Live-Demo, HTML-Download, Quellcode), deren Kontaktformular schon an Formgong sendet; mit einer Vorlage starten statt die Seite neu zu generieren.

1. Mit Anmeldung verbinden

Cursor, Claude und VS Code können Formgong im Browser öffnen. Sie melden sich mit demselben E-Mail-Link oder Google-Konto an und wählen dann, was das Tool tun darf. Nichts zum Einfügen.

  1. Cursor: speichern Sie die Konfiguration unten. CLIENT_ID ist die öffentliche Kennung cursor (es gibt kein Geheimnis). forms:read und forms:write lassen den Assistenten Formulare auflisten und anlegen. submissions:read nur hinzufügen, wenn er Nachrichten lesen soll.
  2. Claude im Web oder Claude Desktop: einen eigenen Connector mit der MCP-URL hinzufügen. Claude registriert einen öffentlichen Client und öffnet dieselbe Freigabeseite. Die Rückadresse ist https://claude.ai/api/mcp/auth_callback (oder https://claude.com/api/mcp/auth_callback).
  3. Claude Code: den Befehl im nächsten Abschnitt ausführen und die Seite im Browser bestätigen. VS Code registriert sich selbst, oder Sie nutzen die Kennung vscode. Lokale Tools dürfen Rückadressen auf http://127.0.0.1 oder http://localhost verwenden.
  4. forms:read ist immer enthalten. Lassen Sie auf der Freigabeseite „Letzte Einsendungen lesen“ aus, solange Sie es nicht brauchen. Trennen können Sie später unter Dashboard → Konto → Verbundene Apps.

2. 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 und Webhooks hinzufügen oder entfernen“ 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.
{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FORMGONG_TOKEN}"
      }
    }
  }
}

3. Server im Tool hinzufügen

Cursor

Cursor: speichern Sie die Anmeldekonfiguration unten (öffentliche Kennung cursor, kein Geheimnis). Cursor öffnet Formgong; geben Sie den gewünschten Zugriff frei. Für ein persönliches API-Token nutzen Sie die Konfiguration im vorigen Abschnitt und nehmen die Datei nicht ins Git auf.

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

Claude Code

Claude Code: einmal im Terminal ausführen. Bestätigen Sie die Formgong-Seite im Browser. Um die Anmeldung zu überspringen, fügen Sie --header "Authorization: Bearer fgp_your_token" hinzu.

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

Claude Desktop

Claude Desktop: Settings → Connectors → die MCP-URL hinzufügen. Claude öffnet die Formgong-Anmeldung. Für ein eingefügtes API-Token nutzen Sie stattdessen die Brücke mcp-remote (Node.js erforderlich) in claude_desktop_config.json und starten 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: Connectors → + → MCP server. Name: Formgong. URL eingeben, Direct connection und OAuth beibehalten, Add & authorize wählen. Bei Formgong anmelden und Berechtigungen bestätigen. Alternativ: Bearer token or API key und nur das persönliche Token einfügen.

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

Bolt

Bolt: Settings → Connectors (MCP) → Custom MCP server. Name: Formgong. Transport: HTTP. Authentication: MCP OAuth. Connect wählen, bei Formgong anmelden und Berechtigungen bestätigen, dann den Connector für das Projekt aktivieren. API key funktioniert auch mit einem persönlichen Formgong-Token.

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

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.
  • OAuth-Zugriffs- und Aktualisierungstokens werden nur als Hash gespeichert. Ein Aktualisierungstoken wechselt bei jeder Nutzung; das erneute Senden eines alten widerruft diese Verbindung. Apps trennen Sie unter Konto → Verbundene Apps. Die Registrierung akzeptiert nur bekannte MCP-Rückadressen und http://localhost oder http://127.0.0.1.
  • 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.
  • Die OAuth-Registrierung akzeptiert die aufgeführten Rückadressen für Cursor, Claude und VS Code, HTTPS-Adressen auf lovable.dev und bolt.new (ohne Subdomains, Abfrage oder Fragment) und lokale HTTP-Adressen. Jeder Client bleibt an seine exakt registrierte Rückadresse gebunden. Andere Clients verwenden API-Tokens. Anmeldung und Tokenaustausch sind pro IP begrenzt. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.

Prompts für KI-Tools · Regeldateien für Agenten