Mit einem Connector kann ONE auf ein Tool außerhalb von Factorial IT zugreifen. Fügen Sie einen Connector hinzu, wenn der Assistent Informationen in einem anderen System nachschlagen oder dort Aktionen ausführen soll, das Ihr Team bereits nutzt.
Funktion
Übersicht
Jeder Connector ist ein Model-Context-Protocol-Server (MCP-Server), den Sie über seine URL registrieren. Sobald er verbunden ist, kann ONE im Chat die Tools nutzen, die dieser Server anbietet. ONE kann zum Beispiel eine Seite in Notion finden oder eine Aufgabe in einem anderen Dienst ausführen.
Typische Gründe für einen Connector:
- Daten in anderen Systemen nachschlagen. Informationen aus einem Tool abrufen, mit dem Ihr Team arbeitet.
- In anderen Systemen handeln. Den Assistenten Aufgaben in einem verbundenen Dienst erledigen lassen.
- Die Möglichkeiten des Assistenten erweitern. Jedes Tool anbinden, das das Model Context Protocol unterstützt.
Sie brauchen keinen Connector, wenn der Assistent nur mit Daten aus Factorial IT oder den Richtlinien Ihres Unternehmens arbeiten soll. Verwenden Sie dafür Einträge in der Wissensdatenbank.
Bevor Sie beginnen
- Um Connectors hinzuzufügen, zu bearbeiten, neu zu authentifizieren oder zu löschen oder ihre Tool-Berechtigungen zu ändern, benötigen Sie die Berechtigung KI-Agenten verwalten. Um sie nur anzusehen, genügt KI-Agenten anzeigen.
- Sie benötigen die URL eines MCP-Servers, der die OAuth-Authentifizierung unterstützt.
Anwendung
- Gehen Sie zu KI-Agenten > Einstellungen und wählen Sie die Registerkarte Connectors.
- Klicken Sie auf Connector hinzufügen. Ein Fenster öffnet sich.
- Füllen Sie die Angaben aus:
-
Name: die Bezeichnung des Connectors, zum Beispiel
Notion. -
Server-URL: der MCP-Endpunkt, zum Beispiel
https://example.com/mcp.
-
Name: die Bezeichnung des Connectors, zum Beispiel
- Öffnen Sie Erweiterte Einstellungen nur, wenn Ihr MCP-Server keine dynamische Client-Registrierung unterstützt. Registrieren Sie in diesem Fall Factorial IT in der OAuth-Konsole des Anbieters und geben Sie die Client-ID und das Client Secret ein. Öffentliche Clients, die PKCE verwenden, können das Secret leer lassen.
- Klicken Sie auf Verbinden. Sie werden zur Anmeldung an den MCP-Server weitergeleitet. Sobald Sie den Zugriff erlauben, kehren Sie zu Factorial IT zurück und der Connector zeigt Verbunden an.
Status eines Connectors
| Status | Bedeutung |
|---|---|
| Ausstehende Authentifizierung | Erstellt, aber die Authentifizierung ist noch nicht abgeschlossen. |
| Verbunden | Authentifiziert und für den Assistenten verfügbar. |
| Fehler | Die Verbindung ist fehlgeschlagen. Authentifizieren Sie sich erneut, um es noch einmal zu versuchen. |
Einen Connector ansehen
Die Registerkarte Connectors zeigt zuerst die integrierten Connectors (Factorial IT und den Connector für das Hilfecenter) und danach alle, die Sie hinzugefügt haben. Integrierte Connectors sind immer Verbunden. Klicken Sie auf einen Connector, um seine Seite zu öffnen.
Auf der Seite eines hinzugefügten Connectors finden Sie:
- Einstellungen: den Namen, die Server-URL und, falls Sie eine eingegeben haben, die Client-ID. Das Client Secret wird nie angezeigt. Mit Verbindung bearbeiten ändern Sie diese Werte. Wenn Sie die Server-URL oder die OAuth-Anmeldedaten ändern, müssen Sie sich erneut authentifizieren.
- Chat-Berechtigungen und Agenten-Berechtigungen: alle Tools, die der MCP-Server anbietet, jeweils mit ihrer Richtlinie. Siehe „Tool-Berechtigungen festlegen“ weiter unten.
Die Liste der Tools wird bei jedem Öffnen der Seite vom MCP-Server abgerufen und entspricht damit immer dem aktuellen Angebot des Servers. Tools werden nur angezeigt, solange der Connector Verbunden ist. Wenn der Server nicht antwortet, sehen Sie statt der Tools eine Warnung; Einstellungen bleibt nutzbar.
Integrierte Connectors haben weder Einstellungen noch ein Menü Aktionen. Sie können sie nicht bearbeiten oder löschen, aber ihre Tool-Berechtigungen ändern.
Einen Connector verwalten
Auf der Seite eines hinzugefügten Connectors können Sie das Menü Aktionen oben rechts verwenden:
- Erneut authentifizieren: Melden Sie sich erneut beim MCP-Server an. Diese Option erscheint nur, wenn der Connector nicht Verbunden ist.
- Löschen: Entfernt den Connector samt gespeicherten Anmeldedaten, sobald Sie bestätigen. Wenn ein Agent den Connector nutzt, können Sie ihn erst löschen, nachdem Sie ihn in diesem Agenten deaktiviert haben.
Tool-Berechtigungen festlegen
Auf der Seite des Connectors legen Sie fest, wie ONE jedes Tool nutzen darf. Wenn der Connector Verbunden ist, stehen seine Tools in zwei Abschnitten:
- Chat-Berechtigungen gelten für Ihre eigenen Gespräche mit ONE.
- Agenten-Berechtigungen gelten, wenn ONE unbeaufsichtigt arbeitet, zum Beispiel bei einem Ticket, dem Sie ONE als Agent hinzugefügt haben. Wenn Sie den Connector für einen benutzerdefinierten Agenten aktivieren, übernimmt dieser Agent eine Kopie dieser Einstellungen und behält sie. Spätere Änderungen hier wirken sich nicht auf diesen Agenten aus.
Beide Abschnitte gruppieren die Tools in Nur-Lese-Tools und Lese-/Schreib-Tools. Ein Tool gilt nur dann als Nur-Lese-Tool, wenn der MCP-Server es mit readOnlyHint kennzeichnet. Alle anderen Tools gelten als Lese-/Schreib-Tools.
Um eine Richtlinie für eine ganze Gruppe festzulegen, verwenden Sie das Menü rechts neben der Gruppe. Die Auswahl gilt auch für Tools, die der Server künftig hinzufügt, und überschreibt alle Einzeleinstellungen in der Gruppe. Um ein einzelnes Tool festzulegen, klappen Sie die Gruppe auf und wählen Sie mit den Symbolen neben dem Tool-Namen eine Richtlinie aus. Wenn die Tools einer Gruppe unterschiedliche Richtlinien haben, zeigt die Gruppe Benutzerdefiniert an.
| Richtlinie | Was passiert |
|---|---|
| Immer erlauben | ONE nutzt das Tool, ohne zu fragen. |
| Genehmigung erforderlich | ONE fragt zuerst. Klicken Sie auf Akzeptieren, um das Tool auszuführen, oder auf Abbrechen, um es zu stoppen. Nur im Chat verfügbar: Während einer Agentenausführung ist niemand da, der antworten könnte. |
| Immer ablehnen | ONE sieht das Tool nicht und kann es nicht nutzen. |
Standardrichtlinien, bis Sie sie ändern:
| Tools | Chat-Berechtigungen | Agenten-Berechtigungen |
|---|---|---|
| Nur-Lese | Immer erlauben | Immer erlauben |
| Lese/Schreib | Genehmigung erforderlich | Immer erlauben |
Agenten können Lese-/Schreib-Tools also sofort nutzen. Um Agenten bei einem Connector auf das Lesen zu beschränken, stellen Sie unter Agenten-Berechtigungen die Lese-/Schreib-Tools auf Immer ablehnen. Jeder benutzerdefinierte Agent, der den Connector bereits nutzt, hat eine eigene Kopie; ändern Sie die Einstellung daher auch in diesem Agenten.
Wie ONE Connectors nutzt
In einem Gespräch hat ONE Zugriff auf die Tools aller verbundenen Connectors und wählt für jede Anfrage das passende aus. Um ONE auf einen bestimmten Connector zu lenken, geben Sie @ im Nachrichtenfeld ein und wählen Sie den Connector aus. ONE prüft vor jeder Tool-Ausführung die Chat-Berechtigungen des Connectors. Standardmäßig fragt ONE nach, bevor es ein Tool nutzt, das Daten schreibt oder ändert.
Tipps und Best Practices
- Prüfen Sie die Standardwerte für Agenten direkt nach dem Verbinden. Agenten können Lese-/Schreib-Tools von Anfang an nutzen. Schränken Sie sie ein, bevor ein Agent den Connector übernimmt.
- Ändern Sie Agenten einzeln. Ein benutzerdefinierter Agent behält seine eigene Kopie der Berechtigungen. Spätere Änderungen am Connector aktualisieren sie nicht.
- Lassen Sie die Genehmigung für Schreibvorgänge im Chat aktiviert. Mit Genehmigung erforderlich sehen Sie noch einmal hin, bevor ONE Daten in einem anderen System ändert.
- Verwenden Sie einen Eintrag in der Wissensdatenbank, wenn Sie nur Anleitungen brauchen. Ein Connector dient dem Zugriff auf ein anderes System, nicht dazu, ONE Ihre Richtlinien beizubringen.
-
Benennen Sie Connectors nach dem Tool. So lassen sie sich mit
@leicht auswählen.
Fehlerbehebung und FAQ
Fehlerbehebung
- Der Connector zeigt Fehler an. Die Verbindung ist fehlgeschlagen. Öffnen Sie seine Seite und verwenden Sie Aktionen > Erneut authentifizieren.
- Der Connector bleibt bei Ausstehende Authentifizierung. Die Authentifizierung wurde nicht abgeschlossen. Authentifizieren Sie sich erneut und schließen Sie die Anmeldung beim MCP-Server ab.
- Auf der Seite des Connectors werden keine Tools angezeigt. Tools erscheinen nur, solange der Connector Verbunden ist und der Server antwortet. Wenn Sie eine Warnung sehen, hat der Server nicht geantwortet.
- Sie können einen Connector nicht löschen. Ein Agent nutzt ihn noch. Deaktivieren Sie ihn zuerst in diesem Agenten.
- Die Verbindung schlägt bei einem Server ohne dynamische Client-Registrierung fehl. Registrieren Sie Factorial IT in der OAuth-Konsole des Anbieters und geben Sie Client-ID und Client Secret unter Erweiterte Einstellungen ein.
- Eine geänderte Berechtigung kommt bei einem Agenten nicht an. Der Agent behält seine eigene Kopie. Ändern Sie die Richtlinie im Agenten selbst.
FAQ
-
Welche Berechtigung brauche ich, um einen Connector hinzuzufügen?
KI-Agenten verwalten. Mit KI-Agenten anzeigen können Sie Connectors nur ansehen.
-
Kann ich die integrierten Connectors bearbeiten oder löschen?
Nein. Sie können nur ihre Tool-Berechtigungen ändern.
-
Wie entscheidet Factorial IT, ob ein Tool ein Nur-Lese-Tool ist?
Nur Tools, die der MCP-Server mitreadOnlyHintkennzeichnet, sind Nur-Lese-Tools. Alle anderen sind Lese-/Schreib-Tools.
-
Warum gibt es Genehmigung erforderlich nicht für Agenten?
Ein Agent arbeitet selbstständig, daher ist niemand da, der das Tool genehmigen könnte.
-
Kann ich das Client Secret nach dem Speichern sehen?
Nein. Es wird nie wieder angezeigt.