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 das Transportverfahren, das zum Einsatzort passt.
Wähle das richtige Transportverfahren
| 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 | Veraltetes Transportverfahren; für neue Server Streamable HTTP wählen |
Voraussetzungen für Streamable HTTP
Verwende den vollständigen öffentlichen Endpunkt, einschließlich des MCP-Pfads, zum Beispiel:
https://mcp.example.nl/mcp
Der Endpunkt muss:
- HTTPS verwenden;
- ohne Benutzername oder Passwort in der URL funktionieren;
- keinen Redirect benötigen;
- über öffentliches DNS erreichbar sein;
- einen gültigen MCP-
initialize-Handshake beantworten; - eine explizite Menge erlaubter Tools haben.
Lokale Adressen, private Netzwerkadressen und Cloud-Metadaten-Endpunkte werden blockiert. Dadurch kannst du einen Server auf localhost nicht aus der Web-App registrieren.
Einen Server hinzufügen
- Öffne Einstellungen → Tools.
- Wähle Tools hinzufügen oder MCP-Server hinzufügen. Diese Schaltfläche siehst du nur, wenn du MCP-Zugriff hast.
- Sieh dir zuerst die verfügbaren Presets an.
- Wähle Selbst einen MCP-Server hinzufügen.
- Gib Name, vollständigen Endpunkt und Authentifizierungsmethode ein.
- Speichere die Konfiguration und warte auf die Verbindungsprüfung.
- Aktiviere den Server für dein Standard-Toolset.
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 in serverseitigem Speicher abgelegt. Ein Chat erhält nur die registrierte connectorId, niemals die geheime Konfiguration.
Bei einer geänderten URL oder Authentifizierung wird die neue Konfiguration zunächst erneut geprüft. Schlägt diese Prüfung fehl, kann eine zuvor genehmigte Konfiguration aktiv bleiben, bis das Problem behoben ist.
Tool-Berechtigungen
Gib nur die Tools frei, die Benutzer wirklich benötigen. Ein MCP-Server kann Lese- und Schreibaktionen anbieten, etwa Dateien löschen, E-Mails senden oder Datensätze ändern. AI-School filtert die erkannten Tools gegen die serverseitige Allowlist, aber der Serveradministrator bleibt für passende Scopes und Autorisierung verantwortlich.
Lokal testen
Einen lokalen stdio-Server testest du in der Desktop-App. Der Renderer darf keine beliebigen Shell-Befehle starten: Die Installation erfolgt über ein genehmigtes Preset oder den sicheren Desktop-Flow. Befehl, Argumente, Umgebungsvariablen und angeforderter Zugriff werden vor der Installation angezeigt.
Problemlösung
- Endpunkt nicht erreichbar: Prüfe HTTPS, DNS, Firewall und den vollständigen
/mcp-Pfad. - Erneute Verbindung erforderlich: Erneuere die OAuth-Zustimmung oder das gespeicherte Secret.
- Gehört zu einer anderen Umgebung: Registriere den Connector erneut innerhalb der aktuellen Umgebung.
- Keine Tools sichtbar: Prüfe die Tool-Allowlist, deinen MCP-Zugriff und ob der Server aktiv ist.
- Funktioniert nur auf Desktop: Wahrscheinlich verwendet der Server stdio oder eine lokale Adresse.
Entwicklungsressourcen
Siehe auch
Beim Bearbeiten wird die registrierte Serverkonfiguration abgerufen. Der gespeicherte Schlüssel bleibt verborgen: Lasse das Schlüsselfeld leer, um ihn beizubehalten. Bei einer anderen URL oder Authentifizierungsmethode ist eine erneute Verknüpfung erforderlich. Ein Fehler in einem einzelnen MCP-Tool bedeutet nicht, dass alle Tools dieses Servers nicht erreichbar sind.