Custom MCP Server

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.

Server-Integration

Es gibt zwei Wege, einen Custom MCP Server hinzuzufügen:

Beide Wege führen zum selben Formular mit den Feldern Name, URL, Header, Autorisierung und dem Schalter Signierte Nutzeridentität. Bei der URL genügt der Endpunkt Deines Servers, meist auf /mcp; SSE-Endpunkte (/sse) funktionieren ebenfalls.

Authentifizierungsoptionen

Custom MCP Server unterstützen drei unabhängige Authentifizierungsmechanismen: statische Header, Autorisierung (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 Header. 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).

Autorisierung

Das Feld Autorisierung in der MCP-Server-Konfiguration bietet drei Modi:

• Keine – keine Anmeldung, oder die Header oben tragen bereits die Zugangsdaten.
• OAuth: automatisch registrieren (DCR) – meinGPT registriert sich selbst beim Server; jede Person meldet sich mit dem eigenen Konto an. Funktioniert mit den meisten Servern.
• OAuth: eigener Client – für Server ohne automatische Registrierung. Registriere meinGPT einmal in deren Admin-Konsole (Client-ID, Client-Secret, Authorization-Endpunkt, Token-Endpunkt, Authentifizierung am Token-Endpunkt); jede Person meldet sich danach mit dem eigenen Konto an.

Manueller OAuth-Client einrichten

Wählst Du OAuth: eigener Client, klappen zusätzliche Felder auf. Die Werte dafür stammen aus der Admin-Konsole des Ziel-Systems, in der Du meinGPT einmal als OAuth-Anwendung registrierst.

Die Redirect-URL, die Du dort einträgst, lautet:

https://<deine-meinGPT-Adresse>/oauth/callback

Auf der meinGPT-Cloud ist das https://app.meingpt.com/oauth/callback. Betreibst Du meinGPT unter einer eigenen Domain, nimm diese Adresse mit demselben Pfad. Ohne exakt eingetragene Redirect-URL bricht der Server die Anmeldung ab.

Danach füllst Du in meinGPT diese Felder:

Die Zugangsdaten hängen an genau diesem Connector, nicht an der URL. Zwei Personen können denselben Server mit unterschiedlichen OAuth-Anwendungen anlegen, ohne sich gegenseitig zu überschreiben.

Das Wählen eines OAuth-Modus allein öffnet noch kein Autorisierungsfenster. Wie bei anderen Connectoren (siehe Connectoren aktivieren) startet der OAuth-Ablauf erst, wenn meinGPT den Server tatsächlich verwenden will – also wenn Du im Chat mit dem Assistenten eine Anfrage stellst, für die er das Tool aufruft. Du bekommst dann im Chat eine Aufforderung mit einer Verbinden-Schaltfläche; erst ein Klick darauf öffnet die Autorisierungsseite des MCP-Servers. Alternativ kannst Du die Verbindung ohne Chat manuell auslösen: Öffne Einstellungen → Verbindungen, suche den Connector und klicke dort auf Verbinden. Ein vollständiges Beispiel mit Screenshots findest Du unter Mit n8n MCP verbinden.

Priorität

Wenn Du sowohl einen statischen Authorization-Header konfigurierst als auch die Autorisierung auf einen OAuth-Modus setzt und die Verbindung erfolgreich zustande kommt, ü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).

Das Formular weist Dich direkt darauf hin: Sobald ein Header Authorization heißt (Groß-/Kleinschreibung egal) und die Autorisierung nicht auf Keine steht, erscheint unter der Header-Zeile in Rot „OAuth setzt diesen Header selbst. Dieser Wert wird ignoriert.“ Speichern kannst Du trotzdem — der Hinweis blockiert nichts, denn derselbe Header ist ja legitim, sobald Du zurück auf Keine wechselst. Siehst Du ihn, hast Du die Wahl: Autorisierung auf Keine setzen, um mit dem Header zu authentifizieren, oder den Header löschen und OAuth die Arbeit machen lassen.

Server für Kolleginnen und Kollegen freigeben

Ein eigener MCP-Server gehört zunächst nur Dir: Er taucht unter Einstellungen → Verbindungen in Deinem Konto auf, und niemand sonst sieht ihn. Es gibt keine Freigabe direkt am Server – der Weg führt über einen Assistenten.

Nach dem Verbinden erscheint der Server auch bei Deinen Kolleginnen und Kollegen unter Einstellungen → Verbindungen, dort mit dem Abzeichen Geteilt. Solche Einträge sind schreibgeschützt: URL, Header und Autorisierung lassen sich nicht ändern und der Eintrag nicht löschen – möglich ist nur Trennen, was die eigene Anmeldung widerruft. Konfiguration und Löschen bleiben bei der Person, die den Server angelegt hat.

Bei einem manuellen OAuth-Client gilt das genauso: Die eine hinterlegte Client-ID mit Secret ist die Registrierung von meinGPT beim Ziel-System – sie ist kein Nutzerkonto und gibt keine Daten frei. Wer den Assistenten nutzt, meldet sich damit trotzdem persönlich an.

Beispiel: OpenProject verbinden

OpenProject bietet einen MCP-Server, aber keine automatische Client-Registrierung – ein typischer Fall für den manuellen OAuth-Client. Der MCP-Server ist ein Enterprise-Add-on von OpenProject und muss dort freigeschaltet sein.

Signierte Nutzeridentität (optional)

Das übergreifende Konzept ist hier dokumentiert: JWT Identity Forwarding.

Für eigene MCP-Server kannst Du in der MCP-Konfiguration den Schalter Signierte Nutzeridentität 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

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) – setze die Autorisierung in der Connector-Konfiguration auf Keine, 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.

Nächste Schritte

• Lerne mehr über Assistenten
• Erkunde die Make-Integration
• Entdecke die Datenbank-Integration