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 KeyVerbundene App
Handelt alsdas Mitglied, das ihn erstellt hatdu, das verbindende Mitglied
Bestätigen und hochladennur dieses Mitgliednur du
Dateien hochladenUpload-Seite oder direkt per Upload-Adressenur ü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.

  1. Öffne im Kontomenü Einstellungen > Integrationen.
  2. 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.

Seite Integrationen mit eingeschaltetem Schalter, der Tabelle API Keys mit einem Key namens Claude Desktop und den Adressen für MCP, REST und OpenAPI
Integrationen mit einem API Key

API Key erstellen

Jedes Mitglied kann API Keys erstellen, sobald die Integrationen eingeschaltet sind.

  1. Klicke unter API Keys auf Key erstellen.
  2. Gib einen Name ein, der sagt, wo der Key verwendet wird, etwa Claude Desktop oder Reporting-Skript, und klicke Erstellen.
  3. 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:

AdresseWofür
MCPfür KI-Assistenten und andere Werkzeuge, die das Model Context Protocol unterstützen
RESTfür eigene Skripte und Automatisierungen
OpenAPIdie 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

  1. Kopiere unter Einstellungen > Integrationen die Adresse MCP.
  2. Ö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.
  3. 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.
  4. 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.
Seite Claude mit theconsumer.ai verbinden mit der Team-Auswahl, in der ein Team wählbar ist und ein zweites ausgegraut mit dem Hinweis, dass die Integrationen aus sind, sowie den Buttons Verbinden und Abbrechen
Die Verbindungsseite mit der Team-Wahl

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.

Abschnitt Verbundene Apps mit einer Zeile Claude, dem Mitglied, dem Datum der Verbindung, der letzten Nutzung und dem Button Trennen
Verbundene Apps aus Sicht eines Inhabers

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 ….

Bestätigungsseite mit der Überschrift Befragung starten, der Zeile, über welchen API Key angefragt wurde, den Zeilen Studie, Zielgruppe, Fragen und Preis sowie den Buttons Starten und Verwerfen
Ein API Key fragt einen Befragungsstart an
Bestätigungsseite mit der Überschrift Befragung starten und der Zeile Angefragt über Claude mit dem Namen des Mitglieds, darunter Studie, Zielgruppe, Fragen und Preis sowie die Buttons Starten und Verwerfen
Eine Verbundene App fragt einen Befragungsstart an

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.

Bestätigungsseite mit der Überschrift Nur Alex Becker kann diese Studie starten, dem Hinweis, dass du als anderes Mitglied angemeldet bist und die Studie über die Verbindung von Alex Becker zu Claude vorbereitet wurde, sowie dem Button Konto wechseln
Ein anderes Mitglied öffnet den Link einer Verbundenen App
ErgebnisBedeutung
Befragung gestartet / Frage gestelltErledigt. Mit Studie ansehen öffnest du die Studie.
VerworfenAbgelehnt, es wurden keine Credits abgebucht.
Link abgelaufenDie 7 Tage sind um. Lass die Integration neu anfragen.
Link ungültigDer 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 gestartetDer 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.

  1. Zieh die Dateien in das Feld oder wähle sie aus: JPG, PNG, WebP bis 10 MB · PDF bis 12 MB.
  2. 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)RESTWas es tut
list_projectsGET /projectsProjekte des Mitglieds auflisten: eigene und geteilte. Ihre id geht als projectId an die anlegenden Werkzeuge.
start_file_uploadPOST /file-uploadsUpload starten: liefert eine signierte Adresse für die Bytes. Nur API Key.
finish_file_uploadPOST /file-uploads/{uploadId}/finishUpload abschließen: liefert die Datei.
list_filesGET /filesDateien der Projekte auflisten, die das Mitglied sieht: Bilder und PDFs
get_fileGET /files/{fileId}Eine Datei mit Download-Adresse
request_survey_startPOST /requests/survey-startBefragungsstart anfragen, optional mit studyGoal

Verarbeitung eines PDFs. get_file und list_files liefern das Feld processing, bei Bildern null. Bei PDFs:

FeldWerte
stateprocessing (wird eingelesen), processed (gelesen), partial (einzelne Seiten fehlen), failed (nicht lesbar)
pageCountZahl der Seiten
failureReasonnur bei failed: too_many_pages, unreadable, content_mismatch oder no_pages_extracted
missingPagesnur bei partial: die Seiten, die fehlen
indexStateob 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 optional projectId an; ohne legt die App ein neues Projekt an und nennt es in der Antwort.
  • Breaking Change: request_survey_start nimmt kein studyContextFileIds mehr 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_upload und finish_file_upload (vorher list_materials, get_material, start_material_upload und finish_material_upload). Die REST-Pfade wechseln von /materials zu /files und von /material-uploads zu /file-uploads. Aus materialId wird fileId, aus studyContextMaterialIds wird studyContextFileIds, aus dem Fehlercode material_unreadable wird file_unreadable; die Ergebnisse heißen files und file. 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_upload heißt jetzt start_material_upload, finish_image_upload heißt finish_material_upload. Die REST-Pfade wechseln von /image-uploads zu /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_start nimmt optional studyContextMaterialIds an. Neuer Fehlercode material_unreadable; Fehler zu einer Datei nennen sie im Feld materialId.
  • list_materials listet Bilder und PDFs, get_material liefert auch PDFs. Beide haben das neue Feld processing.
  • request_survey_start nimmt optional studyGoal an, das Ziel der neuen Studie (höchstens 500 Zeichen). Es gehört zur Identität der Anfrage.