MCP-Integration

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten die direkte Interaktion mit externen Diensten ermöglicht. NueForms MCP-Server gibt deiner KI vollen Zugriff auf deinen Workspace — Formulare, Antworten, Analytics, Teams, Webhooks, Voice Studio und mehr.

Was kannst du damit tun?

Mit verbundenem MCP kannst du deine KI Dinge fragen wie:

• „Wie ist meine Abschlussrate über alle Formulare in diesem Monat?"
• „Erstelle eine Kundenzufriedenheitsumfrage mit NPS-Bewertung."
• „Exportiere alle Antworten aus Q1 als CSV."
• „Füge sarah@company.com zum Marketing-Team hinzu."
• „Welche Fragen brauchen am längsten zum Beantworten?"
• „Lies diese Ankündigung mit Rosas Stimme vor. Gib nicht mehr als 2.000 Credits aus."
• „Wie viele Credits habe ich diesen Monat noch?"

Deine KI übersetzt diese natürlichsprachigen Anfragen automatisch in die passenden NueForm-API-Aufrufe.

Voraussetzungen

• Ein NueForm-Konto (der kostenlose Tarif reicht)
• Ein MCP-kompatibler KI-Client (siehe Einrichtungsanleitungen unten)

Einrichtungsanleitungen

Die MCP-Server-URL von NueForm:

https://nueform.io/api/mcp

Die Authentifizierung läuft über OAuth — dein KI-Client öffnet ein Browserfenster, in dem du dich mit deinem NueForm-Konto anmeldest. Keine API-Schlüssel nötig.

Claude Desktop

Füge Folgendes zu deiner claude_desktop_config.json hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Starte Claude Desktop neu. Bei der ersten Nutzung wirst du aufgefordert, dich mit deinem NueForm-Konto anzumelden.

Claude Code (CLI)

Führe den folgenden Befehl aus:

claude mcp add nueform --transport http https://nueform.io/api/mcp

Oder füge es zu deiner .claude/settings.json hinzu:

{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Cursor

Füge es zur .cursor/mcp.json im Wurzelverzeichnis deines Projekts (oder in den globalen Einstellungen) hinzu:

{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Windsurf

Füge es zu deiner MCP-Konfiguration in den Windsurf-Einstellungen hinzu:

{
  "mcpServers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Füge es zur .vscode/mcp.json in deinem Workspace hinzu:

{
  "servers": {
    "nueform": {
      "url": "https://nueform.io/api/mcp"
    }
  }
}

Andere MCP-Clients

Jeder Client, der HTTP Streamable MCP Transport unterstützt, kann sich mit NueForm verbinden. Richte ihn auf:

• Server-URL: https://nueform.io/api/mcp
• Authentifizierung: OAuth 2.0 (der Client sollte den Ablauf automatisch übernehmen)

Verfügbare Tools

NueForms MCP-Server stellt 75 Tools in 11 Kategorien bereit:

Formulare (8 Tools)

Formulare werden als Entwurf gespeichert. publish_form – oder published: true bei create_form und update_form – führt dieselben Prüfungen aus wie der Veröffentlichen-Button im Builder: Team-Formulare können nur Team-Admins und -Owner veröffentlichen, Pro-Funktionen richten sich nach dem Plan des Formularinhabers, und Buchungs-, E-Mail-Schritt-, Fuse- und Composite-Fragen müssen vollständig eingerichtet sein. Schlägt eine Prüfung fehl, wird nichts veröffentlicht, und das Tool gibt den Grund, die zu korrigierenden Fragen und einen Hinweis für deine KI zurück. Ein mit published: true erstelltes Formular wird trotzdem als Entwurf angelegt, wenn die Veröffentlichung blockiert ist.

Analytics (5 Tools)

Antworten (5 Tools)

Webhooks (6 Tools)

Teams (12 Tools)

Fuse-Sessions (9 Tools)

Composites (6 Tools)

Allgemein (6 Tools)

Voice Studio (8 Tools)

Studio Apps (7 Tools)

Credits (3 Tools)

Credits ausgeben

Die Tools, die Credits kosten (voice_generate, voice_design, voice_save, voice_clone, studio_audio_merge, studio_voice_drop, studio_time_capsule, studio_podcast und studio_talking_qr), brauchen max_credits: das Höchste, was ein Aufruf ausgeben darf (10.000 Credits = 1 $). Ohne diesen Wert, oder wenn der Aufruf mehr kosten würde, wird nichts ausgegeben, und das Tool antwortet mit den genauen Kosten, damit deine KI dich vorher fragen kann.

• Sprache kostet 1 Credit pro gesprochenem Zeichen, in jeder Sprache. Denselben Clip innerhalb von 30 Tagen noch einmal zu erstellen ist kostenlos, und Zeilen, die fehlschlagen, werden automatisch gutgeschrieben.
• Eine neue Stimme, gestaltet und gespeichert oder geklont, kostet 50.000 Credits (5 $).
• Es gelten dieselben Regeln wie in der App: Text wird vor jeder Abbuchung anhand der Nutzungsrichtlinie geprüft, und zum Speichern oder Klonen einer Stimme brauchst du einen ersten Credit-Kauf und eine bestätigte E-Mail-Adresse. Klone nur Stimmen, die du nutzen darfst.
• Wenn ein Aufruf in ein Timeout läuft, ruf ihn mit denselben Argumenten und demselben idempotency_key noch einmal auf (8–100 Buchstaben, Ziffern, - oder _; jede Antwort enthält den verwendeten): Du bekommst das Ergebnis des ersten Aufrufs, statt doppelt zu zahlen.
• Audio-Links gelten 15 Minuten. library_get liefert einen neuen.
• Sprache, neue Stimmen und die Studio Apps, die Sprache erzeugen, werden mit dem bezahlt, was du in deinem Wallet unter Voice Studio bezahlen mit gewählt hast: mit deinen eigenen Credits, außer du hast ein Team gewählt (dann gehört eine Stimme, die du erstellst, dem Team). credits_balance zeigt, was du damit ausgeben kannst. studio_voice_drop und studio_time_capsule nutzen immer deine eigenen Credits. Kann das Team nicht zahlen, wird nichts ausgegeben, und die Antwort sagt, warum.
• Über MCP kannst du keine Credits kaufen, verschenken oder automatisch nachkaufen lassen: Das geht in deinem Wallet in NueForm.

Für große Mengen aus deinem eigenen Code berechnet die Voice API 0,4 Credits pro Zeichen.

Anwendungsbeispiele

Formular-Performance analysieren

Du: „Wie ist die Abschlussrate meines Kundenfeedback-Formulars in diesem Monat?"

KI: Nutzt get_form_analytics mit Datumsfiltern und berichtet dann: „Dein Kundenfeedback-Formular hat diesen Monat eine Abschlussrate von 73 % (219 abgeschlossen von insgesamt 300 Antworten). Das ist mehr als die 68 % des Vormonats."

Ein Formular erstellen

Du: „Erstelle eine schnelle Kundenzufriedenheitsumfrage mit 3 Fragen — einer Bewertung, einem Kommentarfeld und einem E-Mail-Feld."

KI: Nutzt create_form mit einem Fragen-Array und bestätigt dann: „Fertig! Ich habe die ‚Kundenzufriedenheitsumfrage' mit 3 Fragen erstellt. Soll ich sie veröffentlichen?"

Antworten verwalten

Du: „Exportiere alle Antworten aus meinem Bewerbungsformular als CSV, damit ich sie in einer Tabelle durchsehen kann."

KI: Nutzt export_responses_csv und liefert die CSV-Daten, die du in einer Datei speichern kannst.

Ein Voiceover erstellen

Du: „Lies unsere neuen Öffnungszeiten mit Rosas Stimme vor. Gib nicht mehr als 2.000 Credits aus."

KI: Nutzt voices_list, um Rosa zu finden, dann voice_generate mit max_credits: 2000, und antwortet: „Fertig. Das hat 612 Credits gekostet. Hier ist das Audio; der Link gilt 15 Minuten."

Fehlerbehebung

„Authentifizierung fehlgeschlagen"

Stelle sicher, dass du im richtigen NueForm-Konto angemeldet bist. Versuche, den MCP-Server in deinem KI-Client zu trennen und neu zu verbinden.

„Zugriff verweigert" bei Webhook- oder Team-Tools

Manche Tools erfordern bestimmte Tarifstufen (Pro oder Enterprise) oder Teamrollen (Admin oder Owner). Prüfe deinen Tarif auf der Abrechnungsseite.

Tools erscheinen nicht

Starte deinen KI-Client nach dem Hinzufügen der MCP-Konfiguration neu. Manche Clients benötigen einen vollständigen Neustart, um neue MCP-Server zu erkennen.

„not_started" bei einem Tool von Voice Studio

Es wurde nichts ausgegeben: Dem Aufruf fehlte max_credits, oder die Kosten waren höher. Die Antwort enthält die genauen Kosten; sende den Aufruf noch einmal mit max_credits in mindestens dieser Höhe.

Rate-Limiting

NueForms MCP-Server wendet dieselben Minutenlimits an wie die REST-API (100 Anfragen pro Minute, 500 bei Enterprise), gezählt pro Nutzer und getrennt von deinen API-Schlüsseln. Jede Anfrage zählt, auch jede einzelne in einem Batch, und ein Batch darf höchstens 10 Anfragen enthalten. Wenn du viele Anfragen in schneller Folge stellst, muss die KI eventuell zwischen den Aufrufen warten.