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-токен

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