Custom MCP Server
Integration eigener MCP Server für erweiterte Funktionalitäten
Mit Custom MCP Servern kannst Du eigene Funktionalitäten in meinGPT integrieren. Verbinde Deinen Server über eine URL und erweitere die Fähigkeiten Deiner Assistenten.
Für interne bzw. On-Premise-Systeme nutze das übergreifende Muster On-Premise Connections.
Server-Konfiguration
Um einen Custom MCP Server zu integrieren, benötigst Du eine Endpunkt-URL. Es gibt zwei Transportmöglichkeiten:
HTTP Streaming (Empfohlen)
https://ihr-server.com/mcp
Diese Methode nutzt HTTP Streaming für eine effiziente Echtzeit-Kommunikation.
Server-Sent Events (SSE)
https://ihr-server.com/sse
Alternative Methode mit Server-Sent Events für die Kommunikation.
Verfügbare MCP Server
Hier sind einige spezialisierte MCP Server, die Du nutzen kannst:
Remotion Video Server
https://remotion.selectcode.de/mcp
- Video-Generierung und -Bearbeitung
- Template-basierte Videoproduktion
- Dynamische Inhaltsintegration
Browser Automation Server
https://browser.selectcode.de/mcp
- Webseiten-Navigation
- Formular-Automatisierung
- Screenshot- und PDF-Erstellung
Context7 Documentation Server
https://context7.selectcode.de/mcp
- API-Dokumentationssuche
- Code-Beispiele
- Bibliotheken-Integration
Server-Integration
Server hinzufügen
Füge die Server-URL in den Assistenten-Einstellungen hinzu:
Öffne die Assistenten-Konfiguration
Wähle "MCP Server hinzufügen"
Gib die Server-URL ein
Transport wählen
Wähle den passenden Transport-Modus:
/mcpfür HTTP Streaming (empfohlen)/ssefür Server-Sent Events
Verbindung testen
Überprüfe die Server-Verbindung:
Server-Status prüfen
Test-Anfrage senden
Antwort validieren
Authentifizierungsoptionen
Custom MCP Server unterstützen drei unabhängige Authentifizierungsmechanismen: statische Header, OAuth und JWT Identity Forwarding. Du kannst sie kombinieren, beachte aber den Abschnitt „Priorität" weiter unten, wenn mehrere denselben Header betreffen.
Statische Header
Füge in der MCP-Server-Konfiguration einen oder mehrere eigene HTTP-Header hinzu (z. B. Authorization: Bearer <dein-token>) unter Headers. Nutze dies für Server, die durch einen statischen API-Key geschützt sind, oder durch ein statisches Token am Rand (z. B. eine WAF oder ein Reverse Proxy vor deinem MCP-Endpunkt).
OAuth-Authentifizierung
Aktiviere OAuth Authentication, damit meinGPT für diese MCP-URL den OAuth-Flow durchführt (sofern der Server OAuth unterstützt) und das resultierende Access Token als Authorization-Header verwendet.
Achtung
Fehlermeldung „OAuth is disabled for this MCP URL": Der OAuth-Schalter gilt pro Person und pro eigener Connector-Instanz, nicht global für die MCP-URL. Wenn Du diesen Fehler beim eigenen Verbindungsversuch siehst, obwohl OAuth für eine andere Person (z. B. den Ersteller des Connectors) funktioniert, ist der Schalter bei Deiner eigenen Verbindung (noch) nicht aktiviert. Öffne die Connector-Konfiguration unter Einstellungen → Verbindungen, aktiviere dort OAuth Authentication und verbinde erneut. Steht dort keine eigene Konfiguration zur Verfügung, lege den Custom MCP Server mit denselben Verbindungsdaten (URL, ggf. Header) einmal selbst neu an und aktiviere OAuth dabei explizit.
Priorität
Wenn Du sowohl einen statischen Authorization-Header als auch OAuth für denselben Server konfigurierst und OAuth erfolgreich verbunden ist, übernimmt OAuth den Authorization-Header — Dein statischer Wert wird dann nicht gesendet. Beide Optionen schließen sich in der Konfigurationsoberfläche nicht gegenseitig aus; setze daher nicht beide für denselben Server, es sei denn, OAuth soll nach erfolgreicher Verbindung Vorrang haben. JWT Identity Forwarding ist davon nicht betroffen, da es im separaten Header X-meinGPT-JWT gesendet wird (siehe unten).
JWT-Authentifizierung (optional)
Das übergreifende Konzept ist hier dokumentiert: JWT Identity Forwarding.
Für eigene MCP-Server kannst Du in der MCP-Konfiguration den Schalter für JWT aktivieren. Wenn aktiv, sendet meinGPT bei jedem Request zusätzlich:
X-meinGPT-JWT: <signed-jwt-token>Der Token enthält u. a. folgende Claims:
sub(User-ID)emailusernameaud(Organization-ID)organizationNameroleteams
Wenn Du den Token serverseitig verifizieren möchtest, nutze die zentrale Doku: JWT Identity Forwarding oder Security & Authentication Proxy.
Best Practices
- Sicherheit: Verwende HTTPS für alle Server-Verbindungen
- Monitoring: Überwache die Server-Performance und -Verfügbarkeit
- Fehlerbehandlung: Implementiere Fallback-Optionen für Serverausfälle
- Dokumentation: Dokumentiere Server-spezifische Funktionen und Parameter
Fehlerbehebung
Lehnt ein MCP-Server eine Anfrage mit 401/403 oder einem authentifizierungsbezogenen Fehler ab, prüfe zuerst, welcher Auth-Mechanismus die Anfrage tatsächlich gesendet hat: Öffne Einstellungen → Verbindungen und schau Dir den Status des Connectors an. Steht er auf „Verbunden", ist OAuth aktiv und hat Vorrang vor einem konfigurierten statischen Authorization-Header (siehe „Priorität" oben) – schalte OAuth Authentication in der Connector-Konfiguration aus, wenn Du stattdessen mit Deinem statischen Header authentifizieren möchtest, und verbinde anschließend erneut.
Schlägt ein Tool-Aufruf fehl, klicke im Chat auf die entsprechende Tool-Aufruf-Kachel, um sie aufzuklappen. Dort siehst Du die gesendete Anfrage (Request) sowie die Antwort bzw. Fehlermeldung Deines MCP-Servers im Klartext - das ist der schnellste Weg, um die Ursache eines fehlgeschlagenen Aufrufs zu identifizieren, ohne eigene Server-Logs durchsuchen zu müssen.