Einen eigenen MCP-Server hinzufügen
Mit einem eigenen MCP-Server verbinden Sie AI-Public mit einem Fachverfahren, Archiv, einer Datenquelle oder einem anderen spezialisierten Dienst. Wählen Sie zuerst, welches Transportprotokoll zum Einsatzort passt.
Das richtige Transportprotokoll wählen
| 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, einschließlich des MCP-Pfads, zum Beispiel:
https://mcp.organisatie.nl/mcp
Der Endpunkt muss HTTPS verwenden, ohne Redirect über öffentliche DNS erreichbar sein und einen gültigen MCP-initialize-Handshake beantworten. Benutzernamen und Passwörter gehören nicht in die URL. Lokale Adressen, private Netzwerkadressen und Cloud-Metadaten-Endpunkte werden blockiert.
Einen Server hinzufügen
- Öffnen Sie Einstellungen → Tools.
- Wählen Sie Tools hinzufügen oder MCP-Server hinzufügen. Diese Schaltfläche sehen Sie nur, wenn Sie MCP-Zugriff haben.
- 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.
- Aktivieren Sie den Server für Ihre Standard-Toolset.
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 in einer serverseitigen Speicherung abgelegt. Ein Chat erhält nur die registrierte connectorId, niemals die geheime Konfiguration.
Bei einer geänderten 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.
Tool-Berechtigungen und Informationssicherheit
Geben Sie nur die Tools frei, die Benutzer tatsächlich benötigen. Ein MCP-Server kann sowohl Lese- als auch Schreibaktionen anbieten. AI-Public filtert erkannte Tools gegen eine serverseitige Allowlist und prüft bei jeder Verwendung Umgebung, Eigentümer und Rolle. 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, Umgebungs-Keys und angeforderter Zugriff werden begrenzt und vor der Genehmigung 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-Zustimmung oder das gespeicherte Secret.
- Gehört zu einer anderen Umgebung: Registrieren Sie den Connector erneut innerhalb der aktuellen Umgebung.
- Keine Tools sichtbar: Prüfen Sie Allowlist, Rollenzugriff und aktiven Status.
- 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: Lassen Sie 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.