Integrationen
Studien, Fragen und Ergebnisse per REST oder MCP aus anderen Werkzeugen nutzen.
Mit einer Integration greift ein anderes Werkzeug auf dein Team zu, zum Beispiel ein KI-Assistent, der MCP versteht, oder ein eigenes Skript über REST. Es gibt zwei Zugänge: einen API Key, den du in den Einstellungen erstellst, und eine Verbundene App, mit der du Claude oder ChatGPT per Anmeldung mit deinem Team verbindest. Beide handeln als das Mitglied, das sie erstellt oder verbunden hat. Was Geld kostet oder eine laufende Befragung beendet, bestätigt immer dieses Mitglied im Browser.
Was eine Integration kann
Eine Integration sieht, was ihr Mitglied sieht: die Projekte des Mitglieds und die, die mit ihm geteilt sind. Sie kann
- Projekte, Studien, Umfragedesigns, Dateien, Panels und Fragen auflisten
- den Status einer Befragung abfragen, ihren Bericht und die einzelnen Antworten lesen
- Umfragedesigns anlegen und ändern
- Bilder und PDFs ins Projekt eines Designs hochladen
- einen Befragungsstart, eine Frage oder einen Abbruch anfragen, einen Start auch mit einem Ziel
Starten, fragen oder abbrechen kann die Integration nicht selbst. Sie bekommt einen Bestätigungslink, den ihr Mitglied öffnet.
In welchem Projekt es landet
Was eine Integration anlegt, liegt in einem Projekt ihres Mitglieds. Die Integration nennt das Projekt beim Aufruf. Nennt sie keines, legt die App ein neues Projekt an, benannt nach dem Design, der Studie oder der Frage, und die Antwort nennt dieses Projekt, damit die Integration dort weitermacht. Eine Studie aus einem Design liegt im Projekt des Designs. Du findest alles auf der Projektseite wie die Ergebnisse deiner Chats.
| API Key | Verbundene App | |
|---|---|---|
| Handelt als | das Mitglied, das ihn erstellt hat | du, das verbindende Mitglied |
| Bestätigen und hochladen | nur dieses Mitglied | nur du |
| Dateien hochladen | Upload-Seite oder direkt per Upload-Adresse | nur über die Upload-Seite |
Designs, die eine Verbundene App erstellt oder geändert hat, stehen bei der Design-Wahl mit dem Zusatz über Claude · dein Name.
Integrationen einschalten
Integrationen schalten nur Inhaber ein, und sie brauchen einen bezahlten Plan.
- Öffne im Kontomenü Einstellungen > Integrationen.
- Schalte Integrationen ein. Ohne bezahlten Plan steht daneben Nur mit bezahltem Abo.
Schaltest du sie aus, fragt die App Integrationen ausschalten?: Offene Bestätigungs- und Upload-Links werden dauerhaft ungültig, auch wenn du die Integrationen wieder einschaltest. Mitglieder sehen auf dieser Seite den Schalter, die Adressen und ihre eigenen API Keys und Verbundenen Apps.

API Key erstellen
Jedes Mitglied kann API Keys erstellen, sobald die Integrationen eingeschaltet sind.
- Klicke unter API Keys auf Key erstellen.
- Gib einen Name ein, der sagt, wo der Key verwendet wird, etwa
Claude DesktopoderReporting-Skript, und klicke Erstellen. - Der Dialog Neuer API Key zeigt den Key. Kopiere den Key jetzt. Er wird nur einmal angezeigt. Klicke Kopieren und dann Fertig.
Die Tabelle zeigt danach Name, Erstellt und Zuletzt genutzt, aber nie den Key selbst. Brauchst du ihn wieder, erstellst du einen neuen. Inhaber sehen die Keys aller Mitglieder mit der Spalte Mitglied, aber nicht deren Projekte.
Behandle den Key wie ein Passwort: Wer ihn hat, liest und fragt an wie du. Ist ein Key in falsche Hände geraten oder wird nicht mehr gebraucht, klicke Widerrufen und bestätige. Er wirkt sofort nicht mehr, die Zeile zeigt Widerrufen am …. Offene Links, die mit diesem Key entstanden sind, werden ungültig. Du widerrufst deine eigenen Keys, Inhaber jeden Key des Teams.
Ein Key gilt nur, solange sein Mitglied im Team ist. Verlässt es das Team oder wird entfernt, werden seine Keys widerrufen.
Ein Werkzeug mit dem Key verbinden
Unter Adressen stehen die Adressen deines Zugangs, jede mit einem Button zum Kopieren. Mitglieder sehen nur die MCP-Adresse:
| Adresse | Wofür |
|---|---|
| MCP | für KI-Assistenten und andere Werkzeuge, die das Model Context Protocol unterstützen |
| REST | für eigene Skripte und Automatisierungen |
| OpenAPI | die Beschreibung aller REST-Endpunkte, etwa für Entwickler:innen oder Codegeneratoren |
Das Werkzeug schickt den Key im Header Authorization: Bearer <Key> mit. Trag in einem MCP-fähigen Werkzeug die MCP-Adresse als Server ein und hinterlege den Key als diesen Header. Wie das genau geht, steht in der Anleitung des Werkzeugs. Claude und ChatGPT brauchen keinen Key: Sie verbindest du als Verbundene App.
Verbundene Apps
Claude und ChatGPT verbindest du ohne Key: Du trägst die MCP-Adresse ein, meldest dich bei theconsumer.ai an und wählst ein Team. Das kann jedes Mitglied, sobald ein Inhaber die Integrationen eingeschaltet hat. Das Team braucht dafür einen bezahlten Plan.
Claude verbinden
- Kopiere unter Einstellungen > Integrationen die Adresse MCP.
- Öffne in Claude Customize > Connectors und klicke Add custom connector. Trag die MCP-Adresse ein und klicke Add. In einer Team- oder Enterprise-Organisation fügt ein Owner den Connector unter Organization settings > Connectors hinzu, du klickst danach bei dem Connector auf Connect.
- Claude öffnet die Seite Claude mit theconsumer.ai verbinden. Melde dich an, falls nötig. Hast du einen zweiten Faktor eingerichtet, bestätigst du auch den.
- Wähle unter Team das Team, in dem Claude für dich arbeiten soll, und klicke Verbinden. Mit Abbrechen verbindest du nichts. Danach geht es zurück zu Claude.

Teams, in denen die Integrationen aus sind oder der Plan fehlt, sind ausgegraut und nennen den Grund, etwa Integrationen sind aus. Bitte einen Inhaber, sie einzuschalten. Eine Verbindung gilt für genau ein Team. Für ein zweites Team verbindest du die App noch einmal.
ChatGPT verbinden
In ChatGPT fügst du einen eigenen MCP-Server hinzu (Add custom MCP server), trägst die MCP-Adresse ein und wählst die Anmeldung über OAuth. Die genauen Schritte stehen in der Anleitung von ChatGPT. Die Verbindungsseite und die Team-Wahl sind dieselben wie bei Claude; ChatGPT meldet sich dort als Codex.
Verbindungen sehen und trennen
Unter Einstellungen > Integrationen > Verbundene Apps siehst du deine Verbindungen mit App, Verbunden und Zuletzt genutzt. Inhaber sehen die Verbindungen aller Mitglieder, mit der Spalte Mitglied.

Mit Trennen beendest du eine Verbindung sofort: Die App verliert den Zugriff auf dieses Team, die Zeile zeigt Getrennt am …, und offene Bestätigungs- und Upload-Links dieser Verbindung werden ungültig. Befragungen, die du schon bestätigt hast, laufen weiter. Inhaber trennen jede Verbindung, Mitglieder ihre eigenen. Eine Verbindung endet auch, wenn du das Team verlässt oder daraus entfernt wirst, und nach 90 Tagen von selbst. Sind die Integrationen aus oder ist der Plan beendet, kommt keine Verbundene App durch, bis beides wieder gilt. Zum erneuten Verbinden startest du die Verbindung in Claude oder ChatGPT neu.
Eine Verbundene App lädt die Liste der Werkzeuge nicht von selbst neu. Ändern sich Werkzeuge (siehe Änderungen an der API), verbindest du Claude oder ChatGPT neu, damit die App die neuen Namen kennt.
Die Bestätigungsseite
Fragt eine Integration einen Start, eine Frage oder einen Abbruch an, gibt sie dir einen Link. Öffne ihn im Browser und melde dich an, falls nötig. Bestätigen kann nur das Mitglied, als das die Integration handelt: bei einem API Key, wer ihn erstellt hat, bei einer Verbundenen App, wer sie verbunden hat.
Die Seite nennt in der Überschrift, worum es geht: Befragung starten, Frage stellen oder Befragung abbrechen. Darunter steht die Herkunft mit dem Datum: Angefragt über API Key „…“ mit dem Namen des Keys oder Angefragt über Claude · Name mit der App und dem Mitglied, dann die Details:
- Studie, Zielgruppe mit Zahl der Befragten, Fragen mit Stimuli, Preis und Verfügbar
- bei einer einzelnen Frage die Frage selbst und, falls vorhanden, die Nachfrage
- bei einem Abbruch die Folgen: Bisherige Antworten bleiben lesbar, es gibt keinen Bericht, bezahlt werden nur vollständige Befragte.
Mit Starten, Frage stellen oder Befragung abbrechen bestätigst du, mit Verwerfen lehnst du ab, ohne dass etwas abgebucht wird. Ein Link gilt 7 Tage, die Seite zeigt das Ende als Link gültig bis ….


Wer bestätigt, gilt als Starter: Der Preis zählt zu deinem Credit-Limit, und die Benachrichtigungen zur Befragung gehen an dich. Die Studie liegt im Projekt, in dem die Integration sie vorbereitet hat; wer dieses Projekt sieht, sieht auch sie. Hat sich seit der Anfrage etwas geändert, zeigt die Seite einen Hinweis, etwa Der Stand hat sich geändert. Prüfe ihn und bestätige erneut.
Öffnet ein anderes Mitglied den Link, sieht es keine Details, sondern Nur Name kann diese Studie starten (bei Fragen … diese Frage stellen, bei Abbrüchen … diese Befragung abbrechen) mit dem Hinweis, als wer es angemeldet ist. Konto wechseln meldet dich ab und führt nach der Anmeldung zurück zum Link.

| Ergebnis | Bedeutung |
|---|---|
| Befragung gestartet / Frage gestellt | Erledigt. Mit Studie ansehen öffnest du die Studie. |
| Verworfen | Abgelehnt, es wurden keine Credits abgebucht. |
| Link abgelaufen | Die 7 Tage sind um. Lass die Integration neu anfragen. |
| Link ungültig | Der Key wurde widerrufen, die Verbindung wurde getrennt oder ist abgelaufen, das Mitglied hat das Team verlassen, die Integrationen wurden ausgeschaltet oder das Abo war beendet. Der Grund steht darunter. |
| Nicht gestartet | Der Start ging nicht, es wurden keine Credits abgebucht. Der Grund steht darunter. |
Fragen über eine Integration
Eine Integration kann einem ganzen Panel eine offene Frage stellen, ohne Bilder. Nach deiner Bestätigung auf Frage stellen liegt die Frage im Projekt, das die Integration genannt hat, unter Fragen, wie eine Frage aus deinem Chat. Ist die Frage beantwortet, meldet die Bestätigungsseite Ergebnis liegt vor, und die Integration kann die Antworten abrufen. Eine Benachrichtigung gibt es dafür nicht. Wie Fragen funktionieren, steht unter Fragen & Nachbefragung.
Dateien über die Upload-Seite
Braucht ein Design Bilder oder PDFs, kann die Integration einen Upload-Link anfordern. Die Seite Dateien hochladen nennt die Herkunft wie die Bestätigungsseite, das Design und wie viel Platz es noch hat, etwa noch 17 von 20 frei. Den Link kann nur das Mitglied der Integration nutzen; andere Mitglieder sehen Nur Name kann hier hochladen und Konto wechseln.
- Zieh die Dateien in das Feld oder wähle sie aus: JPG, PNG, WebP bis 10 MB · PDF bis 12 MB.
- Klicke Fertig. Die Seite meldet Dateien sind im Projekt.
Die Integration ordnet die Dateien danach dem Design als Stimuli zu. Ein Upload-Link gilt ebenfalls 7 Tage.
Dateien direkt hochladen
Ein API Key kann Dateien auch ohne Upload-Seite direkt über eine Upload-Adresse schicken, eine Verbundene App nicht. So kommen Bilder (JPG, PNG, WebP) und PDFs bis 50 MB ins Projekt des Designs, ein PDF bis 150 Seiten. Die Datei liegt danach in diesem Projekt und taugt als Stimulus eines Designs. Die engeren Grenzen für Stimuli (Bilder bis 10 MB, PDFs bis 12 MB und 20 Seiten, je Frage zusammen bis 12 MB und 60 PDF-Seiten) prüft die App erst, wenn die Integration die Datei einem Design als Stimulus zuordnet.
Ein hochgeladenes PDF liest die App danach ein. Wie weit sie ist, sieht die Integration beim Abrufen der Datei, siehe unten.
Ziel mitgeben
Eine Integration kann der Studie auch ein Ziel mitgeben: die Geschäftsentscheidung, die die Studie stützt, in einem Satz. Mit dem Klick auf Starten übernimmt die neue Studie es als ihr Ziel, und die Befragung hält den Stand fest. Die Bestätigungsseite zeigt das Ziel nicht, denn dort geht es um Umfang und Kosten.
Für Entwickler: REST und MCP
REST und MCP bieten dieselben Werkzeuge mit denselben Namen. Die vollständige Beschreibung jedes Werkzeugs steht in der OpenAPI-Beschreibung unter Adressen. Für Projekte und Dateien gilt:
| Werkzeug (MCP) | REST | Was es tut |
|---|---|---|
list_projects | GET /projects | Projekte des Mitglieds auflisten: eigene und geteilte. Ihre id geht als projectId an die anlegenden Werkzeuge. |
start_file_upload | POST /file-uploads | Upload starten: liefert eine signierte Adresse für die Bytes. Nur API Key. |
finish_file_upload | POST /file-uploads/{uploadId}/finish | Upload abschließen: liefert die Datei. |
list_files | GET /files | Dateien der Projekte auflisten, die das Mitglied sieht: Bilder und PDFs |
get_file | GET /files/{fileId} | Eine Datei mit Download-Adresse |
request_survey_start | POST /requests/survey-start | Befragungsstart anfragen, optional mit studyGoal |
Verarbeitung eines PDFs. get_file und list_files liefern das Feld processing, bei Bildern null. Bei PDFs:
| Feld | Werte |
|---|---|
state | processing (wird eingelesen), processed (gelesen), partial (einzelne Seiten fehlen), failed (nicht lesbar) |
pageCount | Zahl der Seiten |
failureReason | nur bei failed: too_many_pages, unreadable, content_mismatch oder no_pages_extracted |
missingPages | nur bei partial: die Seiten, die fehlen |
indexState | ob das PDF durchsuchbar ist: pending, indexed oder failed; null, solange state processing oder failed ist |
Nach einem Upload fragt die Integration get_file ab, bis state nicht mehr processing ist.
Ziel beim Start. studyGoal ist ein Text von höchstens 500 Zeichen; Leerzeichen am Anfang und Ende fallen weg, ein leeres Ziel gilt als keins. Längere Ziele beantwortet die API mit invalid_request. Das Ziel gehört zur Identität der Anfrage: Ohne requestKey ist ein anderes Ziel eine andere Anfrage, ein requestKey mit einem anderen Ziel ergibt invalid_request.
Upload-Grenzen. start_file_upload und finish_file_upload prüfen die Grenzen für Dateien: Bilder und PDFs bis 50 MB (maxBytes ist 52428800), ein PDF bis 150 Seiten. Darüber antworten start_file_upload (nach der angegebenen Größe) und finish_file_upload (nach der hochgeladenen Datei) mit invalid_request. Die Grenzen für Stimuli prüft erst update_survey_design. Die Upload-Seite (request_image_upload_link) prüft weiterhin die Grenzen für Stimuli.
Änderungen an der API
November 2026
- Breaking Change: Ein API Key handelt als das Mitglied, das ihn erstellt hat, nicht mehr als das Team. Er sieht, was dieses Mitglied sieht, und nur dieses Mitglied bestätigt, was er anfragt. Verlässt das Mitglied das Team, wird der Key widerrufen.
- Neues Werkzeug
list_projects(GET /projects). Die anlegenden Werkzeuge nehmen optionalprojectIdan; ohne legt die App ein neues Projekt an und nennt es in der Antwort. - Breaking Change:
request_survey_startnimmt keinstudyContextFileIdsmehr an. Was jede Auswertung mitliest, steht in den Anweisungen des Projekts. - Breaking Change: Die Werkzeuge für Dateien heißen jetzt
list_files,get_file,start_file_uploadundfinish_file_upload(vorherlist_materials,get_material,start_material_uploadundfinish_material_upload). Die REST-Pfade wechseln von/materialszu/filesund von/material-uploadszu/file-uploads. AusmaterialIdwirdfileId, ausstudyContextMaterialIdswirdstudyContextFileIds, aus dem Fehlercodematerial_unreadablewirdfile_unreadable; die Ergebnisse heißenfilesundfile. Die alten Namen und Pfade gibt es nicht mehr. - Verbinde Claude oder ChatGPT neu, damit die App die neuen Werkzeuge kennt.
Oktober 2026
- Breaking Change:
start_image_uploadheißt jetztstart_material_upload,finish_image_uploadheißtfinish_material_upload. Die REST-Pfade wechseln von/image-uploadszu/material-uploads. Die alten Namen und Pfade gibt es nicht mehr. - Ein Upload prüft die Grenzen für Dateien (50 MB, PDF bis 150 Seiten) statt der Grenzen für Stimuli. Die Grenzen für Stimuli prüft erst die Zuordnung zu einem Design.
request_survey_startnimmt optionalstudyContextMaterialIdsan. Neuer Fehlercodematerial_unreadable; Fehler zu einer Datei nennen sie im FeldmaterialId.list_materialslistet Bilder und PDFs,get_materialliefert auch PDFs. Beide haben das neue Feldprocessing.request_survey_startnimmt optionalstudyGoalan, das Ziel der neuen Studie (höchstens 500 Zeichen). Es gehört zur Identität der Anfrage.