Zum Hauptinhalt springen

Eigene MCP-Server

Ein MCP-Server ist ein kleiner Dienst, der einem KI-Assistenten Werkzeuge anbietet: „Bestand eines Artikels nachsehen", „Ticket anlegen", „Vertrag suchen". Viele Fachsysteme bringen einen solchen Server mit; ein eigener lässt sich mit wenig Aufwand bauen. Unter Integrationen, Rubrik Eigene MCP-Server, hängt eine verwaltende Rolle einen solchen Server ein. Seine Werkzeuge stehen danach im Chat und im Agenten-Baukasten zur Verfügung, ohne dass an SOFI etwas gebaut werden muss.

Einhängen​

  1. Name und Beschreibung. So erscheint der Server unter Integrationen.
  2. Adresse. Die Adresse des MCP-Servers; er muss aus dem Netz erreichbar sein, in dem SOFI läuft.
  3. Zugang. Ohne Anmeldung, mit Bearer-Token, mit einem eigenen Kopf (Name des Kopfes, etwa X-Api-Key, dazu der Schlüssel) oder mit OAuth. Der Schlüssel wird verschlüsselt gespeichert und danach nicht mehr angezeigt; zum Ersetzen geben Sie einen neuen ein. Zu OAuth siehe den nächsten Abschnitt.
  4. Stichworte. Wörter, an denen SOFI erkennt, dass eine Frage zu diesem Server gehört, etwa „Lager, Bestand, Artikel". Sie helfen der Werkzeug-Automatik bei der Wahl.
  5. Verbindung prüfen. Vor dem Speichern prüft SOFI, ob der Server antwortet und welche Werkzeuge er anbietet. Die Werkzeugliste lässt sich später jederzeit neu einlesen, etwa wenn der Server ein Werkzeug dazubekommen hat.

Anmeldung je Person mit OAuth​

Mit der Zugangsart OAuth meldet sich jede Person selbst beim Server an, mit ihrem eigenen Konto. SOFI legt kein gemeinsames Konto an und speichert die Anmeldungen verschlüsselt je Person.

  • Anmeldeserver. Leer lassen, wenn er unter der Adresse des MCP-Servers liegt.
  • Client-ID. Leer lassen, wenn der Anmeldeserver eine automatische Registrierung anbietet. Tragen Sie eine Client-ID ein, zeigt SOFI die Rückkehradresse, die Sie beim Anmeldeserver für diese Client-ID hinterlegen; ein Client-Secret ist dann optional.
  • Berechtigungen. Optional, mit Leerzeichen getrennt, so wie der Anmeldeserver sie nennt.

Nach dem Speichern steht an der Zeile des Servers unter Integrationen für jede Person Anmelden. Bis zur Anmeldung stehen die Werkzeuge des Servers dieser Person nicht zur Verfügung. Läuft eine Anmeldung ab, steht dort Erneut anmelden. Mit Abmelden löscht SOFI die Anmeldung und widerruft sie beim Anmeldeserver, soweit er das anbietet. Dasselbe geschieht, wenn der Server entfernt oder eine Person aus der Organisation genommen wird.

Im Chat und in Agenten​

Seine Werkzeuge stehen im Chat von selbst bereit; im Werkzeuge-Menü hat der Server keinen eigenen Schalter. Im Agenten-Baukasten lässt sich die Verbindung je Agent abschalten. Was ein Werkzeug liefert, trägt in der Antwort einen Beleg; ein Werkzeug, das etwas verändert, hält zur Freigabe an.

Verantwortung​

Ein eigener Server ist Ihr System. Was er liefert, prüft SOFI nicht auf Richtigkeit; was er darf, bestimmen Sie beim Server. Verarbeitet er Daten Ihrer Auftraggeber, gelten Ihre eigenen Vereinbarungen mit dessen Betreiber. Die Angaben, die SOFI einem Werkzeug übergibt, etwa eine Artikelnummer oder einen Suchbegriff, gehen an Ihren Server.