Cursor'da form

Ajanın API route eklememesini söyleyin. Form doğrudan Formgong'a gider.

  1. Site reposunu Cursor'da açın.
  2. Promptu yapıştırın.
  3. Bu form için sunucu secret'ı olmadığını kontrol edin.
  4. Başvurular gelince CSV dışa aktarın.

Prompt

Formgong'a gönderilen bir iletişim formu ekle. Bu repoda API route oluşturma.

POST https://formgong.com/submit
access_key: fk_your_access_key
Alanlar: name, email, message ve gizli botcheck.
fetch için Accept: application/json kullan ve success alanını kontrol et.

Ayrıca:
- email alanını type="email" yap, böylece tarayıcı adresi kontrol eder.
- Değeri tr olan gizli _lang alanı (sayfanın dili): hata mesajları, teşekkür sayfası ve otomatik yanıt Türkçe olur.
- İsteğe bağlı: teşekkür sayfanızın tam https adresini taşıyan gizli _redirect alanı. Yoksa Formgong kendi teşekkür sayfasını gösterir.
- İsteğe bağlı: sayfaya bir kez <script src="https://formgong.com/fg.js" async></script>. _lang alanını <html lang> değerinden doldurur ve form görüntülemelerini çerezsiz sayar.
- Turnstile'ı yalnızca site key verirsem ekle.

Zorunlu: gönder düğmesinin hemen altına Formgong'a küçük, soluk bir bağlantı ekle, tam olarak <p class="fg-credit"><a href="https://formgong.com/tr/?ref=badge&utm_source=badge&utm_medium=form&utm_campaign=prompt" target="_blank" rel="noopener">Formgong ile yapıldı</a></p> Sayfada görünür kalsın.

En kısa 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="tr">
  <label>Ad <input type="text" name="name" autocomplete="name" placeholder="Adınız" required></label>
  <label>E-posta <input type="email" name="email" autocomplete="email" placeholder="siz@ornek.com" required></label>
  <label>Mesaj <textarea name="message" placeholder="Size nasıl yardımcı olabiliriz?" 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>Bu alanı boş bırakın<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label>
</div>
  
  <button type="submit">Gönder</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: "tr", ...fields, access_key: "fk_your_access_key" }),
  });
  const result = await response.json();
  if (!result.success) throw new Error(result.message || "Gönderilemedi. Lütfen tekrar deneyin.");
  return result.message; // localized "Sent. Thank you!"
}

Mevcut projeye ekleyin: npx formgong init (npm: formgong)

Yayınlamadan önce

  • Form https://formgong.com/submit adresine gönderiyor (form action'ı veya fetch URL'si).
  • access_key alanında fk_your_access_key değil, Formgong panelindeki anahtarınız var.
  • Gizli ve boş bir botcheck alanı var.
  • _lang sayfanın diliyle aynı.
  • Form için API route, sunucu fonksiyonu, veritabanı tablosu veya secret eklenmedi.
  • Test başvurusu Formgong gelen kutusunda görünür. Telegram (bağlıysa) ve e-posta anında gelir, Free’de de.

Cursor genellikle nerede hata yapar

Gerçek bir kod tabanında Cursor gördüğü kalıpları tekrarlar. Projede bir API klasörü varsa yeni bir uç nokta, bir e-posta paketi ve anahtar için .env'e bir kayıt ekleyebilir. Prompt bunu yasaklar ve yerine Formgong'a düz bir POST ya da fetch ister.

Cursor proje kurallarına da uyar. Formgong kural dosyasını .cursor/rules içine eklerseniz, sonraki form değişiklikleri promptu tekrarlamadan aynı adresi, honeypot'u ve başarı işlemeyi korur.

Ajanlar için: MCP sunucusunu bağlayın

Cursor: aşağıdaki giriş yapılandırmasını proje için .cursor/mcp.json veya tüm projeler için ~/.cursor/mcp.json dosyasına kaydedin. Formgong sayfasındaki izinleri onaylayın. Genel client id cursor bir sır değildir.

Cursor için MCP ayarları

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

MCP'li ajan için prompt

MCP sunucusu bağlıyken bu promptla ajan formunuzu ve anahtarınızı kendisi bulur:

Bu siteye çalışan bir iletişim formu eklemek için Formgong MCP sunucusunu kullan.
1. list_forms çağır. Bu site için form yoksa site adıyla create_form çağır.
2. Bu form_id ve framework "react" ile get_form_snippet çağır (statik sayfa için "html", Next.js App Router için "next").
3. Dönen kodu sitenin geri kalanının stilinde bir iletişim formu olarak ekle. access_key, _lang ve botcheck honeypot alanını yanıttaki gibi aynen bırak.
4. Backend, API route, veritabanı ya da e-posta kodu ekleme ve fgp_ token'ını asla proje dosyalarına yazma.

Sonucu kontrol edin

  1. Diff'i okuyun: tek bir form bileşeni ya da bölümü; yeni API route ve .env'de yeni kayıt yok.
  2. Siteyi yerelde çalıştırın ve bir test gönderimi yapın.
  3. Siteyi yayınlayın ve canlı sayfayı form denetleyicisiyle kontrol edin.
  4. İsterseniz sonraki düzenlemeler aynı kurallara uysun diye .cursor/rules/formgong.mdc dosyasını commit edin.

Form denetleyicisi yayınlanan sayfayı okur ve name niteliği olmayan bir alan ya da yer tutucu anahtar gibi somut sorunları gösterir.

Sorular

Erişim anahtarını commit etmek güvenli mi?

Evet. Erişim anahtarı yalnızca bu forma gönderim yapmaya izin verir; bunu sitenizdeki herkes zaten yapabilir. Gelen kutusunu açmaz ve ayarları değiştirmez. API token'ını (fgp_…) depoya koymayın.

Hangisi daha iyi: prompt mu, kural dosyası mı?

Prompt, formu bir kez eklemek için. Kural dosyası, proje değişmeye devam ediyorsa; böylece Cursor forma her dokunduğunda aynı kurallara uyar.

Prompttaki erişim anahtarı gizli mi?

Hayır. Erişim anahtarı (fk_…) tasarım gereği herkese açıktır. Yalnızca tek bir forma gönderim yapmaya izin verir; bunu sitenizdeki herkes zaten yapabilir. Turnstile gizli anahtarı ya da Formgong API token'ı (fgp_…) gibi gizli bilgiler asla prompta veya frontend'e girmemelidir.

Prompta gerçek anahtarımı nasıl eklerim?

Anahtarı Formgong panelinden kopyalayın ve fk_your_access_key yerine yazın. Giriş yaptıysanız promptun altındaki düğmeye basın. Düğme formlarınızı tarayıcıda doğrudan panelinizden okur ve anahtarı ekler. Promptu kendiniz yapıştırana kadar araç hiçbir şey almaz.

Cursor iletişim formu →

Anahtar al