Форма в Cursor

Попросіть агента не створювати API route. Форма ходить прямо на Formgong.

  1. Відкрийте репозиторій сайту в Cursor.
  2. Вставте промпт.
  3. Перевірте, що немає секретів на сервері заради цієї форми.
  4. Експортуйте 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_ у файли проєкту.

Перевірте результат

  1. Прочитайте diff: один компонент чи секція форми, без нового API route і нового запису в .env.
  2. Запустіть сайт локально й надішліть тестову заявку.
  3. Опублікуйте сайт і перевірте живу сторінку перевіркою форми.
  4. За бажання закомітьте .cursor/rules/formgong.mdc, щоб наступні правки йшли за тими самими правилами.

Перевірка форми читає опубліковану сторінку й показує конкретні проблеми, наприклад поле без атрибута name або ключ-заглушку.

Питання

Чи безпечно комітити ключ доступу?

Так. Ключ доступу дозволяє лише надсилати заявки в цю форму, а це й так може будь-хто на вашому сайті. Він не відкриває вхідні й не змінює налаштувань. API-токен (fgp_…) у репозиторій не кладіть.

Що краще: промпт чи файл правил?

Промпт — один раз, щоб додати форму. Файл правил — якщо проєкт і далі змінюється, щоб Cursor дотримувався тих самих правил щоразу, коли торкається форми.

Ключ доступу в промпті — це секрет?

Ні. Ключ доступу (fk_…) публічний за задумом. Він дозволяє лише надсилати заявки в одну форму, а це й так може зробити будь-хто на вашому сайті. Секрети, як-от секретний ключ Turnstile чи API-токен Formgong (fgp_…), ніколи не мають потрапляти в промпт або фронтенд.

Як підставити в промпт свій справжній ключ?

Скопіюйте його з кабінету Formgong і замініть fk_your_access_key. Якщо ви ввійшли в акаунт, натисніть кнопку під промптом. Вона прочитає ваші форми з вашого кабінету прямо в браузері й підставить ключ. Інструмент нічого не отримає, доки ви самі не вставите промпт.

Форма для Cursor →

Отримати ключ