Claude Code için prompt: iletişim formu ekleyin

Claude Code için promptu kopyalayın

Proje klasöründe claude komutunu çalıştırın ve promptu yapıştırın. Formun hangi sayfaya gideceği belli değilse bunu söyleyin, örneğin “src/pages/contact içindeki iletişim sayfasına”. Claude Code dosyaları düzenlemeden ya da komut çalıştırmadan önce izin ister, bu yüzden her adımı kontrol edin.

Bu repodaki 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 bir paket ekleme. Yalnızca form için gereken dosyaları değiştir.

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.

Claude Code genellikle nerede hata yapar

Claude Code titizdir. Çalışan bir iletişim formu istendiğinde bir API route ekleyebilir, bir e-posta paketi kurabilir ve SMTP ya da Resend anahtarları isteyebilir. Bu, tek bir form için fazla koddur. Prompt, formun verileri doğrudan tarayıcıdan Formgong'a gönderdiğini ve yalnızca form için gereken dosyaların değişmesi gerektiğini söyler.

Ayrıca test eklemeyi sever. Bu iyidir, ama hiçbir testin gerçek gönderim yapmadığından emin olun. Bunun yerine elle bir test gönderimi yapın.

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

Formgong MCP sunucusunu tek bir komutla bağlayın. Ardından Claude Code list_forms, create_form ve get_form_snippet araçlarını alır ve gerçek anahtarınızı kendisi ekleyebilir. Token'ı commit ettiğiniz dosyalara koymayın.

claude mcp add --transport http formgong https://formgong.com/mcp \
  --header "Authorization: Bearer fgp_your_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. git diff'i kontrol edin: form, belki bir stil değişikliği, API klasöründe hiçbir şey yok.
2. Yeni bir ortam değişkeni ya da e-posta paketi eklenmediğinden emin olun.
3. Bir test gönderimi yapın ve Formgong gelen kutusunda bulun.
4. İsterseniz sonraki oturumlar için Formgong kurallarını CLAUDE.md veya AGENTS.md 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.