Integration von doo mit Agenten (MCP server)
Immer mehr Unternehmen möchten Veranstaltungs‑ und Teilnehmerdaten nicht nur in doo verwalten, sondern diese auch in eigenen Systemen, Automationen oder KI‑gestützten Workflows weiterverwenden.
Mit dem doo MCP Server (Model Context Protocol) stellen wir eine standardisierte Schnittstelle bereit, über die MCP‑fähige Clients strukturiert auf doo‑Daten zugreifen können.
So finden auch Gelegenheitsnutzer einen einfachen Zugang zur leistungsfähigen Event‑Automation‑Plattform von doo. Über natürliche Sprache lassen sich zum Beispiel neue Veranstaltungen anlegen oder vorbereiten – etwa auf Basis vordefinierter Veranstaltungsvorlagen (mehr Informationen dazu finden Sie in unserem Hilfecenter-Artikel zum Thema Event‑Templates).
Um den doo MCP Server nutzen zu können, müssen folgende Schritte von einem Admin bzw. einem Nutzer mit Berechtigung zum Erstellen von Agenten durchlaufen werden. Bitte beachten Sie, dass der Zugriff auf eine einzige doo Organisation beschränkt ist.
1. Client Credentials in doo erstellen
Für den Zugriff auf den MCP Server benötigen Sie Client Credentials. Diese fungieren als Benutzername und Passwort für technische Anwendungen und sind einer bestimmten doo Organisation zugeordnet.
- Loggen Sie sich in Ihre doo Organisation ein.
- Gehen Sie zu den Organisationseinstellungen über das Zahnradsymbol in der Kopfleiste (Administratorrechte erforderlich)
- Wählen Sie den Tab „Nutzer“ und wechseln zum Reiter „Client Credentials“
- Klicken Sie auf “Neue Client Credentials”, vergeben Sie einen internen Namen und klicken Sie auf „Erstellen“
doo generiert nun eine Client ID und ein Client Secret.
Wichtig: Das Client Secret kann nach dem Schließen des Pop‑ups nicht erneut angezeigt werden! Speichern Sie es daher sofort (z. B. in einem Passwortmanager) und behandeln Sie diese Daten genauso vertraulich wie Ihre eigenen doo Logindaten.
2. API Key erzeugen
Für die Authentifizierung gegenüber dem MCP Server wird ein API Key (Bearer Token) benötigt. Es wird aus folgender Zeichenkette gebildet:
client_id:client_secret
Diese Zeichenkette wird Base64‑kodiert und sieht dann beispielsweise so ähnlich aus:
ci_12345_1234567890:cs_a47db9036f2e5c18d9ab41e7c65f8043fb1297de56a0b832cd19e0af43c6d887
→ QzNkTm9tNjhmSjEyMzQ1NkxFOnNYeFpGZ2hpTzlkUVpqM0R3cE1lQjU3Tm5MQXpSWmY4bFhUdnk2bk9uemNiYVRyMDhzcXk0azY3YmEydjM2eXc3PQ==
2.1. Einfache Wege zur Base64‑Kodierung
1. Windows (empfohlen): Verwenden Sie ein lokal installiertes Werkzeug wie PowerShell (Standard in Windows 10/11) oder ggf. certutil (ebenfalls meist vorinstalliert), um den Base64-Token offline auf Ihrem Rechner zu erzeugen.
Beispiel (PowerShell):
- Öffnen Sie PowerShell auf Ihrem Rechner:
- Drücken Sie Win + X → Windows PowerShell.
- Alternativ: Win + R → “powershell” → Enter
- Führen Sie diese beiden Befehle aus und kopieren Sie anschließend den erstellten Token
$Text = "client_id:client_secret"
[System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($Text))
2. Online‑Base64‑Encoder: Nur geeignet für Tests oder temporäre Credentials! Verwenden Sie z.B. https://www.base64encode.org/ – für produktive Zugänge empfehlen wir unbedingt eine lokale Lösung wie Powershell, keine online erstellten Tokens!
3. MCP‑Server konfigurieren
Konfigurieren Sie Ihren MCP‑Client wie folgt:
MCP‑Server‑URL:
https://mcp-organizer.doo.net/mcp
Authorization Header:
Authorization: Bearer <IHR_BASE64_TOKEN>
Wichtig: Zwischen “Bearer” und Ihrem Token muss ein Leerzeichen eingegeben werden.
4. Verbindung testen
- Stellen Sie sicher, dass in doo mindestens eine Veranstaltung existiert
- Führen Sie im MCP‑Client eine erste Abfrage aus
- Werden Organisations‑ oder Veranstaltungsdaten zurückgegeben, ist die Verbindung erfolgreich eingerichtet
5. Verarbeitung personenbezogener Daten über Agenten
Wenn Sie über einen Agenten personenbezogene Daten aus doo verarbeiten, müssen die Anforderungen der DSGVO (z. B. Protokollierung, Zugriffskontrolle und Nachvollziehbarkeit) erfüllt werden.
Dafür haben Sie zwei Möglichkeiten:
a) Umsetzung in Ihrer Agenten‑Plattform
Sie stellen selbst sicher, dass DSGVO‑relevante Funktionen vorhanden sind, z. B.:
- Logging / Audit Trails
- Nachvollziehbarkeit von Aktionen
- Zugriffskontrolle pro Nutzer
- Trennung von Nutzerkontexten
b) Umsetzung in der doo-Plattform
Alternativ können Sie die entsprechenden Funktionen direkt in doo nutzen.
Wichtig: In diesem Fall benötigt jeder Endnutzer eigene Client Credentials.
- Pro Nutzer werden separate Credentials in doo angelegt
- Jeder Nutzer verbindet sich einmalig mit seinen eigenen Credentials
- Alle Aktionen erfolgen im Kontext dieses Nutzers
Die konkrete Umsetzung ist derzeit je nach Agenten‑Plattform unterschiedlich.
Beispiel Microsoft Copilot:
Einstellung „Zu verwendende Anmeldeinformationen“ → „Endbenutzer‑Anmeldeinformationen“