Konnektoren (MCP-Server)¶

Mit einem Konnektor bringen Sie die Aktionen eines externen Dienstes in Ihre Organisation: ein Ticketsystem, eine Wissensdatenbank oder eine andere Anwendung, die einen MCP-Server anbietet. MCP (Model Context Protocol) ist ein Standard, mit dem ein Programm Aktionen anbietet, die ein KI-Modell aufrufen kann. Diese Seite zeigt, wie Sie einen Konnektor hinzufügen, seine Adresse erlauben, wählen, welche Aktionen die KI verwenden darf, und daraus Tools machen, die Personen und Assistenten nutzen.

Wer Konnektoren verwaltet¶

Konnektoren hinzufügen, ändern und aktualisieren kann, wer die Tools der Organisation einrichten darf: die Administratoren der Organisation (org-admin) und eine eigene Rolle mit write auf toolbox. Einen Konnektor löschen verlangt delete auf toolbox. Die Adresse eines neuen Konnektors erlauben kann nur ein Administrator (unten).

Öffnen Sie Maschinenraum und wählen Sie den Reiter Connectors. Aus der AI Toolbox kommen Sie auch dorthin, mit Konnektoren in der Leiste oben. Sie sehen eine Tabelle mit Name, Server-URL, Authentifizierung und Aktionen jedes Konnektors: Alle · 12, wenn die KI jede Aktion verwenden darf, 8 von 12, wenn Sie einen Teil gewählt haben, oder Noch nicht abgerufen und Nicht erreichbar, solange OS die Aktionen nicht kennt. Bietet ein Konnektor keine Aktionen an, weil eine Adresse nicht erlaubt ist, steht das über der Tabelle und beim Namen des Konnektors (unten). Einen Konnektor, den ein Abonnement installiert hat, können Sie hier nur ansehen.

Einen Konnektor hinzufügen¶

1. Wählen Sie Konnektor hinzufügen.
2. Füllen Sie aus:
   • Name: Kleinbuchstaben, Ziffern, - und _, höchstens 32 Zeichen. Er steht fest, sobald der Konnektor existiert.
   • Titel und Beschreibung: wie der Konnektor in OS heißt.
   • Server-URL: die Adresse des MCP-Servers, zum Beispiel https://mcp.example.com/mcp.
   • Region (optional): wo der Server steht, etwa eu oder nl.

3. Wählen Sie unter Zugangsdaten, bei Anmelden mit, wie sich der Konnektor beim Server anmeldet:

   Auswahl	Wann
   Keine	Der Server verlangt keine Anmeldung.
   Bearer-Token	Der Server gibt Ihnen ein festes Token. Geben Sie das Token ein und, wenn der Server es in einem anderen Header als Authorization erwartet, den Namen dieses Headers.
   OAuth — organisationsweit	Der Konnektor holt selbst ein Token mit einer Client-ID und einem Client-Secret, für die ganze Organisation. Geben Sie den Token-Endpunkt, die Client-ID, das Client-Secret und bei Bedarf die Scopes und Audience (optional) ein.
   OAuth — pro Benutzer	Jede Person meldet sich mit einem eigenen Konto beim Dienst an, und die Aktionen arbeiten mit diesem Konto (unten).

4. Fügen Sie bei Bedarf Header hinzu, die bei jedem Aufruf mitgehen, und Installationswerte: feste Werte für diese Organisation. Ein Installationswert, den Sie als Geheim markieren, wird nie wieder angezeigt. In einem Header steht {$name} für den Installationswert mit diesem Namen.

5. Wählen Sie Konnektor hinzufügen.

Geheimnisse können Sie nur schreiben. Ein Token, ein Client-Secret und ein geheimer Installationswert werden verschlüsselt gespeichert und danach niemandem mehr angezeigt, auch Ihnen nicht. Beim Bearbeiten (Bearbeiten auf der Seite des Konnektors) lassen Sie ein solches Feld leer, um zu behalten, was dort steht (Gespeichert; leer lassen zum Behalten), oder wählen Zugangsdaten ersetzen, um neue einzugeben. Wählen Sie eine andere Anmeldeart, geben Sie auch deren Geheimnis neu ein. Speichern Sie eine Änderung mit Änderungen speichern.

OS lehnt einen Header ab, der die Anmeldung umgehen oder preisgeben würde: Cookie, Proxy-Authorization, Authorization neben einer Anmeldung, oder den Header, den die Anmeldung selbst verwendet. Ein Geheimnis in der Server-URL wird ebenfalls abgelehnt. Die Meldung nennt das Feld, nie den Wert.

Die Adresse erlauben¶

Die KI-Funktionen Ihrer Organisation rufen keine externe Adresse auf, die die Organisation nicht erlaubt hat. Das gilt auch für einen Konnektor: Solange die Adresse des Servers, oder der Token-Endpunkt einer OAuth-Anmeldung, nicht erlaubt ist, bietet der Konnektor keine einzige Aktion an.

Die Seite des Konnektors nennt unter Adressen jede Adresse, die er verwendet, mit Nicht erlaubt oder Von der Umgebung blockiert, wo das zutrifft. Ein Administrator erlaubt eine Adresse im Regeldokument:

1. Wählen Sie Zu den Regeln auf der Seite des Konnektors, oder öffnen Sie Benutzerverwaltung und wählen Sie Regeldokument.
2. Wählen Sie Regel hinzufügen. Geben Sie der Regel unter Name einen Namen, zum Beispiel ticketsystem, lassen Sie Wirkung auf permit: erlaubt und wählen Sie bei Art egress_host.
3. Wählen Sie unter Bedingungen die Zelle Jedes Ding, jede Person. Geben Sie bei Namen die Adresse ein, zum Beispiel mcp.example.com, oder *.example.com für jede Adresse darunter: eine Adresse pro Zeile. Wählen Sie Fertig.
4. Wählen Sie Regeldokument speichern.

Können Sie selbst keine Regeln ändern, fragen Sie einen Administrator: Eine Adresse erlauben entscheidet, wohin die Daten der Organisation gehen.

Die Adresse gilt nach wenigen Sekunden. Wählen Sie danach auf der Seite des Konnektors Konnektor aktualisieren. Von der Umgebung blockiert können Sie nicht selbst lösen: Der Betreiber der Umgebung erlaubt diese Adresse für keine Organisation.

Die Aktionen abrufen¶

Nach dem Hinzufügen und nach jeder Änderung ruft OS die Liste der Aktionen beim Server ab, meist innerhalb einer Minute, und danach jede Stunde erneut. Auf der Seite des Konnektors sehen Sie bei Aktionen, wo das steht:

Wählen Sie Konnektor aktualisieren, um die Liste sofort neu abzurufen. Solange der Abruf fehlschlägt, bietet der Konnektor keine Aktion an.

Wählen, welche Aktionen die KI verwenden darf¶

Ein neuer Konnektor bietet noch nichts an: Sie wählen zuerst. Unter Aktionen verwalten steht jede Aktion, die der Server anbietet, mit ihrer Beschreibung. Wählen Sie oben:

• Auswählen: nur die Aktionen, die Sie einschalten. Eine Aktion, die der Server später hinzufügt, kommt erst dazu, wenn Sie sie einschalten. So bekommt ein Konnektor nicht unbemerkt eine Fähigkeit dazu.
• Alles, auch was später kommt: jede Aktion, auch die, die der Server später hinzufügt.

Wählen Sie Speichern. Eine eingeschaltete Aktion ist verfügbar: Ein Assistent kann sie bekommen, und Sie können ein Tool daraus machen. Eine ausgeschaltete Aktion kann niemand in der Organisation verwenden. Eine eingeschaltete Aktion, die der Server nicht mehr anbietet, bleibt mit Beim letzten Abruf nicht gefunden stehen; schalten Sie sie aus, um sie zu entfernen.

Testversionen der Aktionen¶

Unter den Aktionen steht die Karte Testversionen. Jede Aktion, die der Konnektor anbietet, kann eine Testversion bekommen: eine feste Antwort oder ein anderes Tool, das in den Läufen einer Evaluation und in Proben anstelle der Aktion antwortet. Ein Gespräch nutzt immer die echte Aktion. Wählen Sie je Aktion, was antwortet, und wählen Sie Testversionen speichern; das ist eine neue Version des Konnektors. Ein Konnektor, den ein Abonnement installiert hat, zeigt die Testversionen ausgegraut.

Eine Aktion in die Toolbox stellen¶

Eine verfügbare Aktion ist noch kein Tool in der AI Toolbox. Wählen Sie bei der Aktion Zur Toolbox hinzufügen. Der Bildschirm Neues Tool erstellen öffnet sich mit Voreinstellung bereits gewählt, über diese Aktion:

1. Wählen Sie unter Für wen ist es? Für Personen oder Nur für Assistenten, und wählen Sie Weiter.
2. Der Name ist vorgeschlagen, und die Beschreibung ist die Beschreibung des Servers. Geben Sie einen Titel ein und passen Sie den Rest an, wo Sie möchten.
3. Wählen Sie Tool erstellen.

Danach steht bei der Aktion Tool: Name, mit einem Link zum Tool.

Das Formular, mit dem jemand das Tool ausführt, folgt dem Server: Ändert der Server die Eingabe einer Aktion, ändert sich das Formular mit. Entfernt der Server die Aktion, ist das Tool nicht mehr verfügbar.

Anmeldung pro Benutzer einrichten¶

Bei OAuth — pro Benutzer arbeitet jede Aktion mit dem Konto der Person, die sie verwendet. Registrieren Sie OS dafür zuerst als Anwendung beim Dienst (dem Anbieter), und geben Sie in OS ein:

• den Autorisierungs-Endpunkt und den Token-Endpunkt des Anbieters;
• die Client-ID und, wenn der Anbieter es verlangt, das Client-Secret (optional). Ein öffentlicher Client verwendet kein Geheimnis;
• die Scopes, durch Leerzeichen getrennt, und bei Bedarf die Audience (optional).

Das Formular zeigt die Redirect-URI. Kopieren Sie sie mit Kopieren und registrieren Sie sie beim Anbieter: Dorthin kommt eine Person nach der Anmeldung zurück. Erlauben Sie auch die Adresse des Token-Endpunkts (oben).

Danach verbindet jede Person ein eigenes Konto auf der Seite Meine Verbindungen. Bis jemand das getan hat, bittet ein Tool über eine solche Aktion diese Person, sich zuerst anzumelden. Entfernen Sie jemanden aus der Organisation, vergisst OS dessen Verbindung von selbst.

Eine KI-App, die ein Mitglied mit einer Gruppe der AI Toolbox verbindet, kann eine solche Aktion nicht verwenden: Die App arbeitet mit einem Schlüssel, nicht mit dem Konto der Person (Eine KI-App mit einer Gruppe verbinden).

Versionen und Wiederherstellen¶

Jede Änderung der Adresse, der Header, der Installationswerte oder der gewählten Aktionen ist eine neue Version. Unter Versionen stehen sie, die neueste zuerst, mit der Zeit, der Adresse, den Namen der Header und den Aktionen. Jede Änderung gilt sofort; es gibt keine Entwürfe.

Wählen Sie Wiederherstellen bei einer älteren Version, um ihre Adresse, Header, Installationswerte und Aktionen zur neuesten zu machen. Geheime Installationswerte behalten, was die neueste Version hat: War ein Geheimnis damals anders, geben Sie es erneut ein. Die Anmeldung des Konnektors gehört zum Konnektor selbst, nicht zu einer Version, und bleibt beim Wiederherstellen, wie sie ist.

Einen Konnektor löschen¶

Wählen Sie in der Tabelle Löschen beim Konnektor und bestätigen Sie. OS lehnt ab, solange:

• ein Tool für eine seiner Aktionen steht. Löschen Sie diese Tools zuerst;
• ein Assistent eine seiner Aktionen verwendet. Nehmen Sie die Aktion zuerst aus diesem Assistenten.

Nach dem Löschen kann niemand die Aktionen des Konnektors mehr verwenden.

Über die API¶

Alles auf dieser Seite geht auch über die API von OS, unter /api/v1/organisations/{id}/toolbox/mcp-servers. Eine Adresse erlauben kann ein Administrator auch mit POST /api/v1/organisations/{id}/allowed-hosts und {"host": "mcp.example.com"}; das fügt die Regel dem Regeldokument hinzu (Das Regeldokument).