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, а потім обираєте, що інструмент може робити. Нічого копіювати не треба.

  1. Cursor: збережіть конфігурацію нижче. CLIENT_ID — публічний ідентифікатор cursor (секрету немає). forms:read і forms:write дають змогу переглядати й створювати форми. Додавайте submissions:read, лише якщо асистент має читати повідомлення.
  2. Claude у вебі або Claude Desktop: додайте власний конектор з URL MCP. Claude реєструє публічного клієнта й відкриває ту саму сторінку підтвердження. Зворотна адреса — https://claude.ai/api/mcp/auth_callback (або https://claude.com/api/mcp/auth_callback).
  3. Claude Code: виконайте команду в наступному розділі й підтвердьте сторінку в браузері. VS Code реєструється сам або з ідентифікатором vscode. Локальні інструменти можуть використовувати зворотні адреси http://127.0.0.1 або http://localhost.
  4. forms:read увімкнено завжди. На сторінці підтвердження залиште «Читати останні заявки» вимкненим, якщо це не потрібно. Відключити застосунок можна в Кабінет → Акаунт → Підключені застосунки.

2. Створіть API-токен

  1. Відкрийте Кабінет → Акаунт → API-токени (спершу підтвердьте email).
  2. Назвіть токен за інструментом, який його використовуватиме, наприклад «Cursor на ноутбуці».
  3. Оберіть доступ: «Створювати форми, додавати й видаляти вебхуки» увімкнено за замовчуванням; «Читати останні заявки» вимкнено, якщо вам це не потрібно.
  4. Скопіюйте токен (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.

Промпти для AI-білдерів · Файли правил для агентів