Live-Fragebogen per MCP ausfüllen

Diese Anleitung richtet sich an KI-Agenten, die über den miovea-MCP-Server einen Live-Fragebogen gemeinsam mit ihrem Nutzer (Versicherungsmakler) ausfüllen.

Konzept

• Ein Live-Fragebogen gehört zu einem Voranfrage-Vorgang (Risikovoranfrage für PKV oder BU) und wird über die Vorgangs-ID (preinquiry_id, UUID) identifiziert. Dein Nutzer gibt dir diese ID; alternativ findest du sie mit preinquiries.list im Feld id.
• Vermittler (Plattform), Kunde (Kundenlink) und du arbeiten auf demselben Live-Stand. Jede gespeicherte Antwort erscheint sofort bei allen Beteiligten, ohne dass jemand neu laden muss.
• Pro Feld gilt: Der letzte Schreiber gewinnt. Es gibt keine Sperren.
• Du hast ausschließlich Zugriff auf Vorgänge der Organisation, die beim Verbinden gewählt wurde. Fremde IDs liefern not_found.

Verbindung

• Server-URL: https://app.miovea.com/api/mcp
• Transport: Streamable HTTP (MCP-Standard)
• Anmeldung: OAuth 2.1; beim ersten Verbinden öffnet sich ein Browser-Login mit dem miovea-Konto des Nutzers, dort wählt er die Organisation. Für MCP braucht es keine API-Keys.
• Beispiel Claude Code: claude mcp add --transport http miovea https://app.miovea.com/api/mcp

Details unter MCP-Server anbinden.

Operationen

Alle Aufrufe laufen über das Tool invoke mit operation_key und arguments. questionnaires.get und questionnaires.answers.set gehören zu den essentials aus get_context; ihre vollständigen Verträge liefert auch describe_operations.

Operation	Zweck
questionnaires.get	Fragebogen lesen: ohne Filter die Sektionsübersicht mit Fortschritt, mit section_key die aktuell sichtbaren Fragen einer Sektion samt Antworten; search, unanswered_only und question_keys filtern sektionsübergreifend
questionnaires.answers.set	Antworten schreiben, bis zu 200 je Aufruf
preinquiries.list	Vorgänge auflisten, falls die Vorgangs-ID fehlt
questionnaires.versions.ensure	Fragebogen anlegen, falls der Vorgang noch keinen hat