Installation¶

Die Installation läuft komplett über das Kundenportal: eine Zeile lädt das Binary für Ihre Plattform, verbindet das Gerät mit Ihrem Portal-Konto und legt die Lizenz ab.

Install-Einzeiler¶

# Linux / macOS
curl -fsSL https://portal.stefanbaust.de/api/v1/install/cco-mcp-server.sh | sh

# Windows (PowerShell)
irm https://portal.stefanbaust.de/api/v1/install/cco-mcp-server.ps1 | iex

Beim ersten Lauf zeigt das Skript einen kurzen Code und eine Portal-URL an. Öffnen Sie die URL im Browser, melden Sie sich mit Ihrem Portal-Konto an und bestätigen Sie den Code. Noch kein Konto? Registrieren Sie sich zuerst unter portal.stefanbaust.de.

Danach erledigt der Installer den Rest:

lädt das Binary für Ihre Plattform und prüft es per SHA-256,
holt Ihren Lizenzschlüssel vom Portal,
legt alles unter ~/.cco-mcp-server/ ab (stabiler Pfad, die MCP-Konfiguration übersteht Updates):

Datei	Inhalt
`bin/cco-mcp-server`	das Server-Binary
`portal-token`	Ihr Konto-Token (im Portal widerrufbar; nutzt auch `cco-mcp-server update`)
`license.key`	Ihre Lizenz (wird bei jedem Lauf aufgefrischt)

Ein erneuter Lauf desselben Einzeilers aktualisiert eine bestehende Installation. Alternativ aktualisiert sich der Server selbst, siehe Betrieb.

Aus jedem Terminal-Verzeichnis starten¶

Der Installer nimmt cco-mcp-server in den Benutzer-PATH auf. Administratorrechte sind dafür nicht nötig. Unter Windows funktioniert der Befehl sofort in derselben PowerShell; andere Terminal-Anwendungen müssen Sie neu starten. Unter Linux und macOS öffnen Sie nach der Installation ein neues Terminal. Bash, Zsh und Fish werden unterstützt.

cco-mcp-server --version
cco-mcp-server add-manager
cco-mcp-server update

Bei einer vorhandenen Installation führen Sie den Install-Einzeiler erneut aus. Ein reines Binary-Update mit cco-mcp-server update richtet den PATH nicht ein. Die gespeicherten Manager-Profile stehen in jedem Verzeichnis zur Verfügung. Verwenden Sie in Desktop-MCP-Konfigurationen weiterhin den vollständigen Programmpfad, da Desktop-Anwendungen einen anderen PATH haben können.

Mit --no-modify-path beim Shell-Installer oder -NoModifyPath beim PowerShell-Installer verwalten Sie den PATH selbst. Zum Entfernen des Befehls löschen Sie den Block cco-mcp-server: terminal command aus den vom Installer genannten Shell-Startdateien oder den Binary-Ordner aus dem Windows-Benutzer-PATH. Fish verwendet fish/conf.d/cco-mcp-server.fish im Konfigurationsverzeichnis.

Optionen¶

Der Installer versteht Argumente nach -s --:

# Bestimmte Version installieren
curl -fsSL https://portal.stefanbaust.de/api/v1/install/cco-mcp-server.sh | sh -s -- --version 0.7.0

# Ohne Browser-Bestätigung (z. B. Skripte/CI): Konto-Token direkt übergeben
curl -fsSL https://portal.stefanbaust.de/api/v1/install/cco-mcp-server.sh | sh -s -- --token cpt_...

Unterstützte Plattformen: Linux x64, Windows x64, macOS Intel und Apple Silicon. Fehlt Ihre Plattform, melden Sie sich unter stefan.baust@stefanbaust.de.

Manager hinterlegen¶

Bevor der Server startet, braucht er die Zugangsdaten mindestens eines CCO Managers. Der einfachste Weg ist der interaktive Assistent:

cco-mcp-server add-manager

Er fragt Typ (on-premise oder Cloud Edition), URL und Zugangsdaten ab, testet die Verbindung vor dem Speichern und zeigt am Ende die fertigen Snippets für die Registrierung im MCP-Client an. Alle Varianten (Umgebungsvariablen, mehrere Manager) beschreibt die Seite Konfiguration.

Im MCP-Client registrieren¶

Codex und ChatGPT Desktop unter Windows¶

Starten Sie den Einrichtungsassistenten in PowerShell:

cco-mcp-server add-manager

Wählen Sie für einen on-premise Manager Typ 2 und einen eindeutigen Profilnamen, etwa fp21-demo. Für weitere Manager führen Sie den Assistenten erneut aus.

Öffnen Sie in der Desktop-App Einstellungen → MCP-Server → Server hinzufügen. Wählen Sie STDIO, nennen Sie den Server cco-manager und tragen Sie den vollständigen Programmpfad ein, etwa C:\Users\Alex\.cco-mcp-server\bin\cco-mcp-server.exe. Lassen Sie die Argumente leer, damit alle gespeicherten Profile verfügbar sind. Speichern Sie und starten Sie die MCP-Verbindung neu.

Mit der Codex CLI können Sie denselben Server in PowerShell registrieren:

codex mcp add cco-manager -- "$env:USERPROFILE\.cco-mcp-server\bin\cco-mcp-server.exe"

Desktop-App und CLI teilen %USERPROFILE%\.codex\config.toml. Die passende Konfiguration lautet:

[mcp_servers.cco-manager]
command = 'C:\Users\Alex\.cco-mcp-server\bin\cco-mcp-server.exe'

Ersetzen Sie Alex durch Ihren Windows-Benutzernamen. Im TOML muss der Pfad absolut sein; $env:USERPROFILE wird dort nicht ersetzt.

Fragen Sie in einer neuen Unterhaltung: „Welche CCO Manager sind verbunden? Prüfe die Verbindungen.“ Nennen Sie anschließend das Profil, zum Beispiel: „Zeige auf fp21-demo den Umsatz je Kasse für August 2026, mit Zeitraum und Währung.“

Mit args = ["--manager", "fp21-demo"] unter dem Programmpfad beschränken Sie diese Verbindung auf ein Profil. Lassen Sie CCOM_URL bei der Verwendung von Profilen ungesetzt: Die Variable überschreibt die Profildatei.

Siehe die offizielle MCP-Anleitung.

Claude Code¶

Mit Manager-Profilen aus add-manager genügt der Pfad zum Binary:

claude mcp add cco-manager -- ~/.cco-mcp-server/bin/cco-mcp-server

Oder mit einem einzelnen Manager direkt über Umgebungsvariablen:

claude mcp add cco-manager \
  -e CCOM_URL=https://ccom.example.com \
  -e CCOM_ADMIN_USER=Admin \
  -e CCOM_ADMIN_PASSWORD=... \
  -- ~/.cco-mcp-server/bin/cco-mcp-server

Claude Desktop¶

In der claude_desktop_config.json:

{
  "mcpServers": {
    "cco-manager": {
      "command": "/home/ich/.cco-mcp-server/bin/cco-mcp-server",
      "env": {
        "CCOM_URL": "https://ccom.example.com",
        "CCOM_ADMIN_USER": "Admin",
        "CCOM_ADMIN_PASSWORD": "..."
      }
    }
  }
}

Den env-Block können Sie weglassen, wenn die Manager in ~/.cco-mcp-server/managers.json stehen. Für die Cloud Edition treten CCOM_CLIENT_ID/CCOM_CLIENT_SECRET an die Stelle von Benutzer und Passwort, siehe Konfiguration.

Laufende MCP-Clients bzw. Sessions müssen neu gestartet werden, damit sie den neuen Server aufnehmen.