Skip to main content
Kostenlos - der MCP-Server ist nicht plan-gebunden. Jedes Konto kann ihn nutzen.
Formpaste liefert einen entfernten MCP-Server - das ist der echte KI-agenten-native Integrationsweg. Es gibt keine separate REST-”Forms-API” oder “Provisioning-API”; ein Agent, der Formulare programmatisch erstellen oder verwalten will, tut das über diese MCP-Tools - genauso wie ein Mensch es über das Dashboard tut.

Endpoint

Zustandsloses entferntes MCP über Streamable HTTP - kein Session-/SSE-Handshake zu verwalten. Jede Anfrage trägt ihre eigene Authentifizierung und erhält eine in sich abgeschlossene Antwort.

Auth

Jede Anfrage benötigt ein Konto-API-Token (fpat_…) als Standard-Bearer-Header:
Das ist das einzige Bearer-Token in Formpaste. Es steht in keinem Zusammenhang mit dem access_key eines Formulars (verwendet von POST /submit, nicht von /mcp) - siehe Access-Key vs. API-Token, falls du unsicher bist, welches du brauchst. Erstelle ein Token im Dashboard unter Settings → API & MCP - siehe API-Token für Details, einschließlich der Tatsache, dass es genau einmal angezeigt wird. Token können eingeschränkt werden: ein vollständiges Token kann jedes Tool nutzen, ein Setup-Token kann alles außer Einsendungen lesen (list_submissions). Siehe API-Token. Ein fehlendes oder widerrufenes Token führt nicht zu einem generischen 401; der Tool-Aufruf liefert einen umsetzbaren MCP-Fehler zurück:

Installation (ein Befehl)

Formpaste ist ein entfernter Server, daher verbinden sich die meisten MCP-Clients (Claude Code, Cursor, Claude Desktop) über mcp-remote statt über einen lokalen Prozess. Füge das zu deiner Client-MCP-Konfiguration hinzu und setze dein eigenes Token ein:
Starte deinen Agenten/Client nach dem Speichern neu. Er sollte formpaste als verbundenen MCP-Server mit sechs verfügbaren Tools auflisten. Für clientspezifische Anleitungen (Claude Code, Codex, Cursor, Claude Desktop, VS Code) siehe Installation.

Die sechs Tools

Drei davon - list_forms, get_form und send_test_submission - erlauben einem Agenten, seine eigene Arbeit zu prüfen: IDs entdecken, die Konfiguration eines Formulars zurücklesen und belegen, dass es empfängt. Das ist die gesamte Tool-Oberfläche. Es gibt kein update_form, delete_form oder generisches CRUD - das wurde nicht gebaut. Wenn du das Ziel, erlaubte Domains oder andere Einstellungen eines Formulars ändern musst, mach das im Dashboard.

Wofür es gedacht ist

Der MCP-Server existiert, damit ein Agent (Claude Code, Cursor oder alles andere, das MCP spricht) eine vollständige Aufgabe wie “füge dieser Site ein Kontaktformular hinzu” erledigen kann, ohne dass du deinen Editor verlässt: er ruft create_form auf, erhält einen access_key und ein verdrahtetes Snippet zurück, fügt das Snippet in dein Projekt ein und ruft, falls du es später auf Antworten prüfen lassen willst, list_submissions auf. Siehe Cookbook-Prompts für einsatzbereite Prompts, die das End-to-End steuern. Wenn du lieber nichts installieren möchtest, funktioniert auch der .env-Weg: erstelle das Formular selbst im Dashboard, setze den access_key in .env und lass deinen Agenten das Snippet damit verdrahten. Keine MCP-Verbindung erforderlich - siehe die .env-Weg-Prompts im Cookbook.

Installation

Clientspezifisches Setup für jeden MCP-Client.

create_form

Stelle ein Formular bereit und erhalte ein verdrahtetes Snippet zurück.

list_forms

Entdecke Formular-IDs und bestätige, dass ein Formular existiert.

get_form

Lies die Konfiguration eines Formulars, um die Verdrahtung zu prüfen.

send_test_submission

Belege mit einer Testeinsendung, dass ein Formular live ist.

Fehlerbehebung

Behebe Verbindungs-, Auth- und Scope-Probleme.