Formularz kontaktowy dla Cursor

Formgong team ·

Wklej to do Cursor. Zgłoszenia idą do Formgong. Bez bazy i bez Resend.

250 zgłoszeń miesięcznie za darmo

Jak działają formularze w Cursor

Cursor edytuje kod w Twoim repozytorium, więc wynik zależy od stosu i od nawyków agenta. Poproszony o formularz kontaktowy, agent często dodaje API route, bibliotekę do maili w rodzaju Nodemailer lub Resend i nowe zmienne środowiskowe z danymi SMTP albo kluczami API.

Repozytorium może być mniejsze: formularz wysyła dane z przeglądarki na https://formgong.com/submit. Cursor może też rozmawiać z Formgong przez serwer MCP, więc agent sam utworzy formularz i pobierze właściwy fragment kodu.

Konfiguracja w Cursor

  1. Utwórz formularz w Formgong i skopiuj klucz dostępu albo zleć to agentowi przez MCP (następny krok).
  2. Opcjonalnie: utwórz osobisty token API w Formgong (Konto → Tokeny API) i dodaj zdalny serwer MCP https://formgong.com/mcp w ustawieniach MCP w Cursor. Agent będzie mógł wtedy listować formularze, tworzyć nowe i pobierać ich kod.
  3. Wklej poniższy prompt do czatu agenta. Prosi tylko o formularz we frontendzie: bez API route, bez biblioteki do maili, bez nowych sekretów.
  4. Przejrzyj diff, zanim go zaakceptujesz. Formularz powinien wysyłać dane do Formgong i zawierać access_key, _lang oraz ukryte pole botcheck.
  5. Żeby tak zostało, dodaj regułę projektu w .cursor/rules (albo w AGENTS.md): „Formularze wysyłają dane do Formgong; nie dodawaj kodu backendu dla formularzy”.

Instrukcja krok po kroku w dokumentacji

Cursor
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.

Dodaj do istniejącego projektu: npx formgong init (npm: formgong)

Formgong czy własne API route?

Zbuduj własną trasę, gdy zgłoszenie ma uruchomić Twoją logikę biznesową: zapis do bazy, sprawdzenie zalogowanego użytkownika, wywołanie wewnętrznych usług.

Wybierz Formgong, gdy formularz ma po prostu niezawodnie do Ciebie dotrzeć. Filtr spamu, dostarczanie na maila i Telegram, ponawianie webhooków i skrzynka są już gotowe.

Pytania i odpowiedzi

Czy serwer MCP jest konieczny?

Nie. Sam prompt wystarczy. MCP przydaje się, gdy agent ma tworzyć formularze i pobierać kod bez ręcznego kopiowania kluczy.

Czy token API to to samo co klucz dostępu?

Nie. Klucz dostępu (fk_…) jest publiczny i trafia do formularza. Token API (fgp_…) jest prywatny: trzymaj go w ustawieniach Cursor, nigdy w repozytorium.

Z jakimi frameworkami to działa?

Z każdym. Agent dopasuje kod do Twojego stosu; adres i nazwy pól są takie same.

Zacznij za darmo