نموذج تواصل لـ Cursor
Formgong team ·
الصق هذا في Cursor. الطلبات تذهب إلى Formgong. بلا قاعدة بيانات وبلا Resend.
250 طلب مجاني في الشهر
كيف تعمل النماذج في Cursor
يقوم Cursor بتحرير الكود في مستودعك الخاص، لذا فإن النتيجة تعتمد على مكدسك وعادات الوكيل. عند طلب نموذج اتصال، غالبًا ما يضيف الوكيل مسار API، ومكتبة بريد إلكتروني مثل Nodemailer أو Resend، ومتغيرات بيئة جديدة مع بيانات اعتماد SMTP أو API.
يمكنك الحفاظ على حجم المستودع أصغر: يقوم النموذج بالنشر إلى https://formgong.com/submit من المتصفح. يمكن لـ Cursor أيضًا التواصل مع Formgong عبر خادم MCP الخاص به، بحيث يمكن للوكيل إنشاء النموذج وجلب المقتطف الصحيح بنفسه.
الإعداد في Cursor
- أنشئ نموذجًا في Formgong وانسخ مفتاح الوصول، أو دع الوكيل يقوم بذلك عبر MCP (الخطوة التالية).
- اختياري: قم بإنشاء رمز API شخصي في Formgong (الحساب → رموز API) وأضف خادم MCP البعيد
https://formgong.com/mcpفي إعدادات MCP في Cursor. يمكن للوكيل بعد ذلك عرض قائمة بالنماذج، وإنشاء نموذج والحصول على مقتطفه. - الصق الموجّه أدناه في دردشة الوكيل. وهو يطلب نموذج واجهة المستخدم فقط: بدون مسار API، وبدون مكتبة بريد إلكتروني، وبدون أسرار جديدة.
- راجع الفروق قبل قبولها. يجب أن يتم إرسال النموذج إلى Formgong وأن يتضمن
access_keyو_langوالحقل المخفيbotcheck. - للحفاظ على ذلك، أضف قاعدة مشروع في
.cursor/rules(أوAGENTS.md): «يتم إرسال النماذج إلى Formgong؛ لا تضف كودًا خلفيًا للنماذج.»
Add a contact form to the existing site in this repo, using its current components and styles. Submissions go to Formgong, a hosted form backend. Do not create an API route, serverless function, or environment variable for this form. Formgong spec (follow exactly): - Plain HTML: <form action="https://formgong.com/submit" method="POST">. With JavaScript, POST the same fields to https://formgong.com/submit using fetch. - Hidden field access_key with value fk_your_access_key. The key is public and belongs in frontend code. Do not move it to a server or a secret. - Hidden field _lang with the page language code, e.g. "en" (on multilingual sites use document.documentElement.lang). Formgong uses it for error messages, the thank-you page, and the autoreply. - Fields: name, email, message (required); phone is optional. Keep these field names, and use <input type="email"> for email so browsers check the address. - Honeypot: <input type="text" name="botcheck" tabindex="-1" autocomplete="off"> inside a wrapper with aria-hidden="true", visually hidden with CSS (position:absolute;inset-inline-start:0;top:0;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)). Never fill it. - Success, plain form POST: optionally add a hidden _redirect field with the absolute https URL of the site's thank-you page. Without it, Formgong shows its own thank-you page. - Success, fetch: send Accept: application/json (and Content-Type: application/json for a JSON body; for FormData let the browser set it). If the response has success === true, show an inline thank-you message and reset the form; otherwise show the response's message. - Turnstile: only if I give you a Cloudflare Turnstile site key, add <script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script> and <div class="cf-turnstile" data-sitekey="SITE_KEY"></div> inside the form. Otherwise leave it out. - Optional: add <script src="https://formgong.com/fg.js" async></script> once per page. It fills _lang from <html lang>, sets the Turnstile language, and counts form views without cookies. - Do not create a backend, API route, server function, database table, or email-sending code (Supabase, Resend, SendGrid, nodemailer), and do not add secrets. No file uploads.
Додай форму зворотного зв'язку, яка поститься на Formgong. Не створюй API route у цьому репозиторії. Endpoint: POST https://formgong.com/submit access_key (публічний): fk_your_access_key Поля: name, email, message, приховане botcheck. Приймай і application/x-www-form-urlencoded, і JSON. Для fetch став Accept: application/json і перевір success. Файли не відправляй. Підписи полів українською. Додатково: - Поле email роби з type="email", щоб браузер перевіряв адресу. - Приховане поле _lang зі значенням uk (мова сторінки): так помилки, сторінка подяки й автовідповідь будуть українською. - Необов'язково: приховане поле _redirect з повною https-адресою вашої сторінки подяки. Без нього Formgong покаже власну сторінку подяки. - Необов'язково: <script src="https://formgong.com/fg.js" async></script> один раз на сторінці. Він підставляє _lang з <html lang> і рахує перегляди форми без cookies. - Turnstile додавай лише тоді, коли я дам site key.
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.
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.
Añade un formulario de contacto que envíe a Formgong. No crees una ruta de API en este repositorio. POST https://formgong.com/submit access_key: fk_your_access_key Campos: name, email, message y botcheck oculto. En fetch, envía Accept: application/json y comprueba success.
Ajoute un formulaire de contact vers Formgong. Ne crée pas de route API dans ce dépôt. POST https://formgong.com/submit access_key : fk_your_access_key Champs : name, email, message et botcheck caché. Pour fetch, envoie Accept: application/json et vérifie success.
Adiciona um formulário de contacto para o Formgong. Não cries uma rota de API neste repositório. POST https://formgong.com/submit access_key: fk_your_access_key Campos: name, email, message e botcheck oculto. No fetch, envia Accept: application/json e verifica success.
أضف نموذج تواصل يرسل إلى Formgong. لا تنشئ مسار API في هذا المستودع. POST https://formgong.com/submit access_key: fk_your_access_key الحقول: name وemail وmessage وbotcheck مخفي. مع fetch أرسل Accept: application/json وتحقق من success.
הוסף טופס יצירת קשר שנשלח ל-Formgong. אל תיצור נתיב API במאגר הזה. POST https://formgong.com/submit access_key: fk_your_access_key שדות: name, email, message ו-botcheck נסתר. ב-fetch שלח Accept: application/json ובדוק את success.
Formgong को भेजने वाला संपर्क फ़ॉर्म जोड़ो। इस रिपो में API रूट मत बनाओ। POST https://formgong.com/submit access_key: fk_your_access_key फ़ील्ड: name, email, message और छिपा botcheck। fetch में Accept: application/json भेजो और success जाँचो।
Formgong に送る問い合わせフォームを追加してください。このリポジトリに API ルートは作らないでください。 POST https://formgong.com/submit access_key: fk_your_access_key 項目: name, email, message と隠し botcheck。 fetch では Accept: application/json を送り、success を確認する。
Füge ein Kontaktformular hinzu, das an Formgong sendet. Lege in diesem Repository keine API-Route an. Endpoint: POST https://formgong.com/submit Öffentlicher access_key: fk_your_access_key Felder: name, email, message und ein verstecktes Honeypot-Feld botcheck. Unterstütze sowohl normale HTML-Formular-POSTs als auch JSON per fetch. Für fetch Accept: application/json senden und success prüfen. Keine Dateien senden. Beschriftungen auf Deutsch. Zusätzlich: - Das Feld email mit type="email" anlegen, damit der Browser die Adresse prüft. - Verstecktes Feld _lang mit dem Wert de (Sprache der Seite): Fehlermeldungen, Danke-Seite und automatische Antwort erscheinen dann auf Deutsch. - Optional: verstecktes Feld _redirect mit der vollständigen https-Adresse deiner Danke-Seite. Ohne dieses Feld zeigt Formgong eine eigene Danke-Seite. - Optional: <script src="https://formgong.com/fg.js" async></script> einmal pro Seite. Es setzt _lang aus <html lang> und zählt Formularansichten ohne Cookies. - Turnstile nur einbauen, wenn ich dir einen Site Key gebe.
أضف إلى مشروع قائم: npx formgong init (npm: formgong)
Formgong أم مسار واجهة برمجة التطبيقات (API) الخاص بك؟
قم ببناء مسارك الخاص عندما يتعين على الطلب تنفيذ منطق عملك: الكتابة إلى قاعدة البيانات الخاصة بك، أو التحقق من المستخدم المسجل، أو استدعاء الخدمات الداخلية.
استخدم Formgong عندما تحتاج فقط إلى أن يصل النموذج إليك بشكل موثوق. فقد تم بالفعل توفير تصفية الرسائل غير المرغوب فيها، والتسليم عبر البريد الإلكتروني وTelegram، وإعادة المحاولة لـ Webhook وصندوق الوارد.
أسئلة وأجوبة
هل أحتاج إلى خادم MCP؟
لا. الموجّه وحده كافي. يُعد MCP مفيدًا عندما تريد من الوكيل إنشاء النماذج واسترداد المقتطفات دون نسخ المفاتيح يدويًّا.
هل رمز API هو نفسه مفتاح الوصول؟
لا. مفتاح الوصول (fk_…) عام ويتم إدخاله في النموذج. أما رمز API (fgp_…) فهو خاص: احتفظ به في إعدادات Cursor، ولا تضعه أبدًا في المستودع.
ما هي أطر العمل التي يعمل معها هذا النظام؟
أي شيء. يقوم الوكيل بتكييف المقتطف مع نظامك؛ بينما تظل أسماء نقاط النهاية والحقول كما هي.