Formular in Cursor
Weisen Sie den Agenten an, keine API-Route anzulegen. Das Formular kommuniziert direkt mit Formgong.
- Öffnen Sie das Repository der Website in Cursor.
- Fügen Sie den Prompt ein.
- Prüfen Sie, dass für dieses Formular kein Server-Secret angelegt wurde.
- Exportieren Sie eine CSV-Datei aus dem Dashboard, sobald Anfragen eingehen.
Prompt
Füge ein Kontaktformular hinzu, das an Formgong sendet. Lege in diesem Repository keine API-Route an. Endpoint: POST https://formgong.com/submit Öffentlicher access_key: fk_your_access_key Felder: name, email, message und ein verstecktes Honeypot-Feld botcheck. Unterstütze sowohl normale HTML-Formular-POSTs als auch JSON per fetch. Für fetch Accept: application/json senden und success prüfen. Keine Dateien senden. Beschriftungen 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
HTML
<form action="https://formgong.com/submit" method="POST"> <input type="hidden" name="access_key" value="fk_your_access_key"> <input type="hidden" name="_lang" value="de"> <label>Name <input type="text" name="name" autocomplete="name" placeholder="Ihr Name" required></label> <label>E-Mail <input type="email" name="email" autocomplete="email" placeholder="name@beispiel.de" required></label> <label>Nachricht <textarea name="message" placeholder="Wie können wir Ihnen helfen?" required></textarea></label> <div aria-hidden="true" style="position:absolute;inset-inline-start:0;top:0;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)"> <label>Lassen Sie dieses Feld leer<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label> </div> <button type="submit">Senden</button> </form>
fetch
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",
},
// _lang: language of Formgong messages and the autoreply (multilingual site: document.documentElement.lang).
body: JSON.stringify({ _lang: "de", ...fields, access_key: "fk_your_access_key" }),
});
const result = await response.json();
if (!result.success) throw new Error(result.message || "Das Senden ist fehlgeschlagen. Bitte versuchen Sie es erneut.");
return result.message; // localized "Sent. Thank you!"
}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 Cursor meist danebenliegt
In echtem Code wiederholt Cursor die Muster, die es sieht. Hat das Projekt einen API-Ordner, fügt es vielleicht einen neuen Endpunkt, ein E-Mail-Paket und einen .env-Eintrag für den Schlüssel hinzu. Der Prompt schließt das aus und verlangt stattdessen einen einfachen POST oder fetch an Formgong.
Cursor befolgt auch Projektregeln. Legen Sie die Formgong-Regeldatei in .cursor/rules ab, behalten spätere Änderungen am Formular dieselbe Adresse, den Honeypot und die Erfolgsbehandlung, ohne dass Sie den Prompt wiederholen.
Für Agenten: MCP-Server verbinden
Cursor: Speichern Sie die Anmeldekonfiguration unten in .cursor/mcp.json für das Projekt oder ~/.cursor/mcp.json für alle Projekte. Bestätigen Sie die Berechtigungen auf der Formgong-Seite. Die öffentliche client id cursor ist kein Geheimnis.
MCP-Einstellungen für Cursor
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}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
- Lesen Sie den Diff: eine Formularkomponente oder ein Abschnitt, keine neue API-Route und kein neuer .env-Eintrag.
- Starten Sie die Website lokal und senden Sie eine Testanfrage.
- Veröffentlichen Sie und prüfen Sie die Live-Seite mit dem Formular-Check.
- Committen Sie optional .cursor/rules/formgong.mdc, damit spätere Änderungen denselben Regeln folgen.
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
Ist es sicher, den Zugriffsschlüssel zu committen?
Ja. Der Zugriffsschlüssel erlaubt nur, Anfragen an dieses Formular zu senden, und das kann jeder auf Ihrer Website ohnehin. Er öffnet nicht den Posteingang und ändert keine Einstellungen. Ein API-Token (fgp_…) gehört nicht ins Repository.
Was ist besser: Prompt oder Regeldatei?
Der Prompt einmal, um das Formular hinzuzufügen. Die Regeldatei, wenn sich das Projekt weiter ändert, damit Cursor jedes Mal dieselben Regeln befolgt, wenn es das Formular anfasst.
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.