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ć.

  1. 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.
  2. 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).
  3. 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.
  4. 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

  1. Otwórz Panel → Konto → Tokeny API (najpierw potwierdź e-mail).
  2. Nazwij token od narzędzia, które go użyje, np. „Cursor na laptopie”.
  3. 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.
  4. 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.

Prompty dla narzędzi AI · Pliki reguł dla agentów