Allgemein: amber MCPs / Apps

MCP

In amberAI gibt es bereits viele Tools, mit denen ihr eure internen Dokumente durchsuchen, im Internet recherchieren, Bilder generieren und vieles mehr könnt. Diese Tools interagieren jedoch nicht mit externen Anwendungen wie GitLab, Outlook oder Slack. Hier kommt MCP ins Spiel. MCP-Server bieten zusätzliche Tools, mit denen ihr eine Verbindung zu diesen externen Anwendungen herstellen und Aktionen ausführen könnt, wie zum Beispiel das Erstellen eines Issues in GitLab, das Verfassen einer E-Mail in Outlook oder das Abrufen von Channel-Nachrichten aus Slack. All diese Tools können an amberAI übergeben und in den Konversationen verwendet werden.

MCP-Server

Intern haben wir bereits zwei benutzerdefinierte MCP-Server für Outlook und Slack hinzugefügt. Diese Server werden von amber verwaltet und stehen allen Benutzern zur Verfügung. Mit diesen Servern könnt ihr eure eigenen Outlook- und Slack-Konten mit amberAI verbinden und die von diesen Servern bereitgestellten Tools in euren Konversationen nutzen.

Darüber hinaus unterstützen wir nun das Hinzufügen benutzerdefinierter MCP-Server. Das bedeutet, dass ihr eure eigene Konfiguration nutzen könnt, um eine Verbindung zu jeder gewünschten Anwendung herzustellen, sofern ihr über die erforderlichen Anmeldedaten verfügt und die Anwendung eine API bereitstellt, mit der eine Verbindung hergestellt werden kann. Dies ermöglicht eine hohe Flexibilität und eröffnet viele Möglichkeiten für die Integration verschiedener Anwendungen mit amberAI.

In der aktuellen Version unterstützen wir nur die Verbindung zu Remote-MCP-Servern über eine öffentliche URL. Um eine Verbindung zu einem Remote-MCP-Server herzustellen, könnt ihr je nach den vom gewünschten MCP-Server unterstützten Authentifizierungsmethoden die OAuth-basierte Authentifizierung, Bearer-Token oder eine benutzerdefinierte, auf Headern basierende Authentifizierung verwenden. Wenn der MCP-Server keine Authentifizierung erfordert, könnt ihr einfach eine Verbindung herstellen, indem ihr die öffentliche URL angebt.

MCP-Server hinzufügen (für Administratoren)

Die Option zum Hinzufügen von MCP-Servern findet Ihr unter „Admin Settings -> Connectors -> Apps“.

Die internen MCP-Server für Outlook und Slack sind bereits hinzugefügt und für alle Benutzer verfügbar. Um einen neuen MCP-Server hinzuzufügen, klickt einfach auf die Schaltfläche „Add MCP". Daraufhin öffnet sich ein Formular, in das ihr die Details des MCP-Servers eingeben könnt, den ihr hinzufügen möchtet, wie z. B. den Namen, die Beschreibung, die Server-URL und die Authentifizierungsmethode.

Hier ist ein Beispiel dafür, wie ihr das Formular ausfüllt, um Microsoft Learn MCP-Server hinzuzufügen:

Nachdem ihr das Formular ausgefüllt und die Bedingungen akzeptiert habt, könnt ihr auf die Schaltfläche „Benutzerdefinierten MCP hinzufügen" klicken, um die Konfiguration zu testen und den MCP-Server hinzuzufügen. Wenn ihr kein benutzerdefiniertes Symbol hinzugefügt habt, wird dieses automatisch von der Server-URL abgerufen. Sobald der MCP-Server hinzugefügt wurde, wird er im Abschnitt „Apps" angezeigt und steht den Benutzern zur Verbindung zur Verfügung.

Bei OAuth werdet ihr zum Authentifizierungsablauf des MCP-Servers weitergeleitet, mit dem ihr euch verbinden möchtet. Dieser Schritt ist notwendig, um alle vom MCP-Server bereitgestellten Tools und Funktionen abzurufen und deren Konfigurationen in amberAI zu speichern. Bitte beachtet, dass sich jeder Benutzer nach der Ersteinrichtung weiterhin individuell über seine Profileinstellungen mit dem MCP-Server verbinden muss, um die vom MCP-Server bereitgestellten Tools in seinen Konversationen nutzen zu können.

MCP-Server hinzufügen (für Benutzer mit Developer Role)

Benutzer mit einer Entwicklerrolle können ebenfalls MCP-Server für ihren persönlichen Gebrauch hinzufügen, ohne dass sie Administratorrechte benötigen. Der Vorgang ähnelt dem für Administratoren, jedoch ist der von einem Benutzer hinzugefügte MCP-Server nur für diesen Benutzer verfügbar und für andere Benutzer im System nicht sichtbar.

Um als Benutzer einen MCP-Server hinzuzufügen, geht ihr zu User Settings -> Connectors -> Apps. Dort seht ihr die Option zum Hinzufügen eines MCP-Servers.

Das Konfigurationsformular ist dasselbe wie das für Administratoren, und ihr könnt es mit den Details des MCP-Servers ausfüllen, mit dem ihr euch verbinden möchtet. Nachdem ihr das Formular ausgefüllt und die Bedingungen akzeptiert habt, könnt ihr auf die Schaltfläche „Benutzerdefinierten MCP hinzufügen" klicken, um die Konfiguration zu testen und den MCP-Server hinzuzufügen. Sobald er hinzugefügt wurde, steht er euch in euren Unterhaltungen zur Verfügung.

Konfigurieren von MCP-Servern (für Administratoren)

Als Administrator könnt ihr den von euch hinzugefügten MCP-Server konfigurieren, um bestimmte Tools zu aktivieren oder zu deaktivieren, die Tool-Namen zu ändern und die Tool-Typen (Nur Lesen oder Nur Schreiben) anzupassen. Wenn diese Konfigurationen als Administrator vorgenommen werden, gelten sie für alle Benutzer. Wenn sie als Benutzer vorgenommen werden, gelten sie nur für diesen Benutzer.

Berechtigungen (für Benutzer)

Benutzer können ebenfalls die MCP-Server konfigurieren, mit denen sie verbunden sind. Sobald ihr einen bestimmten MCP-Server in euren Benutzereinstellungen öffnet, seht ihr die Liste der von diesem MCP-Server bereitgestellten Tools. Für jedes Tool könnt ihr die URL permission in Always allow, Always ask oder Always deny ändern, wobei die Standardeinstellung Always ask lautet. Auf diese Weise könnt ihr steuern, welche Tools ihr in euren Unterhaltungen zulassen oder verbieten möchtet. Beispielsweise möchtet ihr vielleicht das Tool „microsoft_docs_search" vom Microsoft Learn MCP-Server zulassen, aber das Tool „microsoft_code_sample_search" ablehnen, um unerwünschte Ergebnisse zu vermeiden. Die Änderungen, die ihr an den Berechtigungen vornehmt, werden sofort übernommen und wirken sich auf eure Konversationen mit amberAI aus. Wenn ihr ein Tool auf „Always allow" setzt, kann amberAI dieses Tool nutzen, ohne jedes Mal eure Erlaubnis einzuholen. Bitte seid vorsichtig, wenn ihr Berechtigungen auf „Always allow" setzt, insbesondere bei Tools, die Schreibvorgänge ausführen können, da dies zu unbeabsichtigten Folgen führen kann, wenn das Tool in einer Konversation ohne eure ausdrückliche Zustimmung verwendet wird.

Verwendung von MCPs in amberAI

Sobald Ihr einen MCP-Server hinzugefügt und eine Verbindung hergestellt habt, wird der Server unter „Apps“ im Optionsbereich der Chat-Eingabe angezeigt. Ihr könnt den MCP-Server aktivieren, um dessen Tools für die Verwendung in der Unterhaltung freizugeben.

Wenn amberAI beschließt, ein Tool von einem MCP-Server in der Unterhaltung zu verwenden, überprüft es die Berechtigungen, die ihr für dieses Tool festgelegt habt. Wenn die Berechtigung auf „Always ask" gesetzt ist, erhaltet ihr in der Unterhaltung eine Benachrichtigung, in der ihr um eure Erlaubnis zur Nutzung dieses Tools gebeten werdet. Ihr könnt dann wählen, ob ihr die Nutzung dieses Tools für diesen konkreten Fall in der Unterhaltung zulassen oder ablehnen möchtet. Wenn ihr dies zulasst, wird amberAI das Tool verwenden und euch die Ergebnisse bereitstellen. Wenn ihr dies ablehnt, wird amberAI das Tool nicht verwenden und sich in der Unterhaltung entsprechend verhalten.