Einen eigenen MCP-Server hinzufügen
Mit einem eigenen MCP-Server verbindest du AI-School mit einer eigenen Anwendung, Datenquelle oder spezialisierten Dienst. Wähle zuerst den Transport, der zum Einsatzort passt.
Wähle den richtigen Transport
| Transport | Web | Mobil | Desktop | Verwendung |
|---|---|---|---|---|
| Streamable HTTP | Ja | Ja | Ja | Empfohlen für gehostete Server |
| stdio | Nein | Nein | Ja | Lokale Prozesse und Desktop-Integrationen |
| SSE | Nur bestehende Konfigurationen | Nur bestehende Konfigurationen | Ja | Veralteter Transport; für neue Server Streamable HTTP wählen |
Anforderungen für Streamable HTTP
Verwende den vollständigen öffentlichen Endpoint, inklusive des MCP-Pfads, zum Beispiel:
https://mcp.example.nl/mcp
Der Endpoint muss:
- HTTPS verwenden;
- ohne Benutzername oder Passwort in der URL funktionieren;
- keine Weiterleitung benötigen;
- über öffentliche DNS erreichbar sein;
- eine gültige MCP
initialize-Handshake beantworten; - eine explizite Menge erlaubter Tools haben.
Lokale Adressen, private Netzwerkadressen und Cloud-Metadaten-Endpunkte werden blockiert. Daher kannst du einen Server auf localhost nicht aus der Webapp registrieren.
Einen Server hinzufügen
- Öffne Einstellungen → Tools.
- Wähle Tools hinzufügen oder MCP-Server hinzufügen.
- Sieh dir zuerst die verfügbaren Presets an.
- Wähle Eigenen MCP-Server hinzufügen.
- Gib Name, vollständigen Endpoint und Authentifizierungsmethode ein.
- Speichere die Konfiguration und warte auf die Verbindungsprüfung.
- Schalte den Server für dein Standard-Toolset ein.
Ein Administrator kann über Verwaltung → AI-Einstellungen → Tools → MCP auch einen Server für die gesamte Umgebung registrieren.
Authentifizierung und Secrets
AI-School unterstützt Connector-OAuth und statische Secrets. OAuth-Tokens, Refresh Tokens, API-Schlüssel und Passwörter werden nur serverseitig gespeichert. Ein Chat erhält nur die registrierte connectorId, niemals die geheimen Konfigurationsdaten.
Bei geänderter URL oder Authentifizierung wird die neue Konfiguration zuerst erneut geprüft. Wenn diese Prüfung fehlschlägt, kann eine zuvor genehmigte Konfiguration aktiv bleiben, bis das Problem behoben ist.
Toolrechte
Gib nur die Tools frei, die Benutzer tatsächlich benötigen. Ein MCP-Server kann Lese- und Schreibaktionen anbieten, wie Dateien löschen, E-Mails senden oder Datensätze ändern. AI-School filtert die entdeckten Tools anhand der serverseitigen Allowlist, aber der Serveradministrator bleibt verantwortlich für passende Scopes und Autorisierung.
Lokal testen
Einen lokalen stdio-Server testest du in der Desktop-App. Der Renderer darf keine beliebigen Shell-Kommandos starten: Die Installation erfolgt über ein genehmigtes Preset oder den gesicherten Desktop-Flow. Kommando, Argumente, Environment-Keys und angeforderte Zugriffe werden vor der Installation angezeigt.
Probleme beheben
- Endpoint nicht erreichbar: Prüfe HTTPS, DNS, Firewall und den vollständigen
/mcp-Pfad. - Erneute Verbindung erforderlich: Erneuere OAuth-Berechtigung oder das gespeicherte Secret.
- Gehört zu einer anderen Umgebung: Registriere den Connector erneut in der aktuellen Umgebung.
- Keine Tools sichtbar: Prüfe die Tool-Allowlist, deinen MCP-Zugang und ob der Server aktiv ist.
- Funktioniert nur auf Desktop: Wahrscheinlich verwendet der Server stdio oder eine lokale Adresse.
