01KI und Integrationen · Modul
MCP-Anbindung für externe KI-Agenten
Verbinden Sie Claude Code, Codex und weitere Agenten unter konkreten Benutzerberechtigungen mit Ihrem ERP
- API-Schlüssel
- Personal Access Token
- MCP-Token
- KI-Unterhaltung
- 13
- Fähigkeiten
- 4
- Datensatztypen
- 3
- Automatisierungen
- 12
- Integrationen und KI-Tools
02Was das Modul leistet
Weniger Routine. Mehr Mehrwert.
Über MCP (Model Context Protocol) können externe KI-Agenten wie Claude Code oder Codex mit Daten in Draivix arbeiten. Der Agent erhält denselben Werkzeugkatalog wie der integrierte Assistent, und jeder Aufruf erfolgt unter den Berechtigungen und dem API-Schlüssel eines bestimmten Benutzers. So bindet Ihr Unternehmen eigene Agenten an, ohne Zugriffskontrollen oder Audit-Protokolle zu umgehen.
- Der Agent weiß, was er aufrufen darfEin externer KI-Agent lädt einen Werkzeugkatalog samt Beschreibung der Ein- und Ausgabeparameter herunter. Ihre Agenten arbeiten mit Daten über eine dokumentierte Schnittstelle statt auf Basis von Vermutungen.
- 85 Werkzeuge über einen einzigen EndpunktÜber einen einzigen Endpunkt greift ein Agent auf alle 85 freigegebenen Werkzeuge des integrierten Assistenten zu – das hält die Anbindung eigener Agenten schlank und übersichtlich.
- Integrierte Sicherung durch ÄnderungsvorschlägeSchreibvorgänge über die Capability Bridge liefern standardmäßig zunächst einen Vorschlag zurück. Der Agent oder ein Benutzer bestätigt ihn mit mutation_confirm oder verwirft ihn mit mutation_cancel.
- Schlüssel auf ausgewählte Werkzeuge beschränktDer API-Schlüssel, mit dem sich ein Agent anmeldet, kann auf eine explizite Liste von Werkzeugen eingeschränkt werden. Der Agent erhält nur genau das, was Ihr Unternehmen zulässt – und nicht mehr.
- Schlüssel dauerhaft an den Clean-Room-Modus gebundenEin API-Schlüssel kann für sensible Daten dauerhaft auf den Clean-Room-Modus festgelegt werden. Ein solcher Schlüssel sieht im Katalog ausschließlich Clean-Room-Werkzeuge.
- Agenten überschreiten niemals BenutzerrechteDer effektive Zugriff eines Agenten ist die Schnittmenge aus den Berechtigungen des Benutzers und der Obergrenze des API-Schlüssels. Der Agent kann nur tun, was beides zulässt, und der Schlüssel allein schaltet niemals einen Datensatz frei.
- Dedizierter Server für Ihre AgentenDer eigenständige MCP-Server (Model Context Protocol) newerp-agents-mcp bietet 53 Werkzeuge auf Basis der REST API. Seine Schreibzugriffe werden sofort im Rahmen der Benutzerberechtigungen ausgeführt, ohne Freigabevorschläge.
- Authentifizierung passend zum AgentenEin Agent meldet sich mit einem übergebenen Token, einem Personal Access Token oder durch Signieren einer Challenge mit einem SSH-Schlüssel an – ideal für Agenten auf der Kommandozeile.
- Agentenarbeit direkt an der Aufgabe nachvollziehbar12 Werkzeuge verknüpfen die Arbeit des Agenten mit Aufgaben und Code-Commits in GitLab, sodass Sie direkt am Aufgabendatensatz sehen, was der Agent umgesetzt hat.
- Chat- und Dokumentenwerkzeuge nach BedarfDer Server lässt sich um optionale Werkzeuge für Mattermost sowie eine Gemini-gestützte Dokumentenanalyse (erfordert einen Gemini-API-Schlüssel) erweitern. Aktivieren Sie nur das, was Sie tatsächlich nutzen.
- Jeder Aufruf im Audit-Protokoll erfasstJeder Agentenaufruf wird mit der Quelle mcp im Audit-Protokoll gespeichert. So können Sie jederzeit nachvollziehen, was ein externer Agent und was ein Mitarbeiter in der Anwendung ausgeführt hat.
- Begrenzt auf 600 Aufrufe pro MinuteDie Capability Bridge – die direkt in Draivix integrierte Agentenschnittstelle – ist auf 600 Aufrufe pro Minute limitiert und hält die Systemlast durch Agenten in klaren Grenzen.
- Übergabe von Unterhaltungen an HermesEine Unterhaltung aus dem Assistenten kann mit einem kurzlebigen, 300 Sekunden gültigen Berechtigungsnachweis an den Hermes-Agentendienst übergeben werden. Sie läuft unter den Berechtigungen des Benutzers, der die Unterhaltung gestartet hat, und wird im Audit-Trail protokolliert.
03Funktionsweise
So funktioniert es Schritt für Schritt.
Zwei Wege für Agenten
Der erste Weg ist die direkt in Draivix integrierte Capability Bridge. Ein Agent lädt den Werkzeugkatalog herunter und ruft Werkzeuge über einen einzigen Endpunkt auf. Der Katalog umfasst die freigegebenen Werkzeuge des integrierten Assistenten (85 von rund 100 registrierten Werkzeugen) sowie neun Aktionen: Bestätigen oder Verwerfen eines Änderungsvorschlags, Bearbeiten einzelner Positionen in einem Massenvorschlag, Versenden einer E-Mail sowie Schließen einer angezeigten Arbeitsfläche (Canvas). Der Katalog ist versioniert; hat sich nichts geändert, meldet der Server zurück, dass der Stand aktuell ist, sodass der Agent ihn nicht erneut herunterladen muss.
Im Detail lesen
Der zweite Weg ist der eigenständige MCP-Server newerp-agents-mcp, der die allgemeine REST API für Entwicklungs- und Betriebsagenten kapselt. Er stellt 53 Werkzeuge bereit: für die Arbeit mit Datensätzen und Metadaten, Verknüpfungen, Anhängen, E-Mails, Aufgaben, Aktivitäten und Berichten, für die globale Suche, den Kalender, 12 Werkzeuge zur Verknüpfung der Agentenarbeit mit GitLab-Aufgaben und -Commits sowie optional 7 Werkzeuge für Mattermost. Das Werkzeug zur Dokumentenanalyse setzt einen Gemini-API-Schlüssel voraus. Der Server läuft über stdio oder HTTP und kürzt Antworten passend zu, damit sie in das Kontextfenster des Modells passen.
Berechtigungen und API-Schlüssel
Ein Agent handelt immer im Namen eines bestimmten Benutzers. Die Berechtigung für die Capability Bridge erlaubt dem Schlüssel lediglich den Zugriff auf die Schnittstelle – für sich genommen gewährt sie keinerlei Zugriff auf Datensätze. Der effektive Zugriff ergibt sich aus der Schnittmenge der Benutzerberechtigungen und der Obergrenze des API-Schlüssels. Ein Schlüssel lässt sich auf eine definierte Liste von Werkzeugen beschränken und dauerhaft an den Clean-Room-Modus binden; ein solcher Schlüssel sieht im Katalog ausschließlich Clean-Room-Werkzeuge.
Im Detail lesen
Der Server newerp-agents-mcp besitzt keine eigenen Berechtigungen: Jeder Aufruf übermittelt ein Benutzertoken und durchläuft die reguläre REST API. Agenten können sich über ein übergebenes Bearer-Token, ein Personal Access Token oder durch das Signieren einer Challenge mit einem SSH-Schlüssel authentifizieren – letzteres eignet sich ideal für Kommandozeilen-Agenten.
Die Capability Bridge ist auf 600 Aufrufe pro Minute begrenzt. Jeder Aufruf läuft in einem Audit-Kontext, der mit der Quelle mcp und einer Trace-ID gekennzeichnet ist. Ob ein Werkzeug Daten verändert, wird dem Agenten als standardisierter MCP-Hinweis (nur lesend oder schreibend) übergeben.
Änderungskontrolle
Die Capability Bridge folgt derselben Regel wie der integrierte Assistent: Werkzeuge zum Anlegen, Aktualisieren und Löschen geben standardmäßig einen Vorschlag zurück. Entweder der Agent oder ein Benutzer bestätigt diesen über mutation_confirm oder verwirft ihn über mutation_cancel. Bei der Bestätigung wird der eigentliche Vorgang erneut unter den Berechtigungen des Benutzers ausgeführt.
Im Detail lesen
Der Server newerp-agents-mcp nutzt weder Vorschläge noch den Clean-Room-Modus. Seine Schreibvorgänge werden sofort ausgeführt – stets im Rahmen der Berechtigungen desjenigen Benutzers, dessen Token der Agent verwendet. Für Agenten, bei denen Sie jede Änderung einzeln freigeben möchten, nutzen Sie stattdessen die Capability Bridge.
Delegation an den Hermes-Agentendienst
Eine Unterhaltung im integrierten Assistenten kann an den Hermes-Agentendienst übergeben werden. Hermes erhält einen kurzlebigen, an das Unternehmen gebundenen Berechtigungsnachweis mit 300 Sekunden Gültigkeit und greift darüber über die Capability Bridge zurück. Die Aufrufe laufen mit den Berechtigungen des Benutzers, der die Unterhaltung gestartet hat; ein aktiver Clean-Room-Modus kann dabei nicht aufgeweicht werden. Jeder delegierte Aufruf wird im Audit-Protokoll als sicherheitsrelevant vermerkt.
04Was automatisch abläuft
Automatisierungen, die Zeit sparen.
Kein unnötiges Herunterladen des Katalogs
Der Werkzeugkatalog wird pro Unternehmen und Version für 15 Minuten zwischengespeichert. Fragt ein Agent an und der Katalog hat sich nicht geändert, sendet der Server ihn nicht erneut und der Agent spart sich den Download.
Ein Audit-Trail für jeden Aufruf
Jeder Agentenaufruf erzeugt automatisch einen Eintrag im Audit-Protokoll, markiert mit der Quelle mcp und einer Trace-ID. So lässt sich jede einzelne Aktion später mühelos nachverfolgen.
Berechtigungsnachweise laufen automatisch ab
Wird eine Unterhaltung übergeben, erhält der Hermes-Dienst einen an das Unternehmen gebundenen Berechtigungsnachweis, der nach 300 Sekunden abläuft – der Zugriff bleibt damit strikt kurzlebig.
Externe Integrationen
- Claude Code als AgentVerbinden Sie Claude Code über MCP (Model Context Protocol) mit Draivix. Es arbeitet mit Daten unter den Berechtigungen und dem API-Schlüssel eines bestimmten Benutzers, ohne Berechtigungsprüfungen oder das Audit-Protokoll zu umgehen.
- Codex nach denselben RegelnCodex verbindet sich über MCP mit Draivix und erhält denselben Werkzeugkatalog wie der integrierte Assistent. Jeder Aufruf erfolgt unter den Berechtigungen eines bestimmten Benutzers.
- Hermes übernimmt die UnterhaltungDer Hermes-Agentendienst übernimmt eine übergebene Unterhaltung vom Assistenten und greift über die Capability Bridge zurück. Ein aktiver Clean-Room-Modus kann nicht ausgeweitet werden, und jeder Aufruf wird im Audit-Protokoll festgehalten.
- Dokumentenanalyse über GeminiDer Server newerp-agents-mcp enthält ein durch Gemini gestütztes Werkzeug zur Dokumentenanalyse (erfordert einen Gemini-API-Schlüssel), sodass der Agent auch mit Dokumenteninhalten arbeiten kann.
- Agentenarbeit verknüpft mit CommitsWerkzeuge in newerp-agents-mcp verknüpfen die Arbeit des Agenten mit Aufgaben und Commits in GitLab, sodass Sie direkt an der jeweiligen Aufgabe nachvollziehen können, was der Agent getan hat.
- Mattermost, wenn Sie es brauchenDer Server newerp-agents-mcp lässt sich um 7 optionale Mattermost-Werkzeuge erweitern, mit denen der Agent bei Bedarf direkt mit dem Team-Chat Ihres Unternehmens interagieren kann.
Was der KI-Agent übernimmt
Datenzugriff für Ihre Agenten
Ein externer Agent kann Datensätze jeder Entität (Datensatzart) lesen, durchsuchen und zählen – er sieht dabei ausschließlich das, worauf der Benutzer und sein API-Schlüssel zugreifen dürfen.
Änderungen beginnen als Vorschlag
Über die Capability Bridge schlägt ein Agent Änderungen an Datensätzen standardmäßig nur vor. Sobald der Agent oder eine Person den Vorschlag bestätigt, wird der Vorgang unter den Berechtigungen des Benutzers ausgeführt.
Massenvorschläge vorab feinjustieren
Einzelne Positionen eines Massenvorschlags lassen sich vor der Bestätigung bearbeiten, sodass Sie nicht den gesamten Stapel wegen eines einzigen fehlerhaften Eintrags verwerfen müssen.
Agenten können auch E-Mails versenden
Als eine der Aktionen im Werkzeugkatalog kann ein Agent auch E-Mails senden. Die Aktion läuft unter einem konkreten Benutzer und wird im Audit-Protokoll vermerkt, sodass jederzeit klar ist, wer dahintersteht.
Anhänge und E-Mails über den Server
Über den Server newerp-agents-mcp kann ein Agent mit Anhängen und E-Mails arbeiten. Schreibvorgänge werden im Rahmen der Benutzerberechtigungen sofort ausgeführt; nutzen Sie die Capability Bridge, wenn Sie jede Änderung vorab freigeben möchten.
Agentenarbeit mit der richtigen Aufgabe verknüpft
Der Agent verknüpft seine Arbeit mit Aufgaben und Code-Commits in GitLab, sodass Sie beim Review sofort erkennen, zu welcher Aufgabe seine Änderungen gehören.
Ein Mensch gibt frei, sobald es um Geld, Kunden oder eine Ausnahme geht.
05Häufig gestellte Fragen
Kann ich Claude Code oder einen anderen KI-Agenten mit Draivix verbinden?
Ja. Der Agent verbindet sich über MCP – entweder über die Capability Bridge in Draivix oder über den eigenständigen Server newerp-agents-mcp – und arbeitet mit den Berechtigungen desjenigen Benutzers, dessen Schlüssel oder Token er verwendet.
Kann ein Agent über MCP Berechtigungen umgehen?
Nein. Jeder Aufruf läuft im Kontext eines bestimmten Benutzers, und der effektive Zugriff ist die Schnittmenge aus den Berechtigungen dieses Benutzers und der Obergrenze des API-Schlüssels. Zudem lässt sich der Schlüssel auf ausgewählte Werkzeuge beschränken.
Schreibt der Agent Änderungen sofort in die Datenbank?
Über die Capability Bridge liefern Operationen zum Anlegen, Aktualisieren und Löschen standardmäßig einen Vorschlag zurück, der separat bestätigt werden muss. Der Server newerp-agents-mcp schreibt Änderungen sofort im Rahmen der Berechtigungen des Benutzers.
Kann ich nachvollziehen, was ein Agent im System getan hat?
Ja. Jeder Aufruf über die Capability Bridge wird im Audit-Trail mit der Quelle mcp und einer Trace-ID protokolliert, und delegierte Aufrufe des Hermes-Dienstes werden zusätzlich als sicherheitsrelevant gekennzeichnet.
- KI-Assistent in DraivixEin integrierter Assistent, der Daten findet, Änderungen entwirft und sie erst nach Ihrer Bestätigung speichert
- Automatische REST API und WebhooksMetadatengesteuerte REST API für jede Entität, inklusive OpenAPI-Dokumentation und Webhooks
- GitLab und EntwicklungsaufgabenVerknüpft GitLab-Commits und Merge Requests mit Aufgaben und setzt Aufgaben auf Review
- Team-Chat und Anrufe (Mattermost)Unternehmens-Chat, Projekt- und Kundenkanäle sowie Videoanrufe direkt in Ihrem ERP
- Passwort-TresorVerschlüsselter Team-Passwort-Tresor mit Ordnerfreigabe, Ablaufdaten und Zugriffsprotokollen
- Sprachassistent und Sprache-zu-TextDiktieren Sie Abfragen, transkribieren Sie Aufzeichnungen und steuern Sie Ihr ERP per Sprache über den KI-Assistenten
- WooCommerce-Onlineshop-ImportLädt Katalog, Kunden und Bestellungen aus WooCommerce und überträgt Produktbeschreibungen zurück in den Onlineshop
- EspoCRM-Migration und ParallelbetriebAbgleich und Synchronisierung von Datensätzen mit EspoCRM während der Migration oder im Parallelbetrieb
- OAuth2 und OIDC für Add-onsSichere Anmeldung von Add-ons an Draivix über OAuth2 und OpenID Connect mit PKCE
Starten wir gemeinsam
Erzählen Sie uns, wie Ihr Unternehmen arbeitet.
Wir zeigen Ihnen, wie ein System aussehen kann, das Ihnen einen Teil dieser Arbeit abnimmt.
Beratungstermin vereinbaren