Serwer MCP Formgong

Połącz Formgong z Cursor, Claude, VS Code, Lovable lub Bolt. Asystent AI utworzy formularz, pobierze gotowy kod z właściwym kluczem dostępu i sprawdzi ostatnie zgłoszenia — bez ręcznego kopiowania kluczy.

URL: https://formgong.com/mcp · Streamable HTTP · Authorization: Bearer fgp_…

Narzędzia

list_forms — Twoje formularze z publicznymi kluczami dostępu i liczbą zgłoszeń w tym miesiącu.
create_form — nowy formularz; zgłoszenia trafiają na e-mail konta. Telegram i dodatkowych odbiorców podłączasz w panelu (narzędzie zwraca linki).
get_form_snippet — kod HTML, React lub Next.js dla jednego formularza z kluczem, _lang, honeypotem botcheck i Turnstile, jeśli jest włączony.
list_recent_submissions — tylko odczyt, tylko po osobnej zgodzie: czas i pola zgłoszenia, domyślnie bez spamu, do 50.

1. Utwórz token API

Otwórz Panel → Konto → Tokeny API (najpierw potwierdź e-mail).
Nazwij token od narzędzia, które go użyje, np. „Cursor na laptopie”.
Wybierz dostęp: „Tworzenie formularzy” jest domyślnie włączone; „Odczyt ostatnich zgłoszeń” zostaw wyłączony, jeśli go nie potrzebujesz.
Skopiuj token (fgp_…). Jest pokazywany raz; Formgong przechowuje tylko jego skrót.

2. Dodaj serwer do swojego narzędzia

Cursor

Cursor: dodaj do ~/.cursor/mcp.json (wszystkie projekty) lub .cursor/mcp.json (jeden projekt). Ustaw zmienną środowiskową FORMGONG_TOKEN albo wklej token zamiast zmiennej w pliku, którego nie commitujesz.

{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FORMGONG_TOKEN}"
      }
    }
  }
}

Claude Code

Claude Code: uruchom raz w terminalu.

claude mcp add --transport http formgong https://formgong.com/mcp \
  --header "Authorization: Bearer fgp_your_token"

Claude Desktop

Claude Desktop: własne konektory w Settings → Connectors wymagają OAuth, którego Formgong jeszcze nie oferuje. Zamiast tego użyj mostu mcp-remote (wymaga Node.js) w claude_desktop_config.json i uruchom ponownie 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 (tryb agenta Copilot): dodaj .vscode/mcp.json. VS Code raz poprosi o token i bezpiecznie go zapisze.

{
  "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. Podaj URL, wybierz „Bearer token or API key” i wklej sam token (bez słowa 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, potem wklej token.

Name: Formgong
URL: https://formgong.com/mcp
Transport: HTTP
Authentication: API key → fgp_your_token

Każdy inny klient obsługujący zdalne MCP przez Streamable HTTP z własnymi nagłówkami działa z tym samym URL i nagłówkiem. Klienci tylko ze stdio mogą użyć mostu mcp-remote jak w Claude Desktop.

Wypróbuj

Utwórz formularz Formgong „Kontakt – moja strona” i dodaj go do strony kontaktowej.
Dodaj formularz Formgong „Kontakt” do tej aplikacji Next.js jako komponent kliencki.
Pokaż 5 ostatnich wiadomości z mojego formularza kontaktowego.

Bezpieczeństwo

Token działa w imieniu Twojego konta w ramach swoich uprawnień. Nie umieszczaj go w git, czatach ani na zrzutach ekranu; jeśli wycieknie, unieważnij go w Konto → Tokeny API.
Dostępne są tylko formularze, których jesteś właścicielem. Formularze udostępnione Ci w projektach nie są dostępne.
Zgłoszenia są niedostępne, dopóki nie zaznaczysz „Odczyt ostatnich zgłoszeń”. Dane IP i informacje o przeglądarce nigdy nie są zwracane.
Treść zgłoszeń piszą odwiedzający. Traktuj ją jako niezaufaną: nie pozwól asystentowi wykonywać poleceń z wiadomości.
Token może wygasać po 30, 90 lub 365 dniach. Ciasteczka sesji nigdy nie działają na /mcp, więc strona internetowa nie użyje Twojego logowania.
Bez tokenu /mcp odpowiada jedynie na polecenia initialize, ping oraz tools/list, dzięki czemu klienci i katalogi MCP mogą wyświetlić listę narzędzi. Każde wywołanie narzędzia wymaga tokenu; w przypadku jego braku serwer zwraca komunikat o błędzie wyjaśniający, w jaki sposób należy go dodać.

Limity

60 żądań na minutę na token, 120 na konto.
Żądania bez tokenu: 30 na minutę na adres IP.
10 nowych formularzy na godzinę przez API.
Do 10 tokenów na konto.
OAuth nie jest jeszcze obsługiwany, więc konektory webowe ChatGPT i claude.ai nie połączą się bezpośrednio. Strona i gotowe prompty z tej dokumentacji działają wszędzie.