Windsurf için prompt: iletişim formu ekleyin

Windsurf için promptu kopyalayın

Projenizde Cascade panelini açın ve promptu yapıştırın. Birden fazla sayfa varsa formun olacağı sayfayı belirtin. Cascade her dosya değişikliğini gösterir; formu ve stillerini kabul edin. Windsurf dokümantasyonu artık Devin Desktop adıyla yayınlanıyor; Cascade ve bu adımlar aynı şekilde çalışır.

Bu workspace'teki mevcut siteye, kendi bileşenleri ve stilleriyle bir iletişim formu ekle. Başvuruları Formgong alır. API route, sunucu fonksiyonu, ortam değişkeni veya e-posta gönderen kod ekleme.

Endpoint: POST https://formgong.com/submit
Gizli access_key alanı (herkese açık anahtar): fk_your_access_key
Alanlar: name, email (type="email"), message; görsel olarak gizli honeypot alanı botcheck (position:absolute;inset-inline-start:0;top:0;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)), tabindex="-1", autocomplete="off".
Düz HTML form (method="POST") veya Accept: application/json ile fetch; başarı json.success === true olduğunda teşekkür mesajı göster ve formu temizle.
Dosya gönderme. Etiketler Türkçe.

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.

Prompt araca ne yaptırır

Prompt araca tek ve kısa bir şartname verir, bu yüzden sonuç öngörülebilir olur:

• Adres: form verileri https://formgong.com/submit adresine gönderir; düz bir HTML formuyla ya da fetch ile.
• Erişim anahtarı: herkese açık anahtarınızı taşıyan gizli bir access_key alanı.
• Alanlar: name, email ve message; email alanında type="email" bulunur.
• Honeypot: insanların görmediği gizli bir botcheck alanı. Botlar bu alanı doldurur ve Formgong bu gönderimleri spam olarak işaretler.
• Başarı durumu: fetch ile teşekkür mesajı yalnızca yanıtta success: true olduğunda görünür. Düz formda Formgong'un teşekkür sayfası ya da _redirect ile kendi sayfanız.
• Turnstile: yalnızca araca bir site key verirseniz eklenir.
• Gizli bilgi ve backend yok: API route, sunucu fonksiyonu, veritabanı ya da e-posta kodu yok.

Windsurf genellikle nerede hata yapar

Cascade tüm çalışma alanına bakar ve çoğu zaman “eksiksiz” bir form için gerekli gördüğü şeyleri ekler: bir API uç noktası, bir e-posta kütüphanesi ve ortam değişkenleri. Prompt, formun yalnızca frontend'de çalıştığını ve verileri Formgong'a gönderdiğini söyler; böylece e-posta kodunu sürdürmeniz gerekmez.

Cascade kurallara da uyar. .windsurfrules parçası sonraki oturumlarda aynı adresi, honeypot'u ve başarı işlemeyi korur.

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

Windsurf MCP sunucularını ~/.codeium/windsurf/mcp_config.json dosyasından okur. Uzak sunucular serverUrl alanını kullanır. Aşağıdaki ayarlar token'ı FORMGONG_TOKEN ortam değişkeninden alır. Kaydettikten sonra Cascade'de MCP listesini yenileyin.

{
  "mcpServers": {
    "formgong": {
      "serverUrl": "https://formgong.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FORMGONG_TOKEN}"
      }
    }
  }
}

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. Değişiklikleri inceleyin: tek bir form; yeni API uç noktası ya da e-posta kütüphanesi yok.
2. Siteyi çalıştırın ve bir test gönderimi yapın.
3. Gönderimi Formgong gelen kutusunda bulun.
4. İsterseniz Formgong kurallarını .windsurfrules dosyasına ekleyin.

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