> ## Documentation Index
> Fetch the complete documentation index at: https://docs.varios-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP (Model Context Protocol)

> Der MCP-Konnektor ermöglicht die Integration von MCP-Servern (Model Context Protocol) als LLM-Funktionen. MCP ist ein Standardprotokoll für die Kommunikation zwischen LLMs und externen Services.

<Tip>Startseite > "Admin-Menü" > "Konnektoren" > "MCP"-Tab</Tip>

## Ü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>
  **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.
</Info>

***

## 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`.

{" "}

<Note>
  **Hinweis:** Der Server muss das MCP-Protokoll Version 2025-03-26 oder höher
  unterstützen.
</Note>

### 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>
    **Info:** Wenn Authorization URL und Token URL nicht angegeben werden, wird
    versucht, diese automatisch vom Server abgerufen (Authorization Server
    Discovery).
  </Info>

  <Info>
    **Info:** Wenn keine Client ID vorhanden ist und der Server Dynamic Client
    Registration unterstützt, wird automatisch versucht, einen Client zu
    registrieren.
  </Info>

### 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>
  **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.
</Info>

### 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