Umfragen mit eigener KI bauen: Fragebögen per API oder MCP erstellen

Viele Organisationen haben inzwischen eine klare Vorgabe, welche KI sie einsetzen dürfen: ein bestimmtes Modell eines großen Anbieters, ein Modell in der eigenen Cloud oder ein offenes Modell, das sie selbst oder ein deutscher Rechenzentrumsbetreiber betreibt. Wer mit KI Umfragen bauen will, braucht dann eine Plattform, die mit genau dieser KI arbeitet, statt eine eigene mitzubringen.

Dieser Beitrag zeigt, wie Sie Ihre eigene KI an Survkit anbinden, was sie dort bauen kann und wie Sie steuern, worauf sie zugreifen darf. Er richtet sich an alle, die eine Befragung mit ihrer eigenen KI bauen wollen, und an die IT, die das freigeben soll.

Zwei Wege: Survkit Agent oder Ihre eigene KI

Bei Survkit gibt es zwei Möglichkeiten, mit KI zu bauen:

• Survkit Agent. Der Agent läuft direkt auf der Plattform. Sie beschreiben im Chat, was die Befragung leisten soll, und sehen jeden Schritt in der Vorschau.
• Ihre eigene KI. Sie bringen Ihre KI mit, und sie arbeitet mit denselben Bausteinen wie der Survkit Agent. Das kann ein Modell eines großen Anbieters sein, ein selbst gehostetes Modell oder ein offenes Modell bei einem deutschen Anbieter.

Für die eigene KI gibt es drei Anschlüsse:

In allen drei Fällen arbeitet Ihre KI mit einem Zugang, dessen Rechte Sie festlegen. Den Survkit Agent müssen Sie dafür nie nutzen.

Warum die API der offizielle Weg ist

Die API ist eine gewöhnliche Programmierschnittstelle über HTTP. Jeder Agent und jedes Skript kann sie nutzen, ohne zusätzliche Software. Sie ist vollständig dokumentiert, und die Dokumentation wird vom laufenden System selbst ausgeliefert, passt also immer zum aktuellen Stand. MCP ist eine bequeme Hülle für Agenten, die dieses Protokoll ohnehin sprechen; dahinter stehen dieselben Funktionen und dieselben Rechte.

Was Ihre KI in Survkit bauen kann

Ihre KI baut nicht nur Fragebögen. Sie baut die ganze Befragung, so wie sie in unserem Beitrag zur KI-nativen Umfrageplattform beschrieben ist:

• Fragebogen und Oberfläche. Eine Befragung besteht bei Survkit aus zwei Teilen: der Definition (Fragen, Skalen, Antwortformate) und einem Modul, das sie für die Teilnehmenden darstellt. Das Modul ist eine kleine Web-Anwendung, die Ihre KI frei gestaltet und die abgeschottet auf der Plattform läuft.
• Teilnehmende und Zugänge. Personen anlegen oder importieren, Merkmale und Organigramme pflegen, persönliche Zugangslinks erzeugen.
• Texte und Übersetzungen. Alle Texte der Befragung in mehreren Sprachen.
• Einladungen und Erinnerungen. Vorlagen für E-Mails, Versand und automatische Erinnerungen.
• Dashboards und Berichte. Auswertungen aus der k-anonymen Statistik-Engine, Berichte als PDF, in Ihrer eigenen Word- oder PowerPoint-Vorlage oder als neu erzeugtes Dokument.
• Testdaten. Realistische Beispieldaten mit einem einzigen Aufruf, getrennt von echten Teilnehmenden.
• Offene Antworten. Wenn Sie es ausdrücklich freigeben: Kommentare Themen zuordnen und auf identifizierende Inhalte prüfen.

So binden Sie Ihre KI an: sechs Schritte

1. Zugang im Projekt anlegen

In den Einstellungen des Projekts legen Sie unter „Agent-Tokens“ einen Zugang an und wählen, welche Rechte er hat. Jeder Zugang gilt für genau ein Projekt.

2. Die KI den Leitfaden lesen lassen

Geben Sie Ihrer KI den Zugang und den Einstieg in die Dokumentation: go.survkit.com/api/agent/v1/guide. Der Leitfaden ist für KI-Agenten geschrieben. Er erklärt den Aufbau einer Befragung und verweist auf die Detaildokumente, die die KI je nach Aufgabe nachlädt.

3. Verbindung prüfen

Als Erstes fragt die KI ab, mit welchem Projekt und welchen Rechten sie verbunden ist:

curl -s https://on.survkit.com/api/agent/v1/whoami \
  -H "Authorization: Bearer <Ihr Token>"

Über MCP verbindet sich Ihr Agent mit https://on.survkit.com/mcp und schickt denselben Token im Header Authorization mit. Wie das eingetragen wird, hängt vom jeweiligen Agenten ab.

4. Bauen lassen

Jetzt beschreiben Sie Ihrer KI, was die Befragung leisten soll: wer teilnimmt, welche Themen gefragt werden, wer welche Ergebnisse sehen soll und wie der Bericht aussehen soll. Die KI legt Definition, Modul, Texte und Zugänge an.

5. Mit Testdaten prüfen

Die KI erzeugt Beispieldaten, und Sie prüfen Befragung, Dashboard und Bericht so, als wäre die Befragung schon gelaufen. Änderungswünsche gehen zurück an die KI.

6. Zugang widerrufen

Wenn die Befragung abgenommen ist, widerrufen Sie den Zugang, bevor echte Antworten eingehen. Ab der nächsten Anfrage ist er gesperrt. Die Befragung läuft danach ohne KI.

Rechte: Was die KI darf, und was nie

Die Rechte eines Zugangs sind feingranular, jeweils getrennt nach Lesen und Schreiben. Einige Beispiele:

Einzelne Antworten und offene Antworten sind eigene Rechte, die die empfohlene Voreinstellung nicht enthält. Für das Bauen mit Testdaten braucht die KI kein Leserecht auf einzelne Antworten.

Einige Dinge kann ein Zugang grundsätzlich nicht, egal welche Rechte er hat: Passwörter setzen, auf andere Projekte zugreifen oder Konten und Mitglieder verwalten. Zusätzlich lassen sich freigegebene Texte sperren; was die KI dort ändern will, landet dann als Vorschlag zur Prüfung, statt direkt übernommen zu werden. Und wer nachvollziehen will, was eine KI im Projekt getan hat, schaltet das Protokoll für Schreibzugriffe oder für alle Zugriffe ein.

Eine Einschränkung gilt dabei wie für Menschen: Wer weitreichende Rechte in einem Projekt hat, kommt grundsätzlich auch an dessen Daten. Deshalb ist die Reihenfolge aus den sechs Schritten wichtig: bauen, solange es nur Testdaten gibt, und den Zugang vor dem Start entziehen. Mehr dazu im Beitrag Datenschutz bei KI-Umfragen.

Welche KI eignet sich?

Grundsätzlich jede, die HTTP-Anfragen stellen oder MCP sprechen kann und lange Dokumente verarbeitet. Weil die Oberfläche einer Befragung ein kleines Programm ist, hilft es, wenn das Modell gut programmieren kann. Ob es bei einem großen Anbieter läuft, in Ihrer eigenen Infrastruktur oder bei einem deutschen Anbieter offener Modelle, spielt für Survkit keine Rolle. Es ist Ihre Entscheidung, und sie bestimmt, wohin die Anweisungen fließen, die Ihre KI beim Bauen bekommt.

Häufige Fragen

Gibt es eine öffentliche API-Dokumentation?

Ja. Der Einstieg liegt unter go.survkit.com/api/agent/v1/guide, von dort verweist er auf die Referenz und die Detaildokumente. Die Dokumentation wird vom laufenden System ausgeliefert und passt deshalb immer zum aktuellen Stand.

API oder MCP: Was soll ich nehmen?

Die API ist der offizielle Weg und funktioniert mit jedem Agenten und jedem Skript. MCP lohnt sich, wenn Ihr Agent es ohnehin spricht. Beide nutzen denselben Zugang mit denselben Rechten.

Kann ich ein selbst gehostetes Modell nutzen?

Ja. Ihre KI muss nur die Schnittstelle erreichen können. Wo das Modell selbst läuft, entscheiden Sie.

Kann die KI auf die Antworten der Teilnehmenden zugreifen?

Nur, wenn ihr Zugang die entsprechenden Rechte hat. Zum Bauen reichen Testdaten. Widerrufen Sie den Zugang vor dem Start, gibt es im laufenden Betrieb keine KI, die an Antworten kommen könnte.

Brauche ich den Survkit Agent?

Nein. Sie können ausschließlich mit Ihrer eigenen KI bauen oder beides mischen, je nach Projekt.