Ein Connector ermöglicht es ONE, auf ein Tool zuzugreifen, das außerhalb von Factorial IT lebt. Füge einen hinzu, wenn du möchtest, dass der Assistent Informationen in einem anderen System, das dein Team bereits nutzt, nachschlägt oder Aktionen durchführt.

Funktion/Feature

Überblick

Jeder Connector ist ein Model Context Protocol (MCP) Server, den du über seine URL registrierst. Wenn er verbunden ist, kann ONE die Tools nutzen, die dieser Server anbietet, während du mit ihm chattest. Zum Beispiel kann er eine Seite in Notion finden oder eine Aufgabe in einem anderen Dienst ausführen.

Typische Gründe, einen hinzuzufügen:

• Daten woanders nachschlagen. Informationen von einem Tool einbringen, auf das dein Team angewiesen ist.
• Woanders handeln. Den Assistenten Aufgaben innerhalb eines verbundenen Dienstes erledigen lassen.
• Erweitern, was der Assistent tun kann. Jedes Tool anschließen, das das Model Context Protocol unterstützt.

Du benötigst keinen Connector, wenn der Assistent nur mit Factorial IT-Daten oder den eigenen Richtlinien deines Unternehmens arbeiten muss. Dafür verwende Wissensdatenbankartikel.

Bevor du beginnst

• Um Connectoren hinzuzufügen, zu bearbeiten, erneut zu authentifizieren oder zu löschen oder um deren Toolberechtigungen zu ändern, benötigst du die Berechtigung AI-Agenten verwalten. Um sie zu sehen, reicht AI-Agenten anzeigen.
• Du benötigst die URL eines MCP-Servers, der OAuth-Authentifizierung unterstützt.

So verwendest du es

1. Gehe zu AI-Agenten > Einstellungen und wähle den Tab Connectoren.
2. Klicke auf Connector hinzufügen. Ein Fenster öffnet sich.
3. Fülle die Details aus:
   • Name: wie der Connector beschriftet ist, zum Beispiel Notion.
   • Server-URL: der MCP-Endpunkt, zum Beispiel https://example.com/mcp.
4. Öffne Erweiterte Einstellungen, nur wenn dein MCP-Server keine dynamische Client-Registrierung unterstützt. In diesem Fall registriere Factorial IT in der OAuth-Konsole des Anbieters und gib die Client-ID und das Client-Geheimnis ein. Öffentliche Clients, die sich auf PKCE verlassen, können das Geheimnis leer lassen.
5. Klicke auf Verbinden. Du wirst zum MCP-Server weitergeleitet, um dich anzumelden. Sobald du den Zugriff gewährst, kehrst du zu Factorial IT zurück und der Connector zeigt Verbunden.

Connector-Status

Connector anzeigen

Der Tab Connectoren zeigt zuerst die integrierten Connectoren (Factorial IT und den Hilfezentrum-Connector), gefolgt von allen, die du hinzugefügt hast. Integrierte Connectoren sind immer Verbunden. Klicke auf einen Connector, um seine Seite zu öffnen.

Auf der Seite eines hinzugefügten Connectors findest du:

• Einstellungen: den Namen, die Server-URL und, falls du einen eingegeben hast, die Client-ID. Das Client-Geheimnis wird niemals angezeigt. Verwende Verbindung bearbeiten, um diese Werte zu ändern. Ändern der Server-URL oder der OAuth-Anmeldeinformationen bedeutet, dass du dich erneut authentifizieren musst.
• Chat-Berechtigungen und Agenten-Berechtigungen: jedes Tool, das der MCP-Server anbietet, jeweils mit seiner Richtlinie. Siehe "Toolberechtigungen festlegen" unten.

Die Toolliste wird bei jedem Öffnen der Seite vom MCP-Server abgerufen, sodass sie immer dem entspricht, was der Server derzeit anbietet. Tools werden nur angezeigt, solange der Connector Verbunden ist. Wenn der Server nicht antwortet, siehst du eine Warnung anstelle der Tools, und Einstellungen bleibt nutzbar.

Integrierte Connectoren haben keine Einstellungen und kein Aktions-Menü. Du kannst sie nicht bearbeiten oder löschen, aber du kannst ihre Toolberechtigungen ändern.

Connector verwalten

Auf der Seite eines hinzugefügten Connectors kannst du das Aktions-Menü in der oberen rechten Ecke verwenden:

• Erneut authentifizieren: melde dich erneut beim MCP-Server an. Diese Option wird nur angezeigt, wenn der Connector nicht Verbunden ist.
• Löschen: entferne den Connector zusammen mit seinen gespeicherten Anmeldeinformationen, sobald du bestätigst. Wenn ein Agent den Connector verwendet, kannst du ihn nicht löschen, bis du ihn in diesem Agenten ausschaltest.

Toolberechtigungen festlegen

Die Connector-Seite steuert, wie ONE jedes Tool verwenden darf. Wenn der Connector Verbunden ist, sind seine Tools in zwei Abschnitten aufgeführt:

• Chat-Berechtigungen betreffen deine eigenen Gespräche mit ONE.
• Agenten-Berechtigungen betreffen ONE, wenn es unbeaufsichtigt arbeitet, beispielsweise bei einem Ticket, bei dem du es als Agent hinzugefügt hast. Wenn du den Connector für einen benutzerdefinierten Agenten aktivierst, übernimmt dieser Agent eine Kopie dieser Einstellungen und behält sie. Änderungen, die hier später vorgenommen werden, erreichen diesen Agenten nicht.

Beide Abschnitte gruppieren Tools in Nur-Lese-Tools und Schreib-Lese-Tools. Ein Tool gilt nur dann als nur-lesend, wenn der MCP-Server es mit der readOnlyHint-Kennzeichnung markiert. Alles andere wird als schreib-lesend behandelt.

Um eine Richtlinie für eine ganze Gruppe festzulegen, verwende das Menü rechts von dieser Gruppe. Die Auswahl gilt auch für Tools, die der Server in Zukunft hinzufügt, und sie überschreibt alle einzelfallbezogenen Einstellungen in der Gruppe. Um ein Tool festzulegen, erweitere die Gruppe und wähle eine Richtlinie mit den Symbolen neben dem Toolnamen aus. Wenn Tools in einer Gruppe gemischte Richtlinien haben, zeigt die Gruppe Benutzerdefiniert.

Standardrichtlinien, bis du sie änderst:

Das bedeutet, Agenten können Schreib-Lese-Tools sofort verwenden. Um Agenten auf das Lesen eines Connectors zu beschränken, setze Schreib-Lese-Tools auf Immer ablehnen unter Agenten-Berechtigungen. Jeder benutzerdefinierte Agent, der den Connector bereits verwendet, hat eine eigene Kopie, also aktualisiere es auch in diesem Agenten.

Wie ONE Connectoren verwendet

Während eines Gesprächs hat ONE Zugriff auf die Tools jedes verbundenen Connectors und wählt das richtige für jede Anfrage aus. Um es auf einen bestimmten Connector zu lenken, tippe @ in das Nachrichtenfeld und wähle den Connector aus. ONE überprüft die Chat-Berechtigungen des Connectors, bevor es ein Tool ausführt. Standardmäßig fragt es dich, bevor es ein Tool verwendet, das Daten schreibt oder ändert.

Fehlerbehebung und FAQ

Fehlerbehebung

• Der Connector zeigt Fehler an. Die Verbindung ist fehlgeschlagen. Öffne seine Seite und verwende Aktionen > Erneut authentifizieren.
• Der Connector bleibt auf ausstehender Authentifizierung. Die Authentifizierung wurde nicht abgeschlossen. Authentifiziere dich erneut und schließe die Anmeldung auf dem MCP-Server ab.
• Keine Tools erscheinen auf der Connector-Seite. Tools werden nur angezeigt, solange der Connector Verbunden ist, und der Server muss antworten. Wenn du eine Warnung siehst, hat der Server nicht geantwortet.
• Du kannst einen Connector nicht löschen. Ein Agent verwendet ihn noch. Schalte ihn zuerst in diesem Agenten aus.
• Die Verbindung schlägt auf einem Server ohne dynamische Client-Registrierung fehl. Registriere Factorial IT in der OAuth-Konsole des Anbieters und gib die Client-ID und das Client-Geheimnis unter Erweiterte Einstellungen ein.
• Eine Berechtigungsänderung hat einen Agenten nicht erreicht. Der Agent behält seine eigene Kopie. Ändere die Richtlinie innerhalb des Agenten.

FAQ

1. Welche Berechtigung benötige ich, um einen Connector hinzuzufügen?
   AI-Agenten verwalten. AI-Agenten anzeigen lässt dich nur Connectoren sehen.
    
2. Kann ich die integrierten Connectoren bearbeiten oder löschen?
   Nein. Du kannst nur ihre Toolberechtigungen ändern.
    
3. Wie entscheidet Factorial IT, ob ein Tool nur-lesend ist?
   Nur Tools, die der MCP-Server mit readOnlyHint kennzeichnet, sind nur-lesend. Jedes andere Tool ist schreib-lesend.
    
4. Warum gibt es keine Genehmigung erforderlich für Agenten?
   Ein Agent läuft eigenständig, daher ist niemand da, um das Tool zu genehmigen.
    
5. Kann ich das Client-Geheimnis nach dem Speichern sehen?
   Nein. Es wird nie wieder angezeigt.