Formgong-MCP-Server
Verbinden Sie Formgong mit Cursor, Claude, VS Code, Lovable oder Bolt. Ihr KI-Assistent kann dann ein Formular erstellen, fertigen Code mit dem richtigen Zugriffsschlüssel abrufen und aktuelle Einsendungen prüfen, ohne dass Sie Schlüssel von Hand kopieren.
URL: https://formgong.com/mcp · Streamable HTTP · OAuth 2.1 or Authorization: Bearer fgp_…
Tools
- list_forms — Ihre Formulare mit öffentlichem Zugriffsschlüssel und der Zahl der Einsendungen in diesem Monat.
- create_form — ein neues Formular; Einsendungen gehen an die E-Mail-Adresse Ihres Kontos. Telegram und weitere Empfänger verbinden Sie im Dashboard (das Tool liefert die Links).
- get_form_snippet — HTML-, React- oder Next.js-Code für ein Formular mit Zugriffsschlüssel, _lang, botcheck-Honeypot und Turnstile, falls aktiviert.
- list_recent_submissions — nur lesend und nur mit eigener Freigabe: Zeitpunkt und Felder, Spam standardmäßig ausgeblendet, bis zu 50.
- list_webhooks, create_webhook, delete_webhook — Webhooks eines Formulars verwalten, damit n8n, Make oder Zapier ihre Trigger-URL selbst eintragen; create_webhook gibt das Signatur-Secret zurück.
- list_website_templates — kostenlose fertige Website-Vorlagen (Live-Demo, HTML-Download, Quellcode), deren Kontaktformular schon an Formgong sendet; mit einer Vorlage starten statt die Seite neu zu generieren.
1. Mit Anmeldung verbinden
Cursor, Claude und VS Code können Formgong im Browser öffnen. Sie melden sich mit demselben E-Mail-Link oder Google-Konto an und wählen dann, was das Tool tun darf. Nichts zum Einfügen.
- Cursor: speichern Sie die Konfiguration unten. CLIENT_ID ist die öffentliche Kennung cursor (es gibt kein Geheimnis). forms:read und forms:write lassen den Assistenten Formulare auflisten und anlegen. submissions:read nur hinzufügen, wenn er Nachrichten lesen soll.
- Claude im Web oder Claude Desktop: einen eigenen Connector mit der MCP-URL hinzufügen. Claude registriert einen öffentlichen Client und öffnet dieselbe Freigabeseite. Die Rückadresse ist https://claude.ai/api/mcp/auth_callback (oder https://claude.com/api/mcp/auth_callback).
- Claude Code: den Befehl im nächsten Abschnitt ausführen und die Seite im Browser bestätigen. VS Code registriert sich selbst, oder Sie nutzen die Kennung vscode. Lokale Tools dürfen Rückadressen auf http://127.0.0.1 oder http://localhost verwenden.
- forms:read ist immer enthalten. Lassen Sie auf der Freigabeseite „Letzte Einsendungen lesen“ aus, solange Sie es nicht brauchen. Trennen können Sie später unter Dashboard → Konto → Verbundene Apps.
2. API-Token erstellen
- Öffnen Sie Dashboard → Konto → API-Tokens (bestätigen Sie zuerst Ihre E-Mail-Adresse).
- Benennen Sie das Token nach dem Tool, das es nutzt, z. B. „Cursor auf meinem Laptop“.
- Wählen Sie den Zugriff: „Formulare erstellen und Webhooks hinzufügen oder entfernen“ ist standardmäßig aktiv; „Letzte Einsendungen lesen“ bleibt aus, solange Sie es nicht brauchen.
- Kopieren Sie das Token (fgp_…). Es wird einmal angezeigt; Formgong speichert nur einen Hash.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FORMGONG_TOKEN}"
}
}
}
}
3. Server im Tool hinzufügen
Cursor
Cursor: speichern Sie die Anmeldekonfiguration unten (öffentliche Kennung cursor, kein Geheimnis). Cursor öffnet Formgong; geben Sie den gewünschten Zugriff frei. Für ein persönliches API-Token nutzen Sie die Konfiguration im vorigen Abschnitt und nehmen die Datei nicht ins Git auf.
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}
Claude Code
Claude Code: einmal im Terminal ausführen. Bestätigen Sie die Formgong-Seite im Browser. Um die Anmeldung zu überspringen, fügen Sie --header "Authorization: Bearer fgp_your_token" hinzu.
claude mcp add --transport http formgong https://formgong.com/mcp
Claude Desktop
Claude Desktop: Settings → Connectors → die MCP-URL hinzufügen. Claude öffnet die Formgong-Anmeldung. Für ein eingefügtes API-Token nutzen Sie stattdessen die Brücke mcp-remote (Node.js erforderlich) in claude_desktop_config.json und starten Claude Desktop neu.
{
"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-Agentenmodus): .vscode/mcp.json hinzufügen. VS Code fragt einmal nach dem Token und speichert es sicher.
{
"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. Name: Formgong. URL eingeben, Direct connection und OAuth beibehalten, Add & authorize wählen. Bei Formgong anmelden und Berechtigungen bestätigen. Alternativ: Bearer token or API key und nur das persönliche Token einfügen.
URL: https://formgong.com/mcp Authentication: OAuth Add & authorize → Formgong
Bolt
Bolt: Settings → Connectors (MCP) → Custom MCP server. Name: Formgong. Transport: HTTP. Authentication: MCP OAuth. Connect wählen, bei Formgong anmelden und Berechtigungen bestätigen, dann den Connector für das Projekt aktivieren. API key funktioniert auch mit einem persönlichen Formgong-Token.
Name: Formgong URL: https://formgong.com/mcp?auth=required Transport: HTTP Authentication: MCP OAuth Connect → Formgong
Jeder andere Client mit Remote-MCP über Streamable HTTP und eigenen Headern funktioniert mit derselben URL und demselben Header. Reine stdio-Clients können die mcp-remote-Brücke wie bei Claude Desktop nutzen.
Ausprobieren
- Erstelle ein Formgong-Formular „Kontakt – meine Website“ und füge es auf der Kontaktseite ein.
- Füge das Formgong-Formular „Kontakt“ als Client-Komponente in diese Next.js-App ein.
- Zeig mir die letzten 5 Nachrichten aus meinem Kontaktformular.
Sicherheit
- Ein Token handelt im Rahmen seiner Berechtigungen für Ihr Konto. Halten Sie es aus Git, Chats und Screenshots heraus; widerrufen Sie es unter Konto → API-Tokens, falls es bekannt wird.
- Verfügbar sind nur Formulare, die Ihnen gehören. Über Projekte mit Ihnen geteilte Formulare sind nicht zugänglich.
- Einsendungen sind nur abrufbar, wenn Sie „Letzte Einsendungen lesen“ aktivieren. IP-Daten und Browserangaben werden nie zurückgegeben.
- Einsendungen schreiben Ihre Besucher. Behandeln Sie sie als nicht vertrauenswürdig: Lassen Sie den Assistenten keine Anweisungen aus Nachrichten ausführen.
- Tokens können nach 30, 90 oder 365 Tagen ablaufen. Sitzungscookies funktionieren auf /mcp nie, daher kann keine Webseite Ihre Anmeldung nutzen.
- OAuth-Zugriffs- und Aktualisierungstokens werden nur als Hash gespeichert. Ein Aktualisierungstoken wechselt bei jeder Nutzung; das erneute Senden eines alten widerruft diese Verbindung. Apps trennen Sie unter Konto → Verbundene Apps. Die Registrierung akzeptiert nur bekannte MCP-Rückadressen und http://localhost oder http://127.0.0.1.
- Ohne Token beantwortet /mcp nur die Befehle „initialize“, „ping“ und „tools/list“, sodass Clients und MCP-Verzeichnisse die Tool-Liste einsehen können. Jeder Tool-Aufruf erfordert ein Token; ohne dieses gibt der Server eine Fehlermeldung aus, in der erklärt wird, wie es hinzugefügt werden kann.
Limits
- 60 Anfragen pro Minute je Token, 120 je Konto.
- Anfragen ohne Token: 30 pro Minute pro IP-Adresse.
- 10 neue Formulare pro Stunde über die API.
- Bis zu 10 Tokens pro Konto.
- Die OAuth-Registrierung akzeptiert die aufgeführten Rückadressen für Cursor, Claude und VS Code, HTTPS-Adressen auf lovable.dev und bolt.new (ohne Subdomains, Abfrage oder Fragment) und lokale HTTP-Adressen. Jeder Client bleibt an seine exakt registrierte Rückadresse gebunden. Andere Clients verwenden API-Tokens. Anmeldung und Tokenaustausch sind pro IP begrenzt. Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.