Einen eigenen MCP-Server hinzufügen
Mit einem eigenen MCP-Server verbinden Sie AI-Corporate mit einer internen Anwendung, Datenquelle oder spezialisierten Dienstleistung. 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.example.com/mcp
Der Endpunkt muss HTTPS verwenden, ohne Weiterleitung über öffentliches DNS erreichbar sein und eine gültige MCP-initialize-Handshake-Antwort liefern. 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 organisationsgeeigneten Presets an.
- Wählen Sie Selbst einen 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 Ihren Standard-Toolsatz.
Ein Administrator kann über Verwaltung → Tools → MCP einen Server für die gesamte Umgebung registrieren.
Authentifizierung und Secrets
AI-Corporate 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 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 Governance
Geben Sie nur Tools frei, die Mitarbeitende tatsächlich benötigen. Ein MCP-Server kann Lese- und Schreibaktionen anbieten. AI-Corporate filtert erkannte Tools gegen eine serverseitige Allowlist und prüft bei jeder Nutzung Tenant, Eigentümer und Rolle. Die Organisation bleibt verantwortlich für passende Scopes, Logging, Aufbewahrungsfristen und Autorisierung im Quellsystem.
Lokale Desktop-Server
Einen lokalen stdio-Server installieren Sie in der Desktop-App. Der Renderer darf keine beliebigen Shell-Befehle starten: Befehl, Argumente, Umgebungsvariablen 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, Rollen-Zugriff und aktiven Status.
- Funktioniert nur auf dem Desktop: Wahrscheinlich verwendet der Server stdio oder eine lokale Adresse.
Entwicklerressourcen
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.