Baukasten
Den Chatbot anbinden
Der Chatbot des Kunden führt das Gespräch. Documata gibt den Leitfaden, die Vorlagen und die nächste Frage. Antworten, Namen und Tonaufnahmen bleiben beim Chatbot.
Vor Ort gibt es diese Anbindung nicht. Sie gilt nur in der Cloud und nur für die Variante Baukasten.
Adresse
https://app.documata.io/mcp
Das ist Streamable HTTP, zustandslos, über HTTPS. In der Verwaltung steht bei jedem Baukasten-Auftrag der Link „Chatbot einrichten“. Dort liegt dieselbe Adresse, dazu die Auftragsnummer.
Drei Schritte
- Die Adresse im Chatbot eintragen.
- Mit dem Konto des Auftraggebers anmelden. Fehlt der zweite Faktor noch, wird er dabei eingerichtet, danach geht es weiter zur Bestätigung.
- Diesen Auftrag bestätigen. Die Seite nennt den Chatbot und sagt, dass keine Gesprächsinhalte übertragen werden. Zur Auswahl stehen nur Baukasten-Aufträge dieses Kontos.
Claude, ChatGPT, Gemini
| Chatbot | Was zu tun ist |
|---|---|
| Claude | Ein Owner fügt einen eigenen Connector hinzu und trägt die Adresse ein. Claude registriert sich selbst. Die Person bestätigt nur den Auftrag. |
| ChatGPT | Im Web unter Plugins einen eigenen MCP-Server anlegen und OAuth wählen. In der Handy-App gibt es diese Anbindung nicht. |
| Gemini Enterprise | Auf der Seite „Chatbot einrichten“ den Gemini-Zugang anlegen. Client-ID und Geheimnis erscheinen nur dieses eine Mal. Einzutragen sind Autorisierung https://app.documata.io/oauth/authorize, Token https://app.documata.io/oauth/token, der Umfang mcp offline_access und die feste Rückadresse https://vertexaisearch.cloud.google.com/oauth-redirect. |
Was der Chatbot abruft
Drei Werkzeuge, alle nur lesend.
| Werkzeug | Liefert |
|---|---|
leitfaden | Interview-Leitfaden, Gliederung, Datenstruktur und Prompts. Nimmt nichts an. |
vorlage | Die Vorlage eines Kapitels oder einer Unterlage. Nimmt nur den Namen an. |
naechste_frage | Ziel, Fragestil, Frageform und ob Abschnitt oder Gespräch enden. Der Schlüssel ist die Auftragsnummer. |
An Documata gehen nur diese strukturierten Angaben: Auftragsnummer, Gesprächsnummer, Kapiteltitel, die Schlüssel schon gefüllter Pflichtangaben, die Zahl offener Rückfragen, Zahl und Stile der Fragen im Abschnitt, offene Kapitel. Kein Antworttext, kein Transkript, kein Name.
Die nächste Frage formuliert das Modell aus diesem Stand. Ist die Antwort ungültig oder ist kein Modell angeschlossen, gelten die festen Regeln. Gezählt wird nur, wie oft die nächste Frage je Auftrag und Tag abgerufen wurde.
Das Token gilt nur für /mcp und nur für den bestätigten Auftrag. Eine fremde Auftragsnummer wird abgewiesen. Das Zugriffstoken hält eine Stunde, der Erneuerungsschlüssel 30 Tage. Wird ein schon benutzter Erneuerungsschlüssel erneut geschickt, endet die Verbindung.
Schlüssel für die Probe
Zusätzlich zur Anmeldung kann ein Admin auf derselben Seite einen festen Schlüssel erzeugen. Er steht im Kopf Authorization. Der Rohwert erscheint nur einmal. In der Probe liegt der gemeinsame Schlüssel im Schlüsseltresor, nicht in dieser Anleitung.