MCP-сервер Formgong
Підключіть Formgong до Cursor, Claude, VS Code, Lovable чи Bolt. AI-асистент зможе створити форму, отримати готовий код із правильним ключем доступу та переглянути останні заявки — без ручного копіювання ключів.
URL: https://formgong.com/mcp · Streamable HTTP · Authorization: Bearer fgp_…
Інструменти
- list_forms — ваші форми з публічними ключами доступу й кількістю заявок за місяць.
- create_form — нова форма; заявки йдуть на email акаунта. Telegram і додаткових отримувачів підключають у кабінеті (інструмент повертає посилання).
- get_form_snippet — код HTML, React або Next.js для однієї форми з ключем, _lang, honeypot botcheck і Turnstile, якщо він увімкнений.
- list_recent_submissions — лише читання й лише за окремим дозволом: час і поля заявки, без спаму за замовчуванням, до 50.
1. Створіть API-токен
- Відкрийте Кабінет → Акаунт → API-токени (спершу підтвердьте email).
- Назвіть токен за інструментом, який його використовуватиме, наприклад «Cursor на ноутбуці».
- Оберіть доступ: «Створювати форми» увімкнено за замовчуванням; «Читати останні заявки» вимкнено, якщо вам це не потрібно.
- Скопіюйте токен (fgp_…). Він показується один раз; Formgong зберігає лише його хеш.
2. Додайте сервер у свій інструмент
Cursor
Cursor: додайте в ~/.cursor/mcp.json (усі проєкти) або .cursor/mcp.json (один проєкт). Задайте змінну середовища FORMGONG_TOKEN або вставте токен замість змінної у файл, який не потрапляє в git.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FORMGONG_TOKEN}"
}
}
}
}
Claude Code
Claude Code: виконайте один раз у терміналі.
claude mcp add --transport http formgong https://formgong.com/mcp \ --header "Authorization: Bearer fgp_your_token"
Claude Desktop
Claude Desktop: власні конектори в Settings → Connectors вимагають OAuth, якого Formgong поки не має. Натомість використайте міст 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: Settings → Connectors → Custom MCP server. Вкажіть URL, оберіть «Bearer token or API key» і вставте лише токен (без слова Bearer).
URL: https://formgong.com/mcp Authentication: Bearer token or API key Token: fgp_your_token
Bolt
Bolt: Settings → Connectors (MCP) → Custom MCP server. Transport: HTTP. Authentication: API key, далі вставте токен.
Name: Formgong URL: https://formgong.com/mcp Transport: HTTP Authentication: API key → fgp_your_token
Будь-який інший клієнт із підтримкою віддаленого MCP через Streamable HTTP і власних заголовків працює з тим самим URL і заголовком. Клієнти лише зі stdio можуть використати міст mcp-remote, як для Claude Desktop.
Спробуйте
- Створи форму Formgong «Контакти – мій сайт» і додай її на сторінку контактів.
- Додай форму Formgong «Контакти» в цей застосунок Next.js як клієнтський компонент.
- Покажи 5 останніх повідомлень із моєї контактної форми.
Безпека
- Токен діє від імені вашого акаунта в межах своїх дозволів. Не додавайте його в git, чати чи скриншоти; якщо він витік — відкличте його в Акаунт → API-токени.
- Доступні лише форми, якими ви володієте. Форми, якими з вами поділилися через проєкти, недоступні.
- Заявки недоступні, доки ви не позначите «Читати останні заявки». IP-дані й відомості про браузер не повертаються ніколи.
- Текст заявок пишуть відвідувачі. Вважайте його ненадійним: не дозволяйте асистенту виконувати інструкції з повідомлень.
- Термін дії токена — 30, 90 або 365 днів. Cookie сесії ніколи не працюють на /mcp, тож вебсторінка не може скористатися вашим входом.
- Без токена /mcp відповідає лише на initialize, ping і tools/list, тож клієнти й каталоги MCP бачать список інструментів. Будь-який виклик інструмента потребує токена; без нього сервер повертає помилку з поясненням, як його додати.
Ліміти
- 60 запитів на хвилину на токен, 120 на акаунт.
- Запити без токена: 30 на хвилину з однієї IP-адреси.
- 10 нових форм на годину через API.
- До 10 токенів на акаунт.
- OAuth поки не підтримується, тож вебконектори ChatGPT і claude.ai не підключаться напряму. Сайт і готові промпти з цієї документації працюють усюди.