Zum Hauptinhalt springen
Startseite > “Admin-Menü” > “Konnektoren” > “MCP”-Tab

Übersicht

Das Model Context Protocol (MCP) ist ein Standardprotokoll für die Kommunikation zwischen LLMs und externen Services. Der MCP-Konnektor ermöglicht es, MCP-Server zu verbinden und deren Tools als LLM-Funktionen zu nutzen.
Info: MCP-Server stellen Tools (Funktionen) bereit, die von LLMs aufgerufen werden können. Diese Tools können Daten abrufen, Aktionen ausführen oder externe Services integrieren.

Funktionen im Überblick

  • MCP-Server-Verbindung: Verbindung zu MCP-Servern über HTTP
  • Automatische Tool-Erkennung: Tools werden automatisch vom Server abgerufen
  • Authentifizierung: Unterstützung für API Key und OAuth 2.0
  • Tool-Synchronisierung: Automatische Synchronisierung von Tools vom Server
  • Test-Interface: Integrierter Tester zum Testen von Tool-Aufrufen
  • OAuth-Flow: Vollständige Unterstützung für OAuth 2.0 Authorization Flow

MCP-Konfiguration erstellen

Beim Erstellen einer neuen MCP-Konfiguration stehen folgende Optionen zur Verfügung:

1. Titel

Frei wählbare Bezeichnung zur Identifikation der Konfiguration, z. B. GitHub MCP Server oder Custom MCP Service.

2. Server-URL

Die vollständige URL des MCP-Servers, z. B. https://mcp.example.com/api.
Hinweis: Der Server muss das MCP-Protokoll Version 2025-03-26 oder höher unterstützen.

3. Transport

Derzeit wird nur HTTP-Transport unterstützt (http).

4. Timeout

Timeout für Verbindungen in Sekunden (Standard: 30 Sekunden).

5. Authentifizierung

Unterstützte Authentifizierungstypen:
  • Keine Authentifizierung (none)
    • Für öffentliche MCP-Server ohne Authentifizierung
  • API Key (api_key)
    • API Key: Der API-Key-Wert
    • Wird im Authorization Header gesendet
  • OAuth 2.0 (oauth)
    • Authorization URL: URL für den OAuth-Authorization-Endpunkt
    • Token URL: URL für den OAuth-Token-Endpunkt
    • Client ID: OAuth Client ID (optional, kann dynamisch registriert werden)
    • Client Secret: OAuth Client Secret (optional)
    • Scopes: Gewünschte OAuth-Scopes
    Info: Wenn Authorization URL und Token URL nicht angegeben werden, wird versucht, diese automatisch vom Server abgerufen (Authorization Server Discovery).
    Info: Wenn keine Client ID vorhanden ist und der Server Dynamic Client Registration unterstützt, wird automatisch versucht, einen Client zu registrieren.

6. OAuth-Flow

Bei Verwendung von OAuth 2.0:
  1. Authorization starten: Klicken Sie auf “OAuth starten”, um den Authorization Flow zu beginnen
  2. Autorisierung: Sie werden zum Authorization Server weitergeleitet
  3. Callback: Nach der Autorisierung werden Sie zurückgeleitet und der Token wird automatisch gespeichert
  4. Token-Refresh: Access Tokens werden automatisch erneuert, wenn ein Refresh Token verfügbar ist

Tools verwalten

Nach dem Verbinden mit einem MCP-Server können die verfügbaren Tools synchronisiert werden.

Tool-Synchronisierung

  1. Verbindung testen: Klicken Sie auf “Verbindung testen”, um die Verbindung zum Server zu prüfen
  2. Tools synchronisieren: Klicken Sie auf “Tools synchronisieren”, um alle verfügbaren Tools vom Server abzurufen
  3. Automatische Aktualisierung: Tools werden automatisch aktualisiert, wenn sich die Server-Konfiguration ändert

Tool-Details

Jedes Tool enthält:
  • Name: Der Funktionsname für das LLM
  • Beschreibung: Beschreibung der Funktion für das LLM
  • Input Schema: JSON Schema für die Tool-Parameter

Tool testen

Über das integrierte Test-Interface können Sie jedes Tool direkt testen:
  1. Wählen Sie ein Tool aus
  2. Füllen Sie die erforderlichen Parameter aus
  3. Klicken Sie auf “Testen”
  4. Die Antwort wird mit dem Ergebnis angezeigt

MCP Tools als Konnektoren bereitstellen

Nachdem Sie eine MCP-Konfiguration erstellt und Tools synchronisiert haben, können Sie diese Tools als Konnektoren in Ihren Assistenten verwenden.

Konnektor erstellen

  1. Assistent bearbeiten: Öffnen Sie die Assistenten-Konfiguration
  2. Konnektor hinzufügen: Fügen Sie einen neuen Konnektor hinzu
  3. MCP Tools auswählen: Wählen Sie die gewünschten MCP Tools aus der Liste aus
    • Sie können Tools aus verschiedenen MCP-Konfigurationen auswählen
    • Jedes Tool wird als separate LLM-Funktion bereitgestellt
  4. Speichern: Speichern Sie die Konnektor-Konfiguration
Info: MCP Tools werden automatisch in LLM-Funktionen konvertiert. Das LLM kann diese Funktionen während der Konversation aufrufen, um Daten abzurufen oder Aktionen auszuführen.

Tool-Auswahl

  • Mehrfachauswahl: Sie können mehrere Tools aus verschiedenen MCP-Servern auswählen
  • Suche: Verwenden Sie die Suchfunktion, um Tools schnell zu finden
  • Filterung: Tools werden nach MCP-Konfiguration gruppiert angezeigt

Funktionsweise

Wenn ein Assistent mit MCP Tools konfiguriert ist:
  1. Die Tools werden dem LLM als verfügbare Funktionen bereitgestellt
  2. Das LLM kann diese Funktionen basierend auf der Benutzeranfrage aufrufen
  3. Die Tool-Aufrufe werden an den entsprechenden MCP-Server weitergeleitet
  4. Die Antworten werden dem LLM zur Verfügung gestellt und in die Konversation integriert