KSM MCP-Server – Sicherer KI-Zugriff auf Keeper Secrets

KSM MCP ist ein Model Context Protocol (MCP)-Server, der als sichere Schnittstelle zwischen KI-Sprachmodellen (wie Claude) und dem Keeper Secrets Manager (KSM) fungiert. Er ermöglicht es KI-Agenten, Ihre KSM-Geheimnisse zu verwalten – wie das Auflisten, Erstellen, Abrufen und Löschen von Datensätzen und Ordnern – während Ihre KSM-Anwendungsanmeldedaten geschützt bleiben. Sensible Vorgänge erfordern eine Benutzerbestätigung, wodurch Sie die volle Kontrolle über Ihre Daten behalten.

Kurze Benutzeranleitung

Option 1: Verwendung von Docker (Empfohlen)

1. KSM Base64-Konfiguration abrufen:

   • Melden Sie sich im Keeper Secrets Vault an.

   • Navigieren Sie zu Ihrem Secrets Manager, dann zur Anwendung und schließlich zum Tab „Geräte“.

   • Klicken Sie auf „Gerät hinzufügen“ und kopieren Sie die bereitgestellte base64-kodierte Konfigurationszeichenfolge (sie beginnt normalerweise mit ewog...).

   Wichtig: Die base64-Konfiguration enthält die Anmeldedaten Ihrer KSM-Anwendung. Bewahren Sie sie sicher auf und übertragen Sie sie niemals in die Versionskontrolle.

2. Claude Desktop konfigurieren:

   • Öffnen Sie Ihre Claude Desktop-Konfigurationsdatei:

     • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

     • Windows: %APPDATA%\Claude\claude_desktop_config.json

     • Linux: ~/.config/Claude/claude_desktop_config.json

   • Fügen Sie den ksm-Servereintrag wie folgt hinzu oder aktualisieren Sie ihn, wobei Sie YOUR_BASE64_CONFIG_STRING_HERE durch Ihre tatsächliche base64-Konfiguration ersetzen:

   {
     "mcpServers": {
       "ksm": {
         "command": "docker",
         "args": [
           "run", "-i", "--rm",
           "-e", "KSM_CONFIG_BASE64=YOUR_BASE64_CONFIG_STRING_HERE",
           "keeper/keeper-mcp-server:latest"
         ]
       }
       // You might have other servers like "memory" here, leave them as is.
     }
   }

3. Claude Desktop neu starten:

   • Der KSM-Server sollte nun für Claude verfügbar sein. Beim ersten Verbindungsaufbau wird die base64-Konfiguration zum Starten verwendet.

Option 2: Verwendung einer vorkompilierten Binärdatei

1. Binärdatei herunterladen:

   • Gehen Sie zur KSM MCP-Releases-Seite und laden Sie die passende Binärdatei für Ihr Betriebssystem herunter (z. B. ksm-mcp-darwin-amd64 für Intel-Macs, ksm-mcp-windows-amd64.exe für Windows).

   • Machen Sie die Binärdatei ausführbar (z. B. chmod +x ./ksm-mcp-darwin-amd64) und legen Sie sie in einem Verzeichnis ab, das im PATH Ihres Systems enthalten ist, oder notieren Sie sich den vollständigen Pfad.

2. KSM Base64-Konfiguration abrufen: (Siehe Schritt 1 in der Docker-Anleitung oben)

   Wichtig: Die base64-Konfiguration enthält die Anmeldedaten Ihrer KSM-Anwendung. Bewahren Sie sie sicher auf und übertragen Sie sie niemals in die Versionskontrolle.

3. KSM MCP-Profil initialisieren:

   • Öffnen Sie Ihr Terminal und führen Sie den Init-Befehl aus, wobei Sie YOUR_BASE64_CONFIG_STRING ersetzen und einen Profilnamen wählen (z. B. default):

     /path/to/ksm-mcp init --profile default --config "YOUR_BASE64_CONFIG_STRING"

   • Sie werden aufgefordert, ein Schutzpasswort für Ihren lokalen Profilspeicher festzulegen. Merken Sie sich dieses Passwort, da Sie es benötigen, wenn Sie den Server manuell neu starten oder wenn er so konfiguriert ist, dass es erforderlich ist. Für die automatisierte Verwendung mit Claude wird der Server oft im Batch-Modus ausgeführt, bei dem diese Abfrage nicht interaktiv erfolgt.

4. Claude Desktop konfigurieren:

   • Öffnen Sie Ihre claude_desktop_config.json-Datei (siehe Pfade in der Docker-Anleitung).

   • Fügen Sie den ksm-Servereintrag hinzu oder aktualisieren Sie ihn, wobei Sie /path/to/ksm-mcp durch den tatsächlichen Pfad zu Ihrer heruntergeladenen Binärdatei ersetzen: GXP3

5. Claude Desktop neu starten.

Related MCP server: keyshade-mcp

Funktionen (Verfügbare Tools)

Der KSM MCP-Server stellt die folgenden Tools zur Interaktion mit dem Keeper Secrets Manager bereit:

Geheimnis-Vorgänge

• list_secrets: Alle zugänglichen Geheimnisse auflisten (nur Metadaten).

• get_secret: Ein bestimmtes Geheimnis abrufen (sensible Felder sind standardmäßig maskiert; zum Entmaskieren ist eine Bestätigung erforderlich).

• search_secrets: Geheimnisse nach Titel, Notizen oder anderen Feldinhalten durchsuchen.

• create_secret: Ein neues Geheimnis erstellen (erfordert Bestätigung).

• update_secret: Ein bestehendes Geheimnis aktualisieren (erfordert Bestätigung).

• delete_secret: Ein Geheimnis löschen (erfordert Bestätigung).

Ordner-Vorgänge

• list_folders: Alle zugänglichen Ordner auflisten.

• create_folder: Einen neuen Ordner erstellen (erfordert Bestätigung; ein übergeordneter freigegebener Ordner muss angegeben werden).

• delete_folder: Einen Ordner löschen (erfordert Bestätigung; Option zum erzwungenen Löschen nicht leerer Ordner).

Dateiverwaltung (innerhalb von Geheimnissen)

• upload_file: Einen Dateianhang zu einem Geheimnis hochladen (erfordert Bestätigung).

• download_file: Einen Dateianhang von einem Geheimnis herunterladen.

Dienstprogramme

• generate_password: Ein sicheres Passwort generieren. Kann optional direkt in einem neuen Geheimnis gespeichert werden, ohne es der KI preiszugeben.

• get_totp_code: Den aktuellen TOTP-Code für ein Geheimnis abrufen, für das TOTP konfiguriert ist.

• get_server_version: Die aktuelle Version des KSM MCP-Servers abrufen.

• health_check: Den Betriebsstatus des MCP-Servers und seine Verbindung zu KSM überprüfen.

Anwendungsbeispiele

Hier sind einige Beispiele, wie Sie einen KI-Agenten (wie Claude) anweisen könnten, den KSM MCP-Server zu verwenden:

• Ein neues Geheimnis in einem neuen Ordner erstellen: „Bitte erstelle einen neuen Ordner namens 'Project Phoenix Shared' unter unserem Hauptordner 'KSM-MCP-TEST-RECORDS'. Erstelle dann innerhalb von 'Project Phoenix Shared' ein neues Anmeldegeheimnis mit dem Titel 'Phoenix Dev DB', dem Benutzernamen 'phoenix_user', dem Passwort 'ComplexP@$$wOrd123!' und der URL 'db.phoenix.dev.internal'.“

• Geheimnisse auflisten und eines abrufen: „Liste alle Geheimnisse im Ordner 'API Keys' auf. Rufe dann die Details für das Geheimnis mit dem Titel 'Third-Party Analytics API Key' ab, aber halte den API-Schlüssel selbst maskiert.“

• Ein Geheimnis und dann seinen Ordner löschen (falls leer): „Lösche das Geheimnis mit dem Namen 'Old Staging Server Credentials'. Sobald das erledigt ist, lösche bitte auch den Ordner 'Staging Environment', falls er jetzt leer ist.“

• Eine Konfigurationsdatei in einen bestehenden Datensatz hochladen: „Ich habe eine neue Kubernetes-Konfigurationsdatei für unseren Produktionscluster unter '~/Downloads/kubeconfig-prod.yaml'. Bitte lade diese Datei in den KSM-Datensatz mit dem Titel 'Production K8s Cluster Access' hoch und nenne den Anhang 'kubeconfig-prod-cluster.yaml'.“

• Ein sicheres Passwort generieren und in einem neuen Datensatz speichern: „Generiere ein sehr starkes 32-stelliges Passwort mit Groß- und Kleinbuchstaben, Zahlen und Sonderzeichen. Speichere es direkt in einem neuen Anmeldedatensatz mit dem Titel 'Internal Audit Service Account' im Ordner 'Service Accounts'. Zeige mir das Passwort nicht an.“

• Konfigurationskonsistenz über Umgebungen hinweg prüfen: „Ich habe Dienstkonfigurationsdatensätze, die in Ordnern nach Umgebung (dev, qa) mit Unterordnern für jede AWS-Region organisiert sind. Bitte analysiere diese Datensätze und identifiziere Inkonsistenzen zwischen ähnlichen Diensten in verschiedenen Umgebungen. Achte besonders auf Konfigurationswerte, die normalerweise in allen Umgebungen gleich sein sollten, wie Protokollierungsebenen, Timeout-Einstellungen oder Feature-Flags.“

Referenz zur Serverkonfiguration

Der KSM MCP-Server kann auf verschiedene Arten mit unterschiedlichen Konfigurationsoptionen instanziiert werden. Dieser Abschnitt dokumentiert alle verfügbaren Methoden, Flags und Umgebungsvariablen.

Konfigurationsmethoden

Methode 1: Docker mit Umgebungsvariablen (Empfohlen)

{
  "mcpServers": {
    "ksm": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "KSM_CONFIG_BASE64=YOUR_BASE64_CONFIG_STRING",
        "keeper-mcp-server:latest"
      ]
    }
  }
}

Methode 2: Vorkompilierte Binärdatei mit Profil

{
  "mcpServers": {
    "ksm": {
      "command": "/path/to/ksm-mcp",
      "args": ["serve", "--profile", "default"]
    }
  }
}

Methode 3: Vorkompilierte Binärdatei mit Base64-Konfiguration (CLI-Flag)

{
  "mcpServers": {
    "ksm": {
      "command": "/path/to/ksm-mcp",
      "args": [
        "serve",
        "--config-base64", "YOUR_BASE64_CONFIG_STRING"
      ]
    }
  }
}

Methode 4: Vorkompilierte Binärdatei mit Umgebungsvariablen

{
  "mcpServers": {
    "ksm": {
      "command": "/path/to/ksm-mcp",
      "args": ["serve"],
      "env": {
        "KSM_CONFIG_BASE64": "YOUR_BASE64_CONFIG_STRING"
      }
    }
  }
}

Methode 5: Stiller Modus (Keine lokalen Protokolle)

Für Umgebungen, in denen Sie die Erstellung lokaler Dateien (einschließlich Audit-Protokollen) verhindern möchten:

{
  "mcpServers": {
    "ksm": {
      "command": "/path/to/ksm-mcp",
      "args": [
        "serve",
        "--no-logs",
        "--config-base64", "YOUR_BASE64_CONFIG_STRING"
      ]
    }
  }
}

Das Flag --no-logs deaktiviert die Audit-Protokollierung vollständig und stellt sicher, dass keine lokalen Dateien erstellt werden. Dies ist nützlich für:

• Compliance-Umgebungen, in denen die Erstellung lokaler Dateien vermieden werden muss

• Containerisierte Bereitstellungen, bei denen keine Persistenz gewünscht ist

• Temporäre oder Testszenarien

• Systeme mit schreibgeschützten Dateisystemen

Befehlszeilen-Flags

Flag-Details

--batch (Nicht-interaktiver Modus)

• Zweck: Verhindert, dass der Server nach Passwörtern oder Benutzereingaben fragt

• Wann zu verwenden:

  • Automatisierte Umgebungen (CI/CD, Docker-Container)

  • Bei Ausführung als Dienst, bei dem keine menschliche Interaktion möglich ist

  • Claude Desktop-Integration (empfohlen)

• Was es bewirkt:

  • Überspringt Passwortabfragen beim Laden verschlüsselter Profile

  • Verwendet Umgebungsvariablen oder CLI-Flags für die gesamte Konfiguration

  • Schlägt bei fehlender erforderlicher Eingabe ordnungsgemäß fehl, anstatt hängen zu bleiben

--no-logs (Stiller Modus)

• Zweck: Deaktiviert die Audit-Protokollierung vollständig, um die Erstellung lokaler Dateien zu verhindern

• Wann zu verwenden:

  • Compliance-Umgebungen, in denen lokale Artefakte vermieden werden müssen

  • Containerisierte oder kurzlebige Bereitstellungen

  • Umgebungen mit schreibgeschütztem Dateisystem

  • Testszenarien, bei denen eine Bereinigung wichtig ist

• Was es bewirkt:

  • Verhindert die Erstellung des Verzeichnisses ~/.keeper/ksm-mcp/logs/

  • Deaktiviert die gesamte Audit-Protokollierung (Zugriffsprotokolle, Fehlerprotokolle, Systemprotokolle)

  • Behält die volle MCP-Funktionalität ohne Protokollierungs-Overhead bei

  • Sicherer Betrieb mit Nil-Check-Wrappern für alle Protokollierungsaufrufe

• Sicherheit: Hoch – keine sensiblen Daten werden in lokale Dateien geschrieben

--auto-approve (Gefährlich)

• Zweck: Umgeht Benutzerbestätigungsabfragen für destruktive Vorgänge

• ⚠️ Sicherheitshinweis: Dies ist gefährlich und sollte nur in kontrollierten Umgebungen verwendet werden

• Welche Vorgänge erfordern normalerweise eine Bestätigung:

  • create_secret - Erstellen neuer Geheimnisse

  • update_secret - Ändern bestehender Geheimnisse

  • delete_secret - Löschen von Geheimnissen

  • create_folder - Erstellen neuer Ordner

  • delete_folder - Löschen von Ordnern

  • upload_file - Hochladen von Dateien in Geheimnisse

  • Entmaskieren sensibler Daten (Passwörter, API-Schlüssel usw.)

• Wann Sie es verwenden könnten:

  • Automatisierte Testumgebungen

  • Vertrauenswürdige KI-Agenten in kontrollierten Szenarien

  • Massenvorgänge, bei denen eine manuelle Bestätigung nicht praktikabel ist

• Empfohlene Alternative: Verwenden Sie das Tool ksm_execute_confirmed_action für eine selektive Genehmigung

Umgebungsvariablen

Konfigurationspriorität

Der Server verwendet die folgende Prioritätsreihenfolge für die Konfiguration:

1. CLI-Flag --config-base64 (höchste Priorität)

2. Umgebungsvariable KSM_CONFIG_BASE64

3. CLI-Flag --profile mit lokalem Profilspeicher

4. Umgebungsvariable KSM_MCP_PROFILE mit lokalem Profilspeicher

Profilverwaltungsbefehle

Warum Profile verwenden?

Profile bieten eine sichere Möglichkeit, KSM-Konfigurationen lokal zu speichern und zu verwalten, ohne sensible Anmeldedaten preiszugeben:

• Sicherheit: Ihre base64-Konfiguration enthält sensible KSM-Anwendungsanmeldedaten. Profile verschlüsseln und speichern diese lokal mit Passwortschutz

• Bequemlichkeit: Nach der Initialisierung müssen Sie nur noch auf den Profilnamen verweisen, anstatt jedes Mal die vollständige base64-Konfiguration zu übergeben

• Mehrere Umgebungen: Verwalten Sie verschiedene KSM-Anwendungen (dev, staging, prod) mit separaten Profilen

• Schutz von Anmeldedaten: Hält sensible Daten aus Befehlszeilen, Umgebungsvariablen und Konfigurationsdateien fern

• Persistenter Speicher: Übersteht Systemneustarts