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:

  • /mcp für HTTP Streaming (empfohlen)
  • /sse fü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)
  • email
  • username
  • aud (Organization-ID)
  • organizationName
  • role
  • teams

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

Nächste Schritte

War diese Seite hilfreich?