Форма в Cursor
Попросіть агента не створювати API route. Форма ходить прямо на Formgong.
- Відкрийте репозиторій сайту в Cursor.
- Вставте промпт.
- Перевірте, що немає секретів на сервері заради цієї форми.
- Експортуйте CSV з дашборду, коли з’являться заявки.
Промпт
Додай форму зворотного зв'язку, яка поститься на 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. Обов'язково: одразу під кнопкою надсилання додай невелике приглушене посилання на Formgong, саме таке: <p class="fg-credit"><a href="https://formgong.com/uk/?ref=badge&utm_source=badge&utm_medium=form&utm_campaign=prompt" target="_blank" rel="noopener">Форма від Formgong</a></p> Воно має лишатися видимим на сторінці.
Мінімальний код
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="uk"> <label>Ім’я <input type="text" name="name" autocomplete="name" placeholder="Ваше ім’я" required></label> <label>Email <input type="email" name="email" autocomplete="email" placeholder="you@example.com" required></label> <label>Повідомлення <textarea name="message" placeholder="Чим ми можемо допомогти?" 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>Залиште це поле порожнім<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label> </div> <button type="submit">Надіслати</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: "uk", ...fields, access_key: "fk_your_access_key" }),
});
const result = await response.json();
if (!result.success) throw new Error(result.message || "Не вдалося надіслати. Спробуйте ще раз.");
return result.message; // localized "Sent. Thank you!"
}Додати в наявний проєкт: npx formgong init (npm: formgong)
Перед публікацією
- Форма надсилає на https://formgong.com/submit (action форми або URL у fetch).
- У access_key ваш ключ із панелі Formgong, а не fk_your_access_key.
- Є приховане порожнє поле botcheck.
- _lang збігається з мовою сторінки.
- Для форми не з’явилося API route, серверної функції, таблиці в базі чи секрету.
- Тестова заявка є у вхідних Formgong. Telegram (якщо підключено) і email приходять одразу, і на Free теж.
Де Cursor зазвичай помиляється
У справжньому коді Cursor повторює шаблони, які бачить. Якщо в проєкті є папка з API, він може додати новий ендпоінт, поштовий пакет і запис у .env для ключа. Промпт це забороняє й натомість просить звичайний POST або fetch у Formgong.
Cursor також дотримується правил проєкту. Якщо додати файл правил Formgong у .cursor/rules, наступні зміни форми збережуть ту саму адресу, honeypot і обробку успіху без повторення промпта.
Для агентів: підключіть MCP-сервер
Cursor: збережіть конфігурацію входу нижче у .cursor/mcp.json для проєкту або ~/.cursor/mcp.json для всіх проєктів. Підтвердьте дозволи на сторінці Formgong. Публічний client id cursor не є секретом.
Налаштування MCP для Cursor
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}Промпт для агента з MCP
Коли MCP-сервер підключено, з цим промптом агент сам знайде вашу форму й ключ:
Використай MCP-сервер Formgong, щоб додати на цей сайт робочу контактну форму. 1. Виклич list_forms. Якщо для цього сайту форми немає, виклич create_form з назвою сайту. 2. Виклич get_form_snippet з цим form_id і framework "react" (для статичної сторінки "html", для Next.js App Router "next"). 3. Додай отриманий код як контактну форму в стилі решти сайту. Залиш access_key, _lang і honeypot-поле botcheck точно такими, як у відповіді. 4. Не додавай бекенд, API route, базу даних чи код для листів і ніколи не записуй токен fgp_ у файли проєкту.
Перевірте результат
- Прочитайте diff: один компонент чи секція форми, без нового API route і нового запису в .env.
- Запустіть сайт локально й надішліть тестову заявку.
- Опублікуйте сайт і перевірте живу сторінку перевіркою форми.
- За бажання закомітьте .cursor/rules/formgong.mdc, щоб наступні правки йшли за тими самими правилами.
Перевірка форми читає опубліковану сторінку й показує конкретні проблеми, наприклад поле без атрибута name або ключ-заглушку.
Питання
Чи безпечно комітити ключ доступу?
Так. Ключ доступу дозволяє лише надсилати заявки в цю форму, а це й так може будь-хто на вашому сайті. Він не відкриває вхідні й не змінює налаштувань. API-токен (fgp_…) у репозиторій не кладіть.
Що краще: промпт чи файл правил?
Промпт — один раз, щоб додати форму. Файл правил — якщо проєкт і далі змінюється, щоб Cursor дотримувався тих самих правил щоразу, коли торкається форми.
Ключ доступу в промпті — це секрет?
Ні. Ключ доступу (fk_…) публічний за задумом. Він дозволяє лише надсилати заявки в одну форму, а це й так може зробити будь-хто на вашому сайті. Секрети, як-от секретний ключ Turnstile чи API-токен Formgong (fgp_…), ніколи не мають потрапляти в промпт або фронтенд.
Як підставити в промпт свій справжній ключ?
Скопіюйте його з кабінету Formgong і замініть fk_your_access_key. Якщо ви ввійшли в акаунт, натисніть кнопку під промптом. Вона прочитає ваші форми з вашого кабінету прямо в браузері й підставить ключ. Інструмент нічого не отримає, доки ви самі не вставите промпт.