MCP#

Um auf diesen Abschnitt zuzugreifen, klicken Sie auf Werkzeug in der linken Navigationsleiste.

Was ist MCP?#

MCP (Model Context Protocol) erweitert QAnswer durch die Verbindung externer Werkzeuge und Dienste. Verbundene Werkzeuge ermöglichen dem KI-Assistenten, Kalender zu prüfen, auf Dateien zuzugreifen, Datenbanken abzufragen und mehr.

Zugriff auf MCP-Werkzeuge im Playground#

• Zum Playground oder KI-Assistenten-Chat navigieren: Öffnen Sie den Playground oder eine KI-Assistenten-Chat-Aufgabe. Ein Chat-Feld wird angezeigt.
• Aktionsmenü öffnen: Klicken Sie auf das Aktions-Symbol im Chat-Feld. Ein Modal öffnet sich mit allen verfügbaren Werkzeugen.

• Werkzeuge aktivieren/deaktivieren:
  • Mehrere Werkzeuge können gleichzeitig aktiviert werden
  • Aktivieren oder deaktivieren Sie die Tools je nach Bedarf einzeln, indem Sie auf den Schalter klicken
• Bestätigungsmodus einstellen (optional)
  • "Nach Bestätigung fragen" beim Aktivieren eines Werkzeugs aktivieren
  • Vor der Ausführung genehmigen:
  • Das aufgerufene Werkzeug
  • Die verwendeten Parameter
  • Parameter vor dem Akzeptieren der Anfrage ändern

MCP-Werkzeuge im Chat verwenden#

MCP mit einem getaggten KI-Assistenten verwenden

Wenn Sie ein MCP-Tool mit einem KI-Assistenten verwenden möchten, aktivieren Sie das Tool auf der Chat-Task-Seite des KI-Assistenten, bevor Sie ihn im Chatbot-Playground taggen.Wie Sie einen KI-Assistenten taggen, erfahren Sie im Abschnitt KI-Assistent des LLM-Chats.

Grundlegende Verwendung

Mit aktivierten Werkzeugen natürlich mit dem KI-Assistenten chatten:

Beispiel:

Sie: "Was sind die heutigen Ereignisse in meinem Kalender?"

Zwei Szenarien:

Szenario 1: Verbindung bereits vorhanden

• Das LLM ruft automatisch das passende Werkzeug auf
• Wenn der Bestätigungsmodus aktiviert ist, die Aktion vor der Ausführung genehmigen
• Die Antwort wird sofort zurückgegeben

Szenario 2: Keine Verbindung

• Eine Verbindung hinzufügen, wenn aufgefordert
• Den Verbindungseinrichtungsprozess abschließen
• Zum Chat zurückkehren
• Das Werkzeug wird automatisch aufgerufen und gibt eine Antwort zurück

Dokumentgenerator#

Sie können den Chatbot bitten, Dokumente wie PDFs, Word-Dateien, Excel-Tabellen oder PowerPoint-Präsentationen mithilfe von über MCP verbundenen Tools zu erstellen. Beispiel: „Erstelle einen Verkaufsbericht für das letzte Quartal im Excel-Format“.

PDFPowerPointExcelWord

Verwendeter Beispiel-Prompt:

Lies den Inhalt der Datei example.pdf in meinem SharePoint, erstelle eine Zusammenfassung und generiere daraus eine PDF-Datei

Auszug aus der LLM-Antwort mit Dokument

Verwendeter Beispiel-Prompt:

Erstelle eine Präsentation zum gleichen Thema

Auszug aus der LLM-Antwort mit Dokument

Verwendeter Beispiel-Prompt:

Erstelle eine Excel-Tabelle aus den Ergebnissen des Papers

Auszug aus der LLM-Antwort mit Dokument

Verwendeter Beispiel-Prompt:

Erstelle eine Word-Datei als Bericht für diese Ergebnisse

Auszug aus der LLM-Antwort mit Dokument

Um das generierte Dokument herunterzuladen, klicken Sie auf den im Chat bereitgestellten Link.

MCP-Server verwalten#

Auf die Werkzeugseite zugreifen

• Zur Werkzeuge-Registerkarte in der Navigationsleiste navigieren
• Eine Liste aller verfügbaren MCP-Server wird angezeigt

Eigenen MCP-Server hinzufügen#

• Klicken Sie auf MCP-Server hinzufügen Schaltfläche
• Die erforderlichen Informationen ausfüllen:
  • Servername
  • Server-URL/Endpunkt
  • Authentifizierungsdetails (falls erforderlich)
  • Weitere Konfigurationsparameter
• Klicken Sie auf Speichern

MCP-Server konfigurieren#

Nach dem Hinzufügen eines Servers:

Eine Verbindung hinzufügen

• Die Verbindungsdaten einrichten
• Erforderliche API-Schlüssel oder Authentifizierungstoken bereitstellen

Die Verbindung testen

• Die integrierte Testfunktion verwenden, um sicherzustellen, dass alles funktioniert
• Auf Verbindungsfehler prüfen

Verfügbare Werkzeuge anzeigen

• Alle Werkzeuge dieses MCP-Servers durchsuchen
• Beschreibungen der einzelnen Werkzeuge lesen

Werkzeuge aktivieren

• Auswählen, welche Werkzeuge in der App verfügbar sein sollen
• Werkzeuge können einzeln aktiviert oder deaktiviert werden

Zum Playground zurückkehren

• Zum Playground oder KI-Assistenten zurückkehren
• Auswählen, welche aktivierten Werkzeuge die KI verwenden soll
• Die Werkzeuge sind jetzt im Chat verfügbar

Authentifizierung & benutzerdefinierte Header#

Beim Hinzufügen oder Bearbeiten eines MCP-Servers steuert der Schritt Authentifizierung, wie sich QAnswer beim Server authentifiziert, und im Schritt Benutzerdefinierte Header können Sie zusätzliche HTTP-Header anhängen — entweder von allen gemeinsam genutzt oder von jedem Benutzer einzeln angegeben.

Authentifizierungsmethoden#

Wählen Sie eine Authentifizierungsmethode aus der Dropdown-Liste Methode:

• Keine — Es wird keine Authentifizierung gesendet. Verwenden Sie dies für offene Server oder wenn die Authentifizierung vollständig über benutzerdefinierte Header erfolgt.
• API-Schlüssel — Authentifizierung mit einem API-Schlüssel, der in einem HTTP-Header gesendet wird. Sie legen fest, wie der Schlüssel dargestellt wird (siehe unten).
• OAuth 2.0 (Erweitert) — Delegiert die Authentifizierung über einen OAuth-2.0-Ablauf für Server, die dies unterstützen.

Benutzerdefinierter API-Schlüssel-Header#

Wenn die Methode API-Schlüssel lautet, können Sie über die Auswahl Header-Name festlegen, wie der Schlüssel gesendet wird. Die ersten drei Optionen sind fertige Voreinstellungen; mit der letzten definieren Sie Ihre eigene:

• Bearer-Token — Sendet den Schlüssel in einem Authorization: Bearer-Header.
• X Api key — Sendet den Schlüssel im Header X-Api-Key.
• X Litellm Api key — Sendet den Schlüssel im Header x-litellm-api-key, für Gateways im LiteLLM-Stil.
• Benutzerdefiniert — Definieren Sie selbst einen beliebigen Header-Namen und ein Wertformat.

Die Auswahl Benutzerdefiniert blendet einen Block Konfiguration des benutzerdefinierten Headers ein, in dem Sie genau beschreiben, wie der Schlüssel gesendet werden soll:

• Header-Name — ein beliebiger HTTP-Header-Name, z. B. X-My-Auth.
• Wertvorlage — optional. Leer lassen, um den rohen Schlüssel zu senden, oder ein Format wie Bearer definieren {api_key} wobei der Platzhalter durch den vom Benutzer angegebenen Schlüssel ersetzt wird.

Endbenutzer-Formular

Sie können auch anpassen, wie das API-Schlüssel-Eingabefeld für Endbenutzer aussieht, wenn sie eine Verbindung erstellen:

• Anzeigename — die über dem Schlüsseleingabefeld angezeigte Beschriftung (Standard ist der Header-Name).
• Platzhalter — der im leeren Feld angezeigte Hinweis, z. B. sk-…
• Beschreibung — Hilfetext unter dem Feld, z. B. wo der Schlüssel zu finden ist.

Benutzerdefinierte Header#

Im Schritt Benutzerdefinierte Header können Sie jeder Anfrage zusätzliche HTTP-Header anhängen. Er hat zwei Registerkarten: Alle Benutzer für gemeinsam genutzte statische Header und Pro Benutzer für Werte, die jeder Benutzer selbst eingibt.

Alle Benutzer (gemeinsame Header)

Statische Name/Wert-Header, die bei jeder MCP-Anfrage für alle Benutzer gesendet werden. Verwenden Sie sie für nicht vertrauliche Routing- oder Versions-Header. Verwenden Sie sie nicht zur Authentifizierung, da derselbe Wert von allen gemeinsam genutzt wird.

Pro Benutzer (benutzerspezifische Header)

Definieren Sie Felder, die jeder Benutzer ausfüllt, wenn er seine eigene Verbindung erstellt. Der Wert jedes Felds wird als HTTP-Header (der Header-Schlüssel ist der Feldname) bei jeder MCP-Anfrage für die Verbindung dieses Benutzers gesendet. Jedes Feld hat:

• Header-Name — der bei Anfragen gesendete HTTP-Header-Schlüssel, z. B. X-Subdomain.
• Anzeigename — die Beschriftung, die der Benutzer im Verbindungsdialog sieht.
• Werttyp — wie der Wert gespeichert und angezeigt wird:
  • Klartext — sichtbarer Wert, unverändert gespeichert.
  • Geheim — maskierter Wert, sicher gespeichert — für Token und andere sensible Daten verwenden.
• Erforderlich — wenn aktiviert, kann ohne Wert keine Verbindung erstellt werden.
• Platzhalter & Beschreibung — optionaler Hinweis und Hilfetext, der dem Benutzer angezeigt wird.

Was Endbenutzer sehen#

Wenn ein Benutzer eine Verbindung zum Server herstellt, wird er aufgefordert, die von Ihnen definierten benutzerspezifischen Felder auszufüllen. Erforderliche Felder müssen ausgefüllt werden, bevor die Verbindung erstellt werden kann, und Geheim-Felder werden während der Eingabe maskiert.

Vorkonfigurierte MCP-Server erkunden#

Verfügbare Server durchsuchen

• Auf der Werkzeugseite auf beliebige Server klicken, um:
  • Detaillierte Beschreibungen lesen
  • Die Liste der angebotenen Werkzeuge anzeigen
  • Ihre Fähigkeiten verstehen
  • Verwendungsbeispiele sehen

Verfügbare Integrationen#

Die folgenden Integrationen sind als MCP-Server verfügbar:

• Atlassian (Jira & Confluence) — verwalten Sie Tickets und Seiten direkt aus QAnswer
• GitLab — interagieren Sie mit Repositories, Issues und Merge Requests
• Google Workspace — Zugriff auf Drive, Calendar, Gmail und mehr

Berechtigungsstufen#

Verfügbare Aktionen nach Rolle:#

Reguläre Benutzer

• Eigene MCP-Server ändern
• Konfigurationen und Einstellungen aktualisieren
• Verbindungen verwalten
• Werkzeuge für den persönlichen Gebrauch aktivieren/deaktivieren
• Persönliche MCP-Server-Verbindungen hinzufügen
• Aktivierte Werkzeuge im Playground und in KI-Assistenten verwenden

Organisations-Admin

• Beliebigen MCP-Server für die Organisation aktivieren oder deaktivieren
• Verwalten, auf welche Werkzeuge das Team zugreifen kann

Admin (Plattform)

• Beliebigen MCP-Server plattformweit aktivieren oder deaktivieren
• Vollzugriff auf alle Serverkonfigurationen

Bestätigungsstandards festlegen#

Sie können ein Standard-Bestätigungsverhalten pro MCP-Tool definieren. Ist ein Standard gesetzt, verwendet das Tool dieses Verhalten immer, ohne manuelle Konfiguration pro Sitzung.

MCP ListManage Default

Best Practices#

1. Mit Bestätigungsmodus beginnen
   • "Nach Bestätigung fragen" beim erstmaligen Testen neuer Werkzeuge aktivieren
   • Parameter vor der Ausführung überprüfen
   • Bestätigungsmodus deaktivieren, sobald das Werkzeug wie erwartet funktioniert
2. Verbindungen testen
   • Verbindungen immer nach dem Hinzufügen eines neuen MCP-Servers testen
   • Sicherstellen, dass Werkzeuge funktionieren, bevor man sich auf sie verlässt
3. Nur das Nötige aktivieren
   • Nicht alle Werkzeuge auf einmal aktivieren
   • Das Aktionsmenü auf relevante Werkzeuge beschränken
   • Weniger aktive Werkzeuge verbessern die KI-Leistung und reduzieren Mehrdeutigkeiten
4. Werkzeugbeschreibungen lesen
   • Verstehen, was jedes Werkzeug tut, bevor man es aktiviert
   • Erforderliche Parameter prüfen
   • Einschränkungen oder Anforderungen beachten

Fehlerbehebung#

Werkzeug funktioniert nicht?

• Überprüfen Sie, ob die Verbindung aktiv ist
• Testen Sie die Verbindung auf der Werkzeugseite
• Prüfen Sie, ob das Werkzeug aktiviert ist
• Stellen Sie sicher, dass Sie die erforderlichen Berechtigungen haben

Werkzeug nicht sichtbar?

• Prüfen Sie, ob der MCP-Server für Ihre Organisation aktiviert ist
• Überprüfen Sie, ob das Werkzeug in den Servereinstellungen aktiviert ist
• Bestätigen Sie, dass Sie es im Aktionsdialog ausgewählt haben

Verbindungsprobleme?

• Verbindung erneut testen
• Anmeldedaten und API-Schlüssel überprüfen
• Serverstatus prüfen
• Ihren Organisations-Admin kontaktieren