Formularz w Cursor
Poproś agenta, żeby nie dodawał API route. Formularz idzie prosto do Formgong.
- Otwórz repozytorium w Cursor.
- Wklej prompt.
- Upewnij się, że nie ma sekretu serwerowego dla tej formy.
- Eksportuj CSV z panelu.
Prompt
Dodaj formularz kontaktowy wysyłany do Formgong. Nie twórz API route w tym repozytorium. POST https://formgong.com/submit access_key: fk_your_access_key Pola: name, email, message, ukryte botcheck. Dla fetch ustaw Accept: application/json i sprawdź success. Dodatkowo: - Pole email ustaw jako type="email", żeby przeglądarka sprawdzała adres. - Ukryte pole _lang o wartości pl (język strony): komunikaty błędów, strona z podziękowaniem i autoodpowiedź będą po polsku. - Opcjonalnie: ukryte pole _redirect z pełnym adresem https Twojej strony z podziękowaniem. Bez niego Formgong pokaże własną stronę z podziękowaniem. - Opcjonalnie: <script src="https://formgong.com/fg.js" async></script> raz na stronie. Uzupełnia _lang z <html lang> i liczy wyświetlenia formularza bez cookies. - Turnstile dodaj tylko wtedy, gdy podam site key. Obowiązkowo: bezpośrednio pod przyciskiem wysyłania dodaj mały, stonowany link do Formgong, dokładnie <p class="fg-credit"><a href="https://formgong.com/pl/?ref=badge&utm_source=badge&utm_medium=form&utm_campaign=prompt" target="_blank" rel="noopener">Formularz od Formgong</a></p> Ma pozostać widoczny na stronie.
Minimalny kod
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="pl"> <label>Imię <input type="text" name="name" autocomplete="name" placeholder="Twoje imię" required></label> <label>E-mail <input type="email" name="email" autocomplete="email" placeholder="ty@example.com" required></label> <label>Wiadomość <textarea name="message" placeholder="W czym możemy pomóc?" 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>Pozostaw to pole puste<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label> </div> <button type="submit">Wyślij</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: "pl", ...fields, access_key: "fk_your_access_key" }),
});
const result = await response.json();
if (!result.success) throw new Error(result.message || "Nie udało się wysłać. Spróbuj ponownie.");
return result.message; // localized "Sent. Thank you!"
}Dodaj do istniejącego projektu: npx formgong init (npm: formgong)
Przed publikacją
- Formularz wysyła na https://formgong.com/submit (action formularza albo URL w fetch).
- W access_key jest Twój klucz z panelu Formgong, a nie fk_your_access_key.
- Jest ukryte, puste pole botcheck.
- _lang zgadza się z językiem strony.
- Dla formularza nie powstała trasa API, funkcja serwerowa, tabela w bazie ani sekret.
- Testowe zgłoszenie widać w skrzynce Formgong. Telegram (jeśli połączony) i e-mail przychodzą od razu, także w Free.
Gdzie Cursor zwykle się myli
W prawdziwym kodzie Cursor powtarza wzorce, które widzi. Jeśli projekt ma folder API, może dodać nowy endpoint, pakiet do e-maili i wpis w .env na klucz. Prompt to wyklucza i prosi zamiast tego o zwykły POST albo fetch do Formgong.
Cursor stosuje też reguły projektu. Jeśli dodasz plik reguł Formgong do .cursor/rules, kolejne zmiany formularza zachowają ten sam adres, honeypot i obsługę sukcesu bez powtarzania promptu.
Dla agentów: podłącz serwer MCP
Cursor: zapisz konfigurację logowania poniżej w .cursor/mcp.json dla projektu lub ~/.cursor/mcp.json dla wszystkich projektów. Zatwierdź uprawnienia na stronie Formgong. Publiczny client id cursor nie jest sekretem.
Ustawienia MCP dla Cursor
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}Prompt dla agenta z MCP
Gdy serwer MCP jest podłączony, z tym promptem agent sam znajdzie Twój formularz i klucz:
Użyj serwera MCP Formgong, żeby dodać do tej strony działający formularz kontaktowy. 1. Wywołaj list_forms. Jeśli dla tej strony nie ma formularza, wywołaj create_form z nazwą strony. 2. Wywołaj get_form_snippet z tym form_id i framework "react" (dla strony statycznej "html", dla Next.js App Router "next"). 3. Dodaj zwrócony kod jako formularz kontaktowy w stylu reszty strony. Zostaw access_key, _lang i pole honeypot botcheck dokładnie tak, jak w odpowiedzi. 4. Nie dodawaj backendu, API route, bazy danych ani kodu do e-maili i nigdy nie zapisuj tokenu fgp_ w plikach projektu.
Sprawdź wynik
- Przeczytaj diff: jeden komponent lub sekcja formularza, bez nowego API route i nowego wpisu w .env.
- Uruchom stronę lokalnie i wyślij zgłoszenie testowe.
- Opublikuj i sprawdź działającą stronę sprawdzarką formularzy.
- Opcjonalnie zacommituj .cursor/rules/formgong.mdc, żeby kolejne zmiany trzymały się tych samych reguł.
Sprawdzarka formularzy czyta opublikowaną stronę i pokazuje konkretne problemy, na przykład pole bez atrybutu name albo klucz-zaślepkę.
Pytania
Czy commitowanie klucza dostępu jest bezpieczne?
Tak. Klucz dostępu pozwala tylko wysyłać zgłoszenia do tego formularza, co i tak może zrobić każdy na Twojej stronie. Nie otwiera skrzynki i nie zmienia ustawień. Tokenu API (fgp_…) nie umieszczaj w repozytorium.
Lepszy prompt czy plik reguł?
Prompt raz, żeby dodać formularz. Plik reguł, jeśli projekt dalej się zmienia, żeby Cursor trzymał się tych samych reguł za każdym razem, gdy dotyka formularza.
Czy klucz dostępu w prompcie jest tajny?
Nie. Klucz dostępu (fk_…) jest publiczny z założenia. Pozwala tylko wysyłać zgłoszenia do jednego formularza, a to i tak może zrobić każdy na Twojej stronie. Sekrety, takie jak tajny klucz Turnstile albo token API Formgong (fgp_…), nigdy nie mogą trafić do promptu ani do frontendu.
Jak wstawić do promptu swój prawdziwy klucz?
Skopiuj go z panelu Formgong i zamień fk_your_access_key. Jeśli jesteś zalogowany, użyj przycisku pod promptem. Odczytuje on Twoje formularze z Twojego panelu w przeglądarce i podmienia klucz. Narzędzie AI niczego nie dostaje, dopóki sam nie wkleisz promptu.
Formularz kontaktowy dla Cursor →