Documentation menu

Ihren KI-Assistenten verbinden

Manisma kann eine Verbindung zu einem KI-Assistenten herstellen, den Sie bereits verwenden, etwa Claude Desktop, Claude Code, der ChatGPT-Desktop-App oder der Codex CLI. Die Verbindung verwendet das offene Model Context Protocol. Sie können dann im Chatfenster Ihres Assistenten Fragen stellen und Planungsarbeit erledigen.

Ihr Assistent, Ihre KI

Ihr eigener Assistent übernimmt das Denken. Manisma liefert den Plan und die Daten, betreibt für diese Verbindung jedoch keine eigene KI. Die Verbindung verbraucht auch keine in Ihrem Manisma-Tarif enthaltenen KI-Aktionen.

Die Schaltfläche KI-Vorschlag in Manisma ist davon getrennt. Diese Funktion verwendet die KI von Manisma und die KI-Aktionen Ihres Tarifs.

Was Ihr Assistent kann

Ihr Assistent kann Aufträge, Kunden, Techniker, Materialien, Aufgabentypen und Geräte nachschlagen. Er kann Aufträge und Kunden anlegen und aktualisieren, einen Auftrag mit einem Techniker einplanen und einen Planungsvorschlag anfordern. Er kann niemals etwas löschen.

Einen Schlüssel erstellen

Öffnen Sie Verwaltung → API-Schlüssel, erstellen Sie einen Schlüssel und kopieren Sie ihn sofort. Er wird nur einmal angezeigt. Lesen, Schreiben und Planen sind getrennte Berechtigungen. Ein Schlüssel mit nur Leserechten kann also Informationen nachschlagen, aber nichts ändern. Behandeln Sie den Schlüssel wie ein Passwort.

Die Verbindung installieren

Für alle Wege ist Node.js 22 oder neuer erforderlich. Prüfen Sie die installierte Version:

node --version

Holen Sie den API-Schlüssel unter Verwaltung → API-Schlüssel. Er wird nur einmal angezeigt und sieht aus wie msk_, gefolgt von 40 Hexadezimalzeichen. Lesen, Schreiben und Planen sind getrennte Berechtigungen.

Weg 1: Claude Desktop

  1. Laden Sie https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb herunter.
  2. Öffnen Sie die heruntergeladene Datei. Claude Desktop zeigt einen Installationsdialog.
  3. Fügen Sie den API-Schlüssel nach Aufforderung ein. Er wird sicher gespeichert.

Sie müssen keine Datei bearbeiten und kein Terminal verwenden.

Weg 2: Claude Code

  1. Laden Sie https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb herunter.
  2. Öffnen Sie ein Terminal im Downloadordner und führen Sie Folgendes aus:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
claude mcp add manisma -e MANISMA_API_KEY=msk_your_key_here -- node ~/manisma-mcp/dist/index.js
  1. Ersetzen Sie msk_your_key_here durch den API-Schlüssel.
  2. Prüfen Sie die Verbindung in Claude Code mit dem Befehl /mcp.

Weg 3: Codex CLI und die ChatGPT-Desktop-App

  1. Laden Sie https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb herunter.
  2. Öffnen Sie ein Terminal im Downloadordner und entpacken Sie die Datei:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
  1. Fügen Sie diesen Block zu ~/.codex/config.toml hinzu und ersetzen Sie Pfad und Schlüssel. Der Pfad muss absolut sein, da ~ hier nicht erweitert wird.
[mcp_servers.manisma]
command = "node"
args = ["/home/you/manisma-mcp/dist/index.js"]
env = { MANISMA_API_KEY = "msk_your_key_here" }
  1. Führen Sie codex mcp list aus. manisma sollte als enabled erscheinen.

Unter Windows ist die .mcpb-Datei ein ZIP-Archiv. Falls Windows sie nicht entpackt, ändern Sie die Erweiterung in .zip und wählen Sie Alle extrahieren.

Was Sie erwarten können

Ihr Assistent fragt vor jeder Änderung nach und bearbeitet immer nur einen Auftrag. Ein Planungsvorschlag wird zuerst angezeigt und erst nach Ihrer Bestätigung angewendet.

Der Assistent kann Arbeitszeiten und freie Tage nicht sehen. Prüfen Sie eine vorgeschlagene Zeit daher anhand des tatsächlichen Dienstplans. Planungsvorschläge sind auf einige Anfragen je zehn Minuten begrenzt.

Einschränkungen

Die Verbindung arbeitet mit den in Manisma gespeicherten Daten. Sie ersetzt nicht die Planungstafel und ist nur so aktuell wie die gespeicherten Daten.