Benutzerdefinierte MCP-Server
Über die Connectors im Katalog von Rephlo hinaus können Sie einen benutzerdefinierten MCP-Server verbinden, den Sie selbst betreiben – oder einen, der von jemandem betrieben wird, dem Sie vertrauen. Dies richtet sich an fortgeschrittene Nutzer, die bereits über einen MCP-Server und ein Token für den Zugriff darauf verfügen.
Benutzerdefinierte Server werden in der Desktop-App unter Settings → Connectors → Add custom connector hinzugefügt. Es gibt dafür keine Web-Oberfläche; alles läuft lokal auf Ihrem Gerät ab.
Bevor Sie beginnen
Sie benötigen:
- Einen MCP-Server, den Sie erreichen können (dessen Befehl oder dessen URL).
- Ein Bearer-Token für diesen Server, sofern eine Authentifizierung erforderlich ist.
Die Authentifizierung erfolgt derzeit ausschließlich über Bearer-Token. Benutzerdefinierte Server authentifizieren sich derzeit mit einem einzigen, vorab geteilten Bearer-Token – Sie fügen ein Token ein, und Rephlo sendet es mit jeder Anfrage. OAuth-basierte benutzerdefinierte Server (bei denen Sie sich über einen Browser anmelden, wie bei Notion) werden noch nicht unterstützt und folgen in einer späteren Version.
Einen benutzerdefinierten Server hinzufügen
- Öffnen Sie Settings → Connectors und klicken Sie auf Add custom connector.
- Geben Sie dem Server einen Namen, damit Sie ihn später wiedererkennen.
- Wählen Sie einen Transport – wie Rephlo mit dem Server kommuniziert:
- Streamable HTTP – Rephlo verbindet sich über das Netzwerk mit einer Server-URL.
- Stdio – Rephlo startet eine lokale ausführbare Datei und kommuniziert direkt mit ihr auf Ihrem Gerät.
- Füllen Sie die transportspezifischen Einstellungen aus (siehe Tabelle unten).
- Fügen Sie das Bearer-Token des Servers ein.
- Speichern Sie. Rephlo verbindet sich, fragt den Server, welche Tools er anbietet, und die Tools des Servers stehen anschließend im Chat zur Verfügung.
Das Panel „Add custom connector" mit Transportauswahl und dem Bearer-Token-Feld.
Transport-Einstellungen
| Transport | Erforderlich | Optional |
|---|---|---|
| Streamable HTTP | Server-URL | Ein Bearer-Token zur Authentifizierung |
| Stdio | Pfad zur ausführbaren Datei, die gestartet werden soll | Argumente |
Rephlos eigener Connector-Katalog verankert manche Server zur zusätzlichen Verifizierung an einen SHA-256-Binärhash, das wird jedoch auf Seiten von Rephlo verwaltet – es ist kein Feld, das Sie beim Hinzufügen Ihres eigenen benutzerdefinierten Connectors selbst festlegen.
Wo Ihre Daten liegen
- Benutzerdefinierte Server und ihre Bearer-Token werden auf Ihrem Gerät gespeichert, verschlüsselt im Ruhezustand. Sie werden nicht an das Backend von Rephlo gesendet.
- Toolaufrufe an benutzerdefinierte Server laufen direkt von Ihrem Desktop zum Server – sie werden nicht über die Cloud von Rephlo geleitet.
- Wie bei allen Connectors liegen Tool-Ergebnisse nur während der Sitzung im Arbeitsspeicher, und das lokale Prüfprotokoll erfasst nur den Toolnamen, die Dauer und den Status – niemals Argumente oder Inhalte.
Fehlerbehebung
Der Server lehnt die Verbindung ab (401 / nicht autorisiert). Das Bearer-Token ist falsch oder wurde erneuert. Entfernen Sie den Server und fügen Sie ihn mit dem korrekten Token erneut hinzu.
Die Verbindung läuft in eine Zeitüberschreitung. Prüfen Sie, ob die Server-URL erreichbar ist und der Server angemessen schnell antwortet – für Toolaufrufe gilt ein festes Zeitlimit. Falls der Server einfach langsam ist, prüfen Sie dessen Leistung oder Verfügbarkeit.
Tools erscheinen nicht, oder Toolaufrufe können nicht verarbeitet werden. Der Server muss gültiges MCP sprechen und seine Tools deklarieren, wenn Rephlo sich verbindet. Stellen Sie sicher, dass der Server wohlgeformte MCP-Tooldefinitionen und -Antworten liefert.