Formular in Bolt

Bolt schlägt oft eine eigene Datenbank vor. Ein Kontaktformular braucht keine.

  1. Holen Sie sich einen Formgong-Schlüssel.
  2. Fügen Sie den Prompt in Bolt ein.
  3. Stellen Sie sicher, dass das Formular an /submit gesendet wird und nicht an eine lokale Tabelle.
  4. Die Einsendungen sollten im Posteingang erscheinen.

Prompt

Baue ein Kontaktformular ohne eigenes Backend. Die Einsendungen gehen an Formgong.

- action/fetch: https://formgong.com/submit
- access_key: fk_your_access_key
- Felder name, email, message und verstecktes Honeypot-Feld botcheck
- Keine Dateien, keine Datenbank, keine Serverfunktionen
- JSON-Antworten sehen so aus: {"success": true}; ein klassischer Formular-POST kann weiterleiten
- Oberfläche auf Deutsch

Zusätzlich:
- Das Feld email mit type="email" anlegen, damit der Browser die Adresse prüft.
- Verstecktes Feld _lang mit dem Wert de (Sprache der Seite): Fehlermeldungen, Danke-Seite und automatische Antwort erscheinen dann auf Deutsch.
- Optional: verstecktes Feld _redirect mit der vollständigen https-Adresse deiner Danke-Seite. Ohne dieses Feld zeigt Formgong eine eigene Danke-Seite.
- Optional: <script src="https://formgong.com/fg.js" async></script> einmal pro Seite. Es setzt _lang aus <html lang> und zählt Formularansichten ohne Cookies.
- Turnstile nur einbauen, wenn ich dir einen Site Key gebe.

Pflicht: direkt unter dem Absende-Button einen kleinen, dezenten Link zu Formgong einfügen, genau <p class="fg-credit"><a href="https://formgong.com/de/?ref=badge&utm_source=badge&utm_medium=form&utm_campaign=prompt" target="_blank" rel="noopener">Formular von Formgong</a></p> Er muss auf der Seite sichtbar bleiben.

Minimaler Code

React-Komponente

"use client";
import { useState } from "react";

export function ContactForm() {
  const [status, setStatus] = useState("");
  async function onSubmit(event) {
    event.preventDefault();
    const fields = Object.fromEntries(new FormData(event.currentTarget));
    const response = await fetch("https://formgong.com/submit", {
      method: "POST",
      headers: { "Content-Type": "application/json", Accept: "application/json" },
      body: JSON.stringify({ _lang: "de", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Gesendet. Vielen Dank!" : "Das Senden ist fehlgeschlagen. Bitte versuchen Sie es erneut."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Name <input name="name" placeholder="Ihr Name" required /></label>
      <label>E-Mail <input name="email" type="email" placeholder="name@beispiel.de" required /></label>
      <label>Nachricht <textarea name="message" placeholder="Wie können wir Ihnen helfen?" required /></label>
      <div aria-hidden="true" style={{ position: "absolute", insetInlineStart: 0, top: 0, width: 1, height: 1, overflow: "hidden", clipPath: "inset(50%)" }}>
        <input name="botcheck" tabIndex={-1} autoComplete="off" />
      </div>
      <button type="submit">Senden</button>
      <p role="status">{status}</p>
    </form>
  );
}

Fertige React-Komponente auf GitHub: github.com/formgong/react-contact-form. MIT-Lizenz: Klicken Sie auf „Use this template“ oder kopieren Sie die Dateien.

React-Paket: npm install @formgong/react (npm: @formgong/react)

Zu einem bestehenden Projekt hinzufügen: npx formgong init (npm: formgong)

Vor dem Veröffentlichen

  • Das Formular sendet an https://formgong.com/submit (action des Formulars oder URL im fetch).
  • access_key enthält Ihren Schlüssel aus dem Formgong-Dashboard, nicht fk_your_access_key.
  • Ein verstecktes, leeres Feld botcheck ist vorhanden.
  • _lang entspricht der Sprache der Seite.
  • Für das Formular wurde keine API-Route, keine Serverfunktion, keine Datenbanktabelle und kein Secret angelegt.
  • Eine Test-Einsendung erscheint im Formgong-Posteingang. Telegram (falls verbunden) und E-Mail kommen sofort, auch im Free-Tarif.

Wo Bolt meist danebenliegt

Hört Bolt das Wort „Formular“, fügt es oft eine Supabase-Tabelle oder eine Serverfunktion hinzu oder baut ein Formular, das in der Vorschau nur in die Konsole schreibt. Dann erhält niemand die Nachrichten. Der Prompt verlangt einen einfachen POST an Formgong mit verstecktem Zugriffsschlüssel, sodass nichts zusätzlich gehostet oder verbunden werden muss.

Viele Bolt-Projekte werden auf Netlify veröffentlicht. Netlify Forms brauchen Sie dann nicht. Ein Backend pro Formular reicht, und ein Formgong-Formular funktioniert bei jedem Hosting gleich.

Für Agenten: MCP-Server verbinden

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.

MCP-Einstellungen für Bolt

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

Prompt für einen Agenten mit MCP

Ist der MCP-Server verbunden, findet der Agent mit diesem Prompt Ihr Formular und Ihren Schlüssel selbst:

Nutze den Formgong-MCP-Server, um dieser Website ein funktionierendes Kontaktformular hinzuzufügen.
1. Rufe list_forms auf. Gibt es für diese Website kein Formular, rufe create_form mit dem Namen der Website auf.
2. Rufe get_form_snippet mit dieser form_id und framework "react" auf ("html" für eine statische Seite, "next" für Next.js App Router).
3. Füge den zurückgegebenen Code als Kontaktformular im Stil der restlichen Website ein. Lass access_key, _lang und das Honeypot-Feld botcheck genau so, wie sie in der Antwort stehen.
4. Füge kein Backend, keine API-Route, keine Datenbank und keinen E-Mail-Code hinzu und schreibe das fgp_-Token nie in Projektdateien.

Ergebnis prüfen

  1. Senden Sie eine Testanfrage aus der Bolt-Vorschau oder von der veröffentlichten Website.
  2. Öffnen Sie die Anfrage im Formgong-Posteingang.
  3. Prüfen Sie, dass für das Formular keine Datenbanktabelle und keine Serverfunktion entstanden ist.
  4. Prüfen Sie die veröffentlichte Seite mit dem Formular-Check.

Der Formular-Check liest die veröffentlichte Seite und zeigt konkrete Probleme, zum Beispiel ein Feld ohne name-Attribut oder einen Platzhalter-Schlüssel.

Häufige Fragen

Braucht ein Kontaktformular eine Bolt-Datenbank?

Nein. Formgong speichert die Anfrage und verschickt die E-Mail. Eine Datenbank lohnt sich nur, wenn die App selbst Anfragen anzeigen oder bearbeiten soll.

Funktioniert das Formular, wenn ich die Website aus Bolt umziehe?

Ja. Das Formular ist normales HTML oder ein fetch-Aufruf und funktioniert deshalb bei jedem Hosting: Netlify, Vercel, GitHub Pages oder Ihrem eigenen Server.

Ist der Zugriffsschlüssel im Prompt geheim?

Nein. Der Zugriffsschlüssel (fk_…) ist absichtlich öffentlich. Er erlaubt nur, Anfragen an ein Formular zu senden, und das kann jeder auf Ihrer Website ohnehin. Geheimnisse wie der geheime Turnstile-Schlüssel oder ein Formgong-API-Token (fgp_…) gehören nie in einen Prompt oder ins Frontend.

Wie füge ich meinen echten Schlüssel in den Prompt ein?

Kopieren Sie ihn aus dem Formgong-Dashboard und ersetzen Sie fk_your_access_key. Wenn Sie angemeldet sind, nutzen Sie die Schaltfläche unter dem Prompt. Sie liest Ihre Formulare direkt im Browser aus Ihrem Dashboard und tauscht den Schlüssel aus. Das Tool erhält nichts, bis Sie den Prompt selbst einfügen.

Kontaktformular für Bolt →

Schlüssel holen