MCP-сервер Formgong
Підключіть Formgong до Cursor, Claude, VS Code, Lovable чи Bolt. AI-асистент зможе створити форму, отримати готовий код із правильним ключем доступу та переглянути останні заявки — без ручного копіювання ключів.
URL: https://formgong.com/mcp · Streamable HTTP · OAuth 2.1 or Authorization: Bearer fgp_…
Інструменти
- list_forms — ваші форми з публічними ключами доступу й кількістю заявок за місяць.
- create_form — нова форма; заявки йдуть на email акаунта. Telegram і додаткових отримувачів підключають у кабінеті (інструмент повертає посилання).
- get_form_snippet — код HTML, React або Next.js для однієї форми з ключем, _lang, honeypot botcheck і Turnstile, якщо він увімкнений.
- list_recent_submissions — лише читання й лише за окремим дозволом: час і поля заявки, без спаму за замовчуванням, до 50.
- list_webhooks, create_webhook, delete_webhook — керування вебхуками форми, щоб n8n, Make чи Zapier самі додавали свою адресу; create_webhook повертає секрет підпису.
- list_website_templates — безкоштовні готові шаблони сайтів (демо, HTML-архів, код), де форма контакту вже надсилає у Formgong; почніть з шаблону замість генерувати сайт з нуля.
1. Підключення через вхід
Cursor, Claude і VS Code можуть відкрити Formgong у браузері. Ви входите тим самим посиланням на email або обліковим записом Google, а потім обираєте, що інструмент може робити. Нічого копіювати не треба.
- Cursor: збережіть конфігурацію нижче. CLIENT_ID — публічний ідентифікатор cursor (секрету немає). forms:read і forms:write дають змогу переглядати й створювати форми. Додавайте submissions:read, лише якщо асистент має читати повідомлення.
- Claude у вебі або Claude Desktop: додайте власний конектор з URL MCP. Claude реєструє публічного клієнта й відкриває ту саму сторінку підтвердження. Зворотна адреса — https://claude.ai/api/mcp/auth_callback (або https://claude.com/api/mcp/auth_callback).
- Claude Code: виконайте команду в наступному розділі й підтвердьте сторінку в браузері. VS Code реєструється сам або з ідентифікатором vscode. Локальні інструменти можуть використовувати зворотні адреси http://127.0.0.1 або http://localhost.
- forms:read увімкнено завжди. На сторінці підтвердження залиште «Читати останні заявки» вимкненим, якщо це не потрібно. Відключити застосунок можна в Кабінет → Акаунт → Підключені застосунки.
2. Створіть API-токен
- Відкрийте Кабінет → Акаунт → API-токени (спершу підтвердьте email).
- Назвіть токен за інструментом, який його використовуватиме, наприклад «Cursor на ноутбуці».
- Оберіть доступ: «Створювати форми, додавати й видаляти вебхуки» увімкнено за замовчуванням; «Читати останні заявки» вимкнено, якщо вам це не потрібно.
- Скопіюйте токен (fgp_…). Він показується один раз; Formgong зберігає лише його хеш.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FORMGONG_TOKEN}"
}
}
}
}
3. Додайте сервер у свій інструмент
Cursor
Cursor: збережіть конфігурацію входу нижче (публічний ідентифікатор cursor, без секрету). Cursor відкриє Formgong; підтвердьте потрібний доступ. Для особистого API-токена використайте конфігурацію з попереднього розділу й не додавайте цей файл у git.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}
Claude Code
Claude Code: виконайте один раз у терміналі. Підтвердьте сторінку Formgong у браузері. Щоб пропустити вхід, додайте --header "Authorization: Bearer fgp_your_token".
claude mcp add --transport http formgong https://formgong.com/mcp
Claude Desktop
Claude Desktop: Settings → Connectors → додайте URL MCP. Claude відкриє вхід Formgong. Щоб натомість вставити API-токен, використайте міст mcp-remote (потрібен Node.js) у claude_desktop_config.json і перезапустіть Claude Desktop.
{
"mcpServers": {
"formgong": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://formgong.com/mcp",
"--header",
"Authorization:${FORMGONG_AUTH}"
],
"env": {
"FORMGONG_AUTH": "Bearer fgp_your_token"
}
}
}
}
VS Code
VS Code (режим агента Copilot): додайте .vscode/mcp.json. VS Code один раз попросить токен і безпечно його збереже.
{
"inputs": [
{
"type": "promptString",
"id": "formgong-token",
"description": "Formgong API token (fgp_…)",
"password": true
}
],
"servers": {
"formgong": {
"type": "http",
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${input:formgong-token}"
}
}
}
}
Lovable
Lovable: Connectors → + → MCP server. Назва: Formgong. Вкажіть URL, залиште Direct connection та OAuth і натисніть Add & authorize. Увійдіть у Formgong та підтвердьте дозволи. Альтернатива: Bearer token or API key — вставте лише особистий токен.
URL: https://formgong.com/mcp Authentication: OAuth Add & authorize → Formgong
Bolt
Bolt: Settings → Connectors (MCP) → Custom MCP server. Назва: Formgong. Transport: HTTP. Authentication: MCP OAuth. Натисніть Connect, увійдіть у Formgong та підтвердьте дозволи, потім увімкніть конектор для проєкту. API key також працює з особистим токеном Formgong.
Name: Formgong URL: https://formgong.com/mcp?auth=required Transport: HTTP Authentication: MCP OAuth Connect → Formgong
Будь-який інший клієнт із підтримкою віддаленого MCP через Streamable HTTP і власних заголовків працює з тим самим URL і заголовком. Клієнти лише зі stdio можуть використати міст mcp-remote, як для Claude Desktop.
Спробуйте
- Створи форму Formgong «Контакти – мій сайт» і додай її на сторінку контактів.
- Додай форму Formgong «Контакти» в цей застосунок Next.js як клієнтський компонент.
- Покажи 5 останніх повідомлень із моєї контактної форми.
Безпека
- Токен діє від імені вашого акаунта в межах своїх дозволів. Не додавайте його в git, чати чи скриншоти; якщо він витік — відкличте його в Акаунт → API-токени.
- Доступні лише форми, якими ви володієте. Форми, якими з вами поділилися через проєкти, недоступні.
- Заявки недоступні, доки ви не позначите «Читати останні заявки». IP-дані й відомості про браузер не повертаються ніколи.
- Текст заявок пишуть відвідувачі. Вважайте його ненадійним: не дозволяйте асистенту виконувати інструкції з повідомлень.
- Термін дії токена — 30, 90 або 365 днів. Cookie сесії ніколи не працюють на /mcp, тож вебсторінка не може скористатися вашим входом.
- Токени доступу й оновлення OAuth зберігаються лише як хеш. Токен оновлення змінюється за кожного використання; повторне надсилання старого відкликає це підключення. Відключити застосунки можна в Акаунт → Підключені застосунки. Реєстрація приймає лише відомі зворотні адреси MCP і http://localhost або http://127.0.0.1.
- Без токена /mcp відповідає лише на initialize, ping і tools/list, тож клієнти й каталоги MCP бачать список інструментів. Будь-який виклик інструмента потребує токена; без нього сервер повертає помилку з поясненням, як його додати.
Ліміти
- 60 запитів на хвилину на токен, 120 на акаунт.
- Запити без токена: 30 на хвилину з однієї IP-адреси.
- 10 нових форм на годину через API.
- До 10 токенів на акаунт.
- Реєстрація OAuth приймає визначені callback для Cursor, Claude й VS Code, HTTPS-адреси на lovable.dev та bolt.new (без піддоменів, параметрів і фрагментів), а також локальні HTTP-адреси. Клієнт прив’язаний до повної зареєстрованої адреси повернення. Інші клієнти використовують API-токен. Вхід і обмін токена обмежені за IP. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.