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