MCP-Server

MCP (Model Context Protocol) ist ein offener Standard, der KI-Modellen erlaubt, externe Tools und Datenquellen während eines Chats aufzurufen. SKH integriert MCP-Server als optionalen Erweiterungs-Layer: Sie registrieren einen Server, autorisieren ausgewählte Mitglieder oder Gruppen, und Tools werden im Chat verfügbar.

Anwendungsfälle

• Jira / Linear – Issues lesen, kommentieren, anlegen.
• GitHub – Pull Requests, Code-Suche, Issues.
• Confluence / Notion – Wikis abfragen.
• Eigene APIs – ERP-Anfragen, interne Microservices.
• Open-Source-MCPs – z. B. für Doku-Lookups oder Datenbank-Abfragen.

Servertypen

SKH unterstützt zwei Servertypen:

STDIO

Der MCP-Server läuft als lokales Command-Line-Programm. SKH startet ihn als Hintergrundprozess und kommuniziert direkt mit ihm. Typisch für Server, die per npx gestartet werden.

Sie geben an:

• Command – Den Befehl, z. B. npx -y @upstash/context7-mcp@latest.
• Argumente – Optionale zusätzliche Parameter.
• Umgebungsvariablen – Z. B. für API-Keys.

HTTP

Der MCP-Server ist über eine URL erreichbar.

Sie geben an:

• URL – Die HTTP(S)-Adresse des Servers.
• Headers – Z. B. einen Authorization-Header.

Server registrieren

1. Einstellungen → MCP Servers → Server hinzufügen.
2. Geben Sie ein:
   • Name – Anzeigename, z. B. „Jira (Acme)".
   • Beschreibung (optional).
   • Servertyp – STDIO oder HTTP.
   • Command/Argumente/Umgebungsvariablen oder URL/Headers.
   • Timeout – in Millisekunden (Default 30 000).
   • Auto-Restart – Bei Fehler automatisch neu starten.
   • Public – Wenn aktiv, ist der Server allen Mitgliedern Ihrer Organisation verfügbar (sofern sie Tool-Berechtigungen haben).
3. Speichern. Der Server steht zunächst auf Inaktiv.

Test

Klicken Sie nach dem Anlegen auf Test. SKH versucht, eine Verbindung zum Server aufzubauen und die Liste der verfügbaren Tools abzufragen. Bei Erfolg wechselt der Status auf Aktiv. Bei Fehler sehen Sie die Fehlermeldung in der Detailansicht des Servers.

Status-Werte

Tools auflisten

In der Server-Detailansicht (Klick auf den Server) öffnet sich ein Tools-Dialog. Dort sehen Sie:

• Alle vom Server bereitgestellten Tools (Name, Beschreibung, erwartete Eingaben).
• Welche Berechtigungen je Tool für welche Mitglieder oder Gruppen vergeben sind.
• Möglichkeit, Berechtigungen direkt zu setzen.

Berechtigungen vergeben

Tools sind standardmässig nicht freigegeben. Sie müssen pro Tool festlegen, wer es nutzen darf:

1. Server-Detailansicht → Tools verwalten.
2. Bei einem Tool Berechtigung hinzufügen.
3. Wählen Sie:
   • Mitglied – Spezifisches Mitglied.
   • Gruppe – Alle Mitglieder dieser Gruppe.
4. Optional: Beschreibung, warum die Berechtigung gewährt wurde.

Vergeben Sie Tools möglichst nur denjenigen, die sie brauchen – insbesondere bei schreibenden Tools (z. B. Issue erstellen).

Aufruf im Chat

Mitglieder mit Tool-Berechtigung und aktiviertem MCP-Modus im Chat können das Modell nun bitten, Tools aufzurufen. Beispiel:

„Erstelle ein Jira-Issue im Projekt PLAT mit Titel 'OAuth-Bug' und einer Zusammenfassung der Diskussion oben."

Das Modell ruft das passende Tool auf, das Ergebnis erscheint als ausklappbare Karte im Chat:

🔧 jira_create_issue
   {project: "PLAT", title: "OAuth-Bug", description: "..."}

   → {issueKey: "PLAT-1234", url: "https://..."}

So sehen Sie genau, was das Modell aufgerufen hat, bevor es mit der Antwort fortfährt.

Bekannte MCP-Server

Eine kurze, nicht abschliessende Liste populärer Open-Source-MCPs:

Weitere Server finden Sie auf github.com/modelcontextprotocol (opens in a new tab).

Sicherheits-Hinweise

• Tools sind aktiv – Anders als reines Lesen können Tools schreibend wirken (Issue erstellen, Datei ändern, E-Mail senden). Berechtigungs-Vergabe ist daher kritisch.
• Geheimnisse in Umgebungsvariablen – Bei einem STDIO-Server mit API-Key sollten Sie diesen nur in den Umgebungsvariablen hinterlegen, nicht im Command-Feld. Die Werte werden verschlüsselt gespeichert.
• HTTP-Server – Nutzen Sie HTTPS. Authorization-Headers werden ebenfalls verschlüsselt gespeichert.
• Bei BYOK-Modellen – Der externe Anbieter sieht die Tool-Aufrufe. Die Datenfluss-Konsequenzen aus KI-Modelle & Datenschutz gelten weiterhin.

Häufige Probleme

• Server bleibt im Status Fehler nach Test – Bei STDIO-Servern: prüfen Sie, ob das Command-Tool auf der SKH-Plattform verfügbar ist. Bei HTTP-Servern: prüfen Sie URL und Authentifizierung.
• Tools tauchen im Chat nicht auf – MCP-Modus aktiv? Berechtigung auf das Tool gesetzt? Server Aktiv?
• Timeout-Fehler – Erhöhen Sie den Timeout-Wert (Default 30 s) bei langsameren Servern.

Nachvollziehbarkeit

Jeder Tool-Aufruf bleibt als ausklappbare Karte in der jeweiligen Chat-Nachricht sichtbar – mit Tool-Name, Argumenten und Antwort. So ist im Nachhinein erkennbar, was das Modell wann gemacht hat.