MCP-Konnektoren für AI-Agents

In diesem Artikel erfährst du, wie du Konnektoren für AI-Agents einrichtest, um deren Funktionsumfang zu erweitern. Du lernst, wie du vorkonfigurierte Konnektoren aus dem Katalog hinzufügst und wie du eigene MCP-Konnektoren (Model Context Protocol) konfigurierst, um deine Agents mit externen Anwendungen zu verbinden.

---

Hauptvorteile und Anwendungsfälle

Konnektoren geben Agents Zugriff auf Tools und Dienste. Verbindungen bestimmen, welches authentifizierte Konto der Agent dabei verwendet.

• awork stellt vordefinierte Konnektoren bereit.
• Zusätzlich können eigene Konnektoren über das MCP-Protokoll erstellt werden.

Konnektoren vs. Verbindungen

• Ein Konnektor definiert den externen Dienst und den technischen Zugriff darauf
• Eine Verbindung ist ein konkret eingerichtetes und authentifiziertes Konto für diesen Dienst

Wenn mehrere Verbindungen verfügbar sind, wird ein Selektor angezeigt. Damit kannst du auswählen, welche Verbindung der Agent verwenden soll.

---

Konnektoren in der Library verwalten

1. Öffne die Library
   • über die Einstellungen (Zahnradsymbol links unten im Hauptmenü) > Library
   • oder öffne den Bereich AI im Hauptmenü links und klicke auf den Button Library oben rechts
2. Zum Konnektoren-Bereich navigieren
   In der Library siehst du links eine Navigation mit den Bereichen Agents, Skills und Konnektoren. Wähle Konnektoren aus, um zur Übersicht der verfügbaren Verbindungen zu gelangen.

Einen neuen Konnektor einrichten

1. Klicke auf + Konnektor unterhalb des Suchfelds.
2. Konnektor aus dem Katalog auswählen
   Es öffnet sich das Modal Konnektor einrichten mit dem Konnektor-Katalog. Der Katalog zeigt alle verfügbaren Konnektoren in einer Rasteransicht. Im oberen Bereich steht eine Suche zur Verfügung. Einige Konnektoren sind mit Demnächst gekennzeichnet und noch nicht verfügbar. Klicke auf die gewünschte Kachel, um den Konnektor auszuwählen.
3. Konnektor-Details konfigurieren
   Nach der Auswahl erscheint ein Formular mit folgenden Feldern:
   • Konnektor-Name: Der Name für die Verbindung
   • Beschreibung: Eine Erläuterung, was der Konnektor bereitstellt
4. Bei Konnektoren, die OAuth erfordern, werden zusätzliche Felder angezeigt. Konfiguriere die OAuth-App beim Anbieter und füge anschließend die Client-Zugangsdaten hier ein:
   • OAuth-Client-ID: Die Client-ID vom Anbieter
   • OAuth-Client-Secret: Das zugehörige Secret
   • Redirect-URL: Die Callback-URL für die Authentifizierung in der App des Anbieters.
   • Ein Link zur OAuth-Einrichtungsanleitung hilft dir bei der Konfiguration.
5. Konnektor speichern
   Klicke auf Speichern, um den Konnektor zu erstellen. Mit Abbrechen verwirfst du die Änderungen, und Zurück bringt dich zur Katalog-Auswahl.

Die erste Person im Workspace, die einen Konnektor dieses Typs hinzufügt, richtet den ersten Konnektor ein und legt dabei die Zugangsdaten fest. Anschließend können andere Benutzer ihre eigenen Verbindungen dafür einrichten.

Einen eigenen MCP-Konnektor erstellen

Ist ein benötigter Dienst nicht im vorkonfigurierten Katalog enthalten, kannst du einen eigenen Konnektor über das MCP-Protokoll konfigurieren.

1. Scrolle im Konnektor-Katalog nach unten zum Bereich Eigene Konnektoren (MCP). Klicke auf die Kachel Neuen MCP konfigurieren.

1. MCP-Konnektor konfigurieren
   Fülle die folgenden Felder aus:
   • Konnektor-Name: Ein aussagekräftiger Name für die externe Anwendung
   • Beschreibung: Erkläre, was die Anwendung bereitstellt und wann sie verwendet werden soll
   • MCP-Server-URL: Die URL des MCP-Servers (z.B. https://example.com/mcp)
2. Workspace-Verfügbarkeit festlegen
   Aktiviere die Checkbox Diesen Konnektor für den Workspace verfügbar machen, wenn alle Teammitglieder Zugriff auf diesen Konnektor haben sollen.

1. Erweiterte OAuth-Einstellungen (optional)
   Über den Dropdown-Pfeil kannst du bei Bedarf zusätzliche Authentifizierungsoptionen konfigurieren. Konfiguriere die OAuth-App beim Anbieter und füge anschließend die Client-Zugangsdaten hier ein. Hinterlege die aufgeführte Redirect-URL in der App des Anbieters.

So lassen sich auch interne Systeme oder Dienste anbinden, die nicht im vorkonfigurierten awork Konnektor-Katalog enthalten sind.

Von anderen Usern eingerichtete Eigene Konnektoren werden ebenfalls im Konnektor-Katalog angezeigt. Du kannst einen solchen Server verwenden und ihn bei Bedarf mit deiner persönlichen Authentifizierung verbinden.

---

Verbindungen verwalten

Für einen Konnektor können mehrere authentifizierte Konten verfügbar sein.

Verbindungen hinzufügen

1. Öffne beim gewünschten Konnektor das Aktionsmenü und wähle Verbindungen verwalten

1. Klicke im Bereich Verbindungen auf den Button + Hinzufügen

Eine Verbindung kann umbenannt werden. Klicke dazu direkt in die Zeile einer Verbindung ("Konto von User").

Sobald mehrere Verbindungen vorhanden sind, wird ein Selektor angezeigt in der Konnektor-Karte angezeigt. Damit wählst du aus, welche Verbindung der Agent verwenden soll.

Eine Verbindung teilen

Konnektoren können mit anderen Usern geteilt werden, wenn die entsprechenden globalen Berechtigungen vorhanden sind.

Auch authentifizierte Verbindungen können mit Teammitgliedern geteilt werden.

Beim Teilen werden die ursprünglichen Authentifizierungs-Secrets nicht offengelegt. Die Verbindung wird stattdessen gemäß der gewählten Freigabemethode anderen Usern zugänglich gemacht.

1. Öffne beim gewünschten Konnektor das Aktionsmenü und wähle Verbindungen verwalten
2. Klicke im Bereich Verbindungen auf das Aktionsmenü
3. Wähle Verbindung teilen

Im Teilen-Dialog kannst du festlegen, wer auf den Skill zugreifen darf:

• Allgemeiner Zugriff: Lege fest, ob und wie deine Organisation auf die Verbindung zugreifen kann
• Individueller Zugriff: Klicke auf User oder Team hinzufügen, um einzelne User oder Teams hinzuzufügen
• Zugriffsrechte: Wähle zwischen Keine oder Lesen

Die geteilte Verbindung wird anschließend auch in der Library der jeweiligen User angezeigt.

Eine Verbindung löschen

1. Öffne beim gewünschten Konnektor das Aktionsmenü
2. Wähle Verbindung löschen

---

Konnektoren für Agent-Zugriff aktivieren und deaktivieren

Ein aktivierter Konnektor erweitert die Inhalte oder Fähigkeiten, die dem Agent zur Verfügung stehen.

Du kannst einen Konnektor direkt in der Konnektor-Karte in der Library für Agents generell aktivieren. Verwende dazu den Schalter:

• Aktiv: Der Konnektor kann von Agents verwendet werden.
• Deaktiviert: Agents können keine Verbindung zu dem externen Tool via Konnektor herstellen. Du kannst den Konnektor bei Bedarf zusätzlich aktivieren für einen Lauf. Wenn eine benötigte Verbindung nicht vorhanden ist, wird beim entsprechenden Konnektor ein Hinweis angezeigt.

Konnektor direkt zu einem Agent hinzufügen

1. Wechsle in der Library zum Bereich Agents.
2. Klicke bei einem Agent auf Details, um die Agent-Details zu öffnen.
3. Klicke im Bereich Konnektoren innerhalb der Agent-Details auf den Hinzufügen-Button. Es öffnet sich ein Dropdown-Menü mit zwei Optionen:
   • Vorhandenen Konnektor hinzufügen: Wähle einen bereits konfigurierten Konnektor aus. Nutze das Suchfeld oder die Filter Aktiv und Alle, um den gewünschten Konnektor zu finden und hinzuzufügen.
   • Neuen Konnektor erstellen: Lege direkt einen neuen Konnektor an

Der Agent kann den Konnektor jetzt verwenden.

Sobald ein Agent für den AI-Chat ausgewählt ist, siehst du über einen Klick auf + Konnektoren die verfügbaren Konnektoren.

Es wird unterschieden zwischen:

• Aktive Konnektoren: Diese verwendet der Agent aktuell
• Deaktivierte Konnektoren: Diese kannst du bei Bedarf aktivieren

Öffnest du von hier die Library ist die Konfiguration des Agents bereits angewendeten und du siehst die für den Konnektor aktivierten Elemente.

---

Neuen Konnektor vorschlagen

1. Scrolle im geöffneten Modal Konnektor einrichten nach unten.
2. Klicke unterhalb des Konnektor-Katalog auf den Link Konnektor vorschlagen.
3. Gib uns den Name des Tools, welches du gerne nutzen würdest, und optional Website und Link zur MCP Server Dokumentation des Tools.

---

Troubleshooting und Hinweise

• Tippfehler bei der Konnektor-Einrichtung: Wenn bei der ersten Einrichtung eines Konnektors falsche Zugangsdaten verwendet oder Tippfehler gemacht werden, muss der Konnektor gelöscht und neu erstellt werden. Die Zugangsdaten können nicht geändert werden.
• Kein Zugriff auf alle Konnektoren durch Admins: Derzeit können Administratoren noch nicht alle Konnektoren sehen und verwalten. Diese Möglichkeit soll zukünftig noch ergänzt werden.

---

FAQ

Was ist ein Konnektor?

Ein Konnektor stellt die Verbindung zu einem externen Dienst her und definiert den technischen Zugriff darauf.

Was ist eine Verbindung?

Eine Verbindung ist ein konkret eingerichtetes und authentifiziertes Konto für einen Konnektor.

Kann ein Konnektor mehrere Verbindungen haben?

Ja. Für einen Konnektor können mehrere authentifizierte Accounts verfügbar sein. Über den Selektor kannst du auswählen, welche Verbindung der Agent verwenden soll.

Können Verbindungen mit Teammitgliedern geteilt werden?

Ja. Eine authentifizierte Verbindung kann mit anderen Usern geteilt werden. Die geteilte Verbindung wird anschließend auch in deren Library angezeigt.

Werden beim Teilen die Zugangsdaten sichtbar?

Nein. Die ursprünglichen Authentifizierungs-Secrets werden beim Teilen nicht offengelegt.

Kann ich einen Dienst verbinden, den awork nicht als Konnektor anbietet?

Ja. Du kannst einen eigenen Konnektor über das MCP-Protokoll erstellen.

Kann ein Agent eine geteilte Verbindung nutzen?

Ja. Ein Agent kann eine geteilte Verbindung verwenden, ohne dass der jeweilige Benutzer eine eigene Authentifizierung einrichten muss.