MCP-Apps hinzufügen

Über MCP-Apps bindest du externe Dienste an die DenkBox an, zum Beispiel GitHub, Notion, eine Datenbank oder ein internes System. Eine MCP-App ist ein MCP-Server (Model Context Protocol), dessen Funktionen die KI im Chat aufrufen darf.

Es gibt zwei Arten von Servern:

• Remote (HTTP): Der Server läuft beim Anbieter. DenkBox spricht ihn über eine URL an. Auf der DenkBox läuft kein fremder Code.
• Lokal (Container): Der Server läuft als abgeschotteter Container direkt auf der DenkBox.

App hinzufügenAnker-Link kopieren

Wähle in der App-Übersicht App hinzufügen und dann eine der drei Möglichkeiten:

• Katalog durchsuchen: geprüfte Einträge aus dem MCP-Katalog – der einfachste Weg
• Manuell hinzufügen: alle Angaben selbst eintragen
• Aus JSON importieren: eine Konfiguration aus der Dokumentation des Servers übernehmen

Aus dem KatalogAnker-Link kopieren

Der Katalog legt den Server bereits fest, du musst keine Verbindungsdaten eintragen. Die Funktionen der App sind sofort bekannt, sodass du die Regeln direkt festlegen kannst – noch bevor sich jemand verbindet. Einträge, die DenkBox noch nicht unterstützt, sind mit Noch nicht unterstützt gekennzeichnet.

Erscheint im Katalog eine neuere Version einer App, zeigt ihre Karte Update verfügbar. Über das Menü … und Aktualisieren spielst du das Update mit einem Klick ein.

Manuell oder per JSONAnker-Link kopieren

Bei Aus JSON importieren fügst du die Konfiguration aus der Dokumentation des Servers ein, etwa einen Block mcpServers, und wählst Übernehmen. Enthält er mehrere Server, wählst du unter Welcher Server? den gewünschten aus. DenkBox füllt damit das Formular vor, das du anschließend prüfst.

Bei Manuell hinzufügen füllst du das Formular selbst aus.

Das FormularAnker-Link kopieren

AllgemeinAnker-Link kopieren

• Name und Beschreibung: erscheinen für Nutzer:innen auf der App-Karte
• Logo: PNG, JPEG, WebP oder SVG, höchstens 200 KB. Ohne eigenes Logo verwendet DenkBox das Logo des Servers, falls er eines mitliefert.
• Info für Nutzer (optional): zum Beispiel eine Anleitung, wie man den nötigen Token erstellt. Erscheint auf der App-Karte und beim Verbinden.
• Website (optional): Projektseite oder Repository, erscheint als Link auf der App

VerbindungAnker-Link kopieren

Wähle die Art des Servers:

• Remote (HTTP): Trage die URL des Servers ein, zum Beispiel https://example.com/mcp.
• Lokal (Container): Trage das Container-Image ein, zum Beispiel ghcr.io/org/mcp-server:1.0, und optional einen Befehl mit einem Argument pro Zeile.

Bei Apps aus dem Katalog entfällt dieser Abschnitt.

AnmeldungAnker-Link kopieren

Unter Art der Anmeldung wählst du, wie sich DenkBox beim Dienst anmeldet. Unter Anmeldung gilt für legst du fest, für wen die Anmeldung gilt:

OAuth gibt es nur bei Remote-Servern. DenkBox registriert sich dabei automatisch beim Anbieter – du musst dort keine eigene Anwendung anlegen.

Bei Passwort legst du unter Zugangsdaten fest, welche Angaben abgefragt werden:

• Name, den Nutzer sehen: die Beschriftung des Eingabefelds, zum Beispiel „GitHub Token“
• Header (Remote) bzw. Variable (Container): wohin der Wert übergeben wird, zum Beispiel der Header Authorization
• Präfix (nur Remote): wird vor den Wert gesetzt, zum Beispiel Bearer

Unter Erweitert findest du:

• Feste HTTP-Header bzw. Feste Umgebungsvariablen: Werte, die für alle gleich sind
• Zusammengesetzte Werte: für Werte, in die Zugangsdaten nur eingesetzt werden, zum Beispiel ein JSON-Block. Zugangsdaten setzt du dort mit {{schlüssel}} ein.

Zugangsdaten werden verschlüsselt gespeichert und nicht wieder angezeigt.

FunktionenAnker-Link kopieren

Hier wählst du die Standardregel für die Funktionen der App: Aus, Bestätigen oder Erlaubt. Sie gilt auch für Funktionen, die der Anbieter später mit einem Update hinzufügt. Nach dem Hinzufügen kannst du jede Funktion einzeln einstellen (siehe Apps).

Firmenweite Anmeldung hinterlegenAnker-Link kopieren

Bei firmenweiten Apps mit Anmeldung hinterlegst du den Zugang nach dem Hinzufügen in den Details der App unter Verbindung:

• Passwort: Trage die Zugangsdaten ein und wähle Speichern. Danach steht dort Firmenweite Zugangsdaten: hinterlegt. Mit Ersetzen tauschst du sie aus, mit Entfernen löschst du sie.
• OAuth: Wähle Anmelden und melde dich beim Anbieter an. Danach steht dort Firmenweite Anmeldung: verbunden. Mit Neu anmelden erneuerst du die Anmeldung.

Bis die Zugangsdaten hinterlegt sind, kann die KI die App nicht nutzen. Bei Apps mit Pro Nutzer verbinden sich die Nutzer:innen selbst unter Apps. Die Funktionen erscheinen dann, sobald sich die erste Person verbunden hat.

Apps bearbeiten und löschenAnker-Link kopieren

Über das Menü … auf der Karte einer App kannst du:

• Bearbeiten: Name, Verbindung, Anmeldung und Standardregel ändern
• Aktualisieren: ein verfügbares Update aus dem Katalog einspielen
• Löschen: die App entfernen – dabei werden alle Verbindungen und Zugangsdaten dieser App gelöscht

Mit dem Schalter auf der Karte deaktivierst du eine App vorübergehend, ohne sie zu löschen.

Lokale Apps (Container)Anker-Link kopieren

Lokale Apps laufen abgeschottet auf der DenkBox:

• Für jede Verbindung startet ein eigener Container. Er wird nach 10 Minuten ohne Nutzung beendet. In den Details der App siehst du, wie viele Instanzen gerade aktiv sind.
• Ein Container kann weder auf die DenkBox selbst noch auf andere Apps zugreifen. Das Internet und Geräte in deinem Netzwerk kann er aber erreichen.
• Das Container-Image wird beim ersten Start heruntergeladen.

Die Ausgaben einer lokalen App findest du unter Logs als Dienst mcp-<app>.

Gut zu wissenAnker-Link kopieren

• Große Apps: Hat eine App mehr als drei Funktionen, lädt die KI deren Funktionen erst, wenn sie die App tatsächlich braucht. Das hält Anfragen schnell.
• Weniger ist mehr: Jede aktive Funktion wird dem Modell bei jeder Anfrage beschrieben. Viele aktive Funktionen können Antworten verlangsamen und die Auswahl der richtigen Funktion erschweren. Aktiviere nur, was gebraucht wird.
• Neue Funktionen: Lade die Funktionsliste nach Änderungen beim Anbieter mit Funktionen aktualisieren neu.

Häufige ProblemeAnker-Link kopieren

• Nicht erreichbar: URL bzw. Image prüfen und sicherstellen, dass der Internetzugang den Server erlaubt. Fahre über den Hinweis, um die Fehlermeldung zu sehen.
• Alle Funktionen aus: Die App ist aktiv, aber keine Funktion freigegeben. Stelle mindestens eine Funktion auf Bestätigen oder Erlaubt.
• Keine Funktionen sichtbar: Bei firmenweiten Apps die Zugangsdaten hinterlegen und Funktionen aktualisieren wählen. Bei Apps mit Pro Nutzer erscheinen die Funktionen, sobald sich die erste Person verbunden hat.
• Die App funktioniert in Automationen nicht: Automationen nutzen nur Funktionen mit Erlaubt.
• Die OAuth-Anmeldung schlägt fehl: Der Anbieter muss die automatische Registrierung von Anwendungen unterstützen. Rufe DenkBox für die Anmeldung unter der Adresse auf, unter der du sie normalerweise nutzt.