Formulário de contacto para Cursor
Formgong team ·
Cole isto no Cursor. Os envios vão para o Formgong. Sem base de dados e sem Resend.
250 envios grátis por mês
Como funcionam os formulários em Cursor
O Cursor edita o código no seu próprio repositório, pelo que o resultado depende da sua pilha de tecnologias e dos hábitos do agente. Quando solicitado um formulário de contacto, o agente adiciona frequentemente uma rota de API, uma biblioteca de e-mail como o Nodemailer ou o Resend e novas variáveis de ambiente com credenciais SMTP ou de API.
Pode manter o repositório mais pequeno: o formulário envia os dados para https://formgong.com/submit a partir do navegador. O Cursor também pode comunicar com o Formgong através do seu servidor MCP, pelo que o agente pode criar o formulário e obter o snippet correto por si próprio.
Configuração em Cursor
- Crie um formulário no Formgong e copie a chave de acesso, ou deixe que o agente o faça através do MCP (próximo passo).
- Opcional: crie um token de API pessoal no Formgong (Conta → Tokens de API) e adicione o servidor MCP remoto
https://formgong.com/mcpnas definições do MCP do Cursor. O agente poderá então listar formulários, criar um e obter o seu snippet. - Cole o prompt abaixo no chat do agente. Este solicita apenas um formulário front-end: sem rota de API, sem biblioteca de e-mail, sem novos segredos.
- Analise as alterações antes de as aceitar. O formulário deve enviar os dados para o Formgong e incluir
access_key,_lange o campo ocultobotcheck. - Para que assim se mantenha, adicione uma regra de projeto em
.cursor/rules(ouAGENTS.md): «Os formulários enviam os dados para o Formgong; não adicione código de backend para os formulários.»
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.
Adicionar a um projeto existente: npx formgong init (npm: formgong)
Formgong ou na sua própria rota de API?
Crie o seu próprio fluxo quando o envio tiver de executar a sua lógica de negócio: gravar na sua base de dados, verificar se o utilizador está autenticado ou chamar serviços internos.
Utilize o Formgong quando o formulário precisar apenas de chegar até si de forma fiável. A filtragem de spam, o envio por e-mail e pelo Telegram, as tentativas de reenvio para webhooks e a caixa de entrada já estão implementados.
Perguntas e respostas
Preciso do servidor MCP?
Não. A instrução por si só é suficiente. O MCP é útil quando pretende que o agente crie formulários e recupere trechos de código sem ter de copiar chaves manualmente.
O token da API é o mesmo que a chave de acesso?
Não. A chave de acesso (fk_…) é pública e deve ser inserida no formulário. O token da API (fgp_…) é privado: mantenha-o nas definições do Cursor, nunca no repositório.
Com que frameworks é que isto funciona?
Qualquer um. O agente adapta o trecho à sua pilha de tecnologias; o endpoint e os nomes dos campos permanecem os mesmos.