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 · OAuth 2.1 or 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.
- list_webhooks, create_webhook, delete_webhook — zarządzanie webhookami formularza, żeby n8n, Make lub Zapier same dodawały swój adres; create_webhook zwraca sekret podpisu.
- list_website_templates — darmowe gotowe szablony stron (demo, paczka HTML, kod), w których formularz kontaktowy już wysyła do Formgong; zacznij od szablonu zamiast generować stronę od zera.
1. Połączenie przez logowanie
Cursor, Claude i VS Code mogą otworzyć Formgong w przeglądarce. Logujesz się tym samym linkiem e-mail lub kontem Google, a potem wybierasz, co narzędzie może robić. Nic nie trzeba wklejać.
- Cursor: zapisz konfigurację poniżej. CLIENT_ID to publiczny identyfikator cursor (nie ma sekretu). forms:read i forms:write pozwalają przeglądać i tworzyć formularze. Dodaj submissions:read tylko wtedy, gdy asystent ma czytać wiadomości.
- Claude w przeglądarce lub Claude Desktop: dodaj własny konektor z adresem MCP. Claude rejestruje publicznego klienta i otwiera tę samą stronę zatwierdzenia. Adres zwrotny to https://claude.ai/api/mcp/auth_callback (lub https://claude.com/api/mcp/auth_callback).
- Claude Code: uruchom polecenie w następnej sekcji i zatwierdź stronę w przeglądarce. VS Code rejestruje się samo albo z identyfikatorem vscode. Lokalne narzędzia mogą używać adresów http://127.0.0.1 lub http://localhost.
- forms:read jest zawsze włączone. Na stronie zatwierdzenia zostaw „Odczyt ostatnich zgłoszeń” wyłączone, jeśli go nie potrzebujesz. Odłączyć aplikację można w Panel → Konto → Połączone aplikacje.
2. 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, dodawanie i usuwanie webhooków” 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.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FORMGONG_TOKEN}"
}
}
}
}
3. Dodaj serwer do swojego narzędzia
Cursor
Cursor: zapisz poniższą konfigurację logowania (publiczny identyfikator cursor, bez sekretu). Cursor otworzy Formgong; zatwierdź potrzebny dostęp. Dla osobistego tokenu API użyj konfiguracji z poprzedniej sekcji i nie commituj tego pliku.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}
Claude Code
Claude Code: uruchom raz w terminalu. Zatwierdź stronę Formgong w przeglądarce. Aby pominąć logowanie, dodaj --header "Authorization: Bearer fgp_your_token".
claude mcp add --transport http formgong https://formgong.com/mcp
Claude Desktop
Claude Desktop: Settings → Connectors → dodaj adres MCP. Claude otworzy logowanie Formgong. Aby zamiast tego wkleić token API, 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: Connectors → + → MCP server. Nazwa: Formgong. Podaj URL, pozostaw Direct connection i OAuth, kliknij Add & authorize. Zaloguj się do Formgong i zatwierdź uprawnienia. Alternatywnie wybierz Bearer token or API key i wklej sam osobisty token.
URL: https://formgong.com/mcp Authentication: OAuth Add & authorize → Formgong
Bolt
Bolt: Settings → Connectors (MCP) → Custom MCP server. Nazwa: Formgong. Transport: HTTP. Authentication: MCP OAuth. Kliknij Connect, zaloguj się do Formgong i zatwierdź uprawnienia, a następnie włącz konektor dla projektu. API key działa też z osobistym tokenem Formgong.
Name: Formgong URL: https://formgong.com/mcp?auth=required Transport: HTTP Authentication: MCP OAuth Connect → Formgong
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.
- Tokeny dostępu i odświeżania OAuth są przechowywane tylko jako skrót. Token odświeżania zmienia się przy każdym użyciu; ponowne wysłanie starego unieważnia to połączenie. Aplikacje odłączysz w Konto → Połączone aplikacje. Rejestracja przyjmuje tylko znane adresy zwrotne MCP oraz http://localhost lub http://127.0.0.1.
- 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.
- Rejestracja OAuth akceptuje wskazane callbacki Cursor, Claude i VS Code, adresy HTTPS na lovable.dev i bolt.new (bez subdomen, parametrów i fragmentów) oraz lokalne adresy HTTP. Klient jest związany z dokładnym zarejestrowanym adresem. Inne klienty używają tokenu API. Logowanie i wymiana tokenu są limitowane na IP. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.