Live-Fragebogen per MCP ausfüllen
Für KI-Agenten: maschinenlesbare Version unter https://app.miovea.com/wiki/fragebogen/live-fragebogen.md
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 (UUID) identifiziert. Dein Nutzer gibt dir diese ID; alternativ findest du sie mit
preinquiries_list. - 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 des miovea-Kontos, mit dem du per OAuth verbunden bist. Fremde IDs liefern
NOT_FOUND.
Verbindung
- Server-URL:
https://app.miovea.com/api/mcp - Transport: Streamable HTTP (MCP-Standard)
- Anmeldung: OAuth 2.1 mit Dynamic Client Registration; beim ersten Verbinden öffnet sich ein Browser-Login mit dem miovea-Konto des Nutzers. API-Keys gibt es nicht.
- Beispiel Claude Code:
claude mcp add --transport http miovea https://app.miovea.com/api/mcp
Werkzeuge
| Tool | Zweck |
|---|---|
questionnaire_get | Fragebogen lesen: ohne Parameter 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 |
questionnaire_answers_set | Antworten schreiben (Batch bis 50 Stück) |
preinquiries_list | Vorgänge auflisten, falls die Vorgangs-ID fehlt |
Workflow
- Überblick:
questionnaire_getmitpreinquiry_idohne weitere Parameter liefert alle Sektionen mitvisible_questions,answered_questionsundrequired_unanswered. Das ist dein Inhaltsverzeichnis zum Durchblättern. - Fragen lesen:
questionnaire_getmitsection_keyliefert die aktuell sichtbaren Fragen einer Sektion:question_key,label,answer_type,options, , (Antwortwerte, die Folgefragen einblenden) und die aktuelle Antwort (, , ). Fehlende Felder bedeuten false/leer/unbeantwortet.