Einen eigenen MCP-Server hinzufügen
Mit einem eigenen MCP-Server verbinden Sie AI-Public mit einem Vorgangssystem, Archiv, einer Datenquelle oder einem anderen spezialisierten Dienst. Wählen Sie zuerst das Transportprotokoll, das zum Einsatzort passt.
Wählen Sie das richtige Transportprotokoll
| 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 Transportprotokoll; für neue Server Streamable HTTP wählen |
Anforderungen für Streamable HTTP
Verwenden Sie den vollständigen öffentlichen Endpunkt, inklusive des MCP-Pfads, zum Beispiel:
https://mcp.organisatie.nl/mcp
Der Endpunkt muss HTTPS verwenden, ohne Redirect über öffentliche DNS erreichbar sein und eine gültige MCP-initialize-Handshake beantworten. Benutzernamen und Passwörter gehören nicht in die URL. Lokale Adressen, private Netzweradressen und Cloud-Metadaten-Endpunkte werden blockiert.
Einen Server hinzufügen
- Öffnen Sie Einstellungen → Tools.
- Wählen Sie Tool hinzufügen oder MCP-Server hinzufügen.
- Sehen Sie sich die verfügbaren Presets an.
- Wählen Sie Eigenen MCP-Server hinzufügen.
- Geben Sie Name, vollständigen Endpunkt und Authentifizierungsmethode ein.
- Speichern Sie die Konfiguration und warten Sie auf die Verbindungsprüfung.
- Schalten Sie den Server für Ihr Standard-Toolset ein.
Ein Administrator kann über Verwaltung → Tools → MCP einen Server für die gesamte Umgebung registrieren.
Authentifizierung und Secrets
AI-Public 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 und Informationssicherheit
Geben Sie nur Tools frei, die Benutzer tatsächlich benötigen. Ein MCP-Server kann Lese- und Schreibaktionen anbieten. AI-Public filtert erkannte Tools anhand einer serverseitigen Allowlist und prüft Umgebung, Eigentümer und Rolle bei jeder Nutzung. Die Organisation bleibt verantwortlich für passende Scopes, Protokollierung, Aufbewahrungsfristen und Autorisierung im Quellsystem.
Lokale Desktop-Server
Einen lokalen stdio-Server installieren Sie in der Desktop-App. Befehl, Argumente, Umgebungsvariablen und angeforderte Zugriffe werden begrenzt und vor der Freigabe angezeigt. Secrets werden lokal verschlüsselt.
Fehlerbehebung
- Endpunkt nicht erreichbar: Prüfen Sie HTTPS, DNS, Firewall und den vollständigen
/mcp-Pfad. - Erneute Verbindung erforderlich: Erneuern Sie die OAuth-Berechtigung oder das gespeicherte Secret.
- Gehört zu einer anderen Umgebung: Registrieren Sie den Connector erneut in der aktuellen Umgebung.
- Keine Tools sichtbar: Prüfen Sie Allowlist, Rollenrechte und aktiven Status.
- Funktioniert nur auf dem Desktop: Wahrscheinlich verwendet der Server stdio oder eine lokale Adresse.
