Betrieb¶

Updates¶

Der Server hält sich selbst aktuell:

cco-mcp-server update --check   # Gibt es eine neue, von der Lizenz gedeckte Version?
cco-mcp-server update           # Neue Version installieren + Lizenz auffrischen

update lädt das Binary Ihrer Plattform vom Portal, prüft es per SHA-256 und ersetzt die laufende Installation atomar. Dabei frischt es auch den Lizenzschlüssel auf. Nach dem Update den MCP-Client bzw. die Session neu starten, damit die neue Version läuft.

Unter Windows kann sich ein laufendes Programm nicht selbst überschreiben. update legt das neue Binary dort als <pfad>.new daneben und sagt Ihnen, dass Sie die Datei nach Prozessende an die Stelle der alten schieben. Der erneute Lauf des Install-Einzeilers (siehe Installation) erledigt das gleich mit.

Alternativ aktualisiert der Install-Einzeiler jederzeit auf die neueste oder eine bestimmte Version (--version).

Portal-Verbindung¶

cco-mcp-server login verbindet das Gerät mit Ihrem Portal-Konto: Der Befehl zeigt eine URL und einen kurzen Code, Sie bestätigen den Code im Browser. Gespeichert wird ein Konto-Token in ~/.cco-mcp-server/portal-token; die aktuelle Lizenz kommt direkt mit.

Der Installer hat das Gerät in der Regel schon verbunden; login braucht es nur bei einem neuen Gerät oder nach dem Widerruf des Tokens.
Das Token lässt sich jederzeit im Portal widerrufen. Danach meldet update das Token als ungültig; ein neues login behebt das.
In Skripten oder CI übersteuert die Umgebungsvariable CCO_MCP_PORTAL_TOKEN das gespeicherte Token.

Lizenz¶

Der Server startet nur mit gültigem Lizenzschlüssel und zeigt beim Start einen Banner mit dem Lizenznehmer. Die Prüfung läuft offline; der Server braucht im Betrieb keine Verbindung zum Portal.

Der CCO MCP Server ist kostenlos für alle registrierten Portal-Konten. Ein Kauf oder Wartungsabo ist nicht nötig. Das Portal stellt die kostenlose Lizenz beim Download aus und frischt sie bei Updates auf. Der Schlüssel deckt Releases bis zu seinem Stichtag; eine bereits gedeckte Version läuft auch danach weiter. Fehlt der Schlüssel oder ist er zu alt für ein Update, führen Sie den Installer erneut aus oder nutzen Sie cco-mcp-server update.

Der Server sucht den Schlüssel in dieser Reihenfolge:

Umgebungsvariable CCO_MCP_LICENSE (der Schlüssel selbst)
Umgebungsvariable CCO_MCP_LICENSE_FILE (Pfad zur Schlüsseldatei)
~/.cco-mcp-server/license.key (legt der Installer an)

Schlüssel im alten Format CCOMCP1- akzeptiert der Server seit 0.6.0 nicht mehr; Bestandsnutzer bekommen kostenlos einen neuen Schlüssel über ihr Portal-Konto, siehe FAQ.

Logs¶

Der Server schreibt Statusmeldungen (Lizenz-Banner, verbundene Manager, Fehler) auf stderr. Wo sie landen, bestimmt der MCP-Client: Claude Code und Claude Desktop sammeln die Ausgaben ihrer MCP-Server in ihren jeweiligen Log-Dateien. Beim Start von Hand im Terminal, etwa zum Testen der Konfiguration, erscheinen die Meldungen direkt.

Fehlerbilder¶

Meldung / Symptom	Ursache und Abhilfe
`no manager configured` beim Start	Weder `CCOM_URL` noch eine Manager-Datei vorhanden. `cco-mcp-server add-manager` ausführen oder Umgebungsvariablen setzen, siehe Konfiguration.
Lizenzfehler beim Start	Schlüssel fehlt oder deckt die Version nicht. `cco-mcp-server update` frischt die Lizenz auf; die Auffrischung ist für registrierte Portal-Konten kostenlos.
`401` bei jedem Zugriff (Cloud Edition)	Dem automatisch angelegten Technical User fehlt die Rolle im Manager, siehe Konfiguration.
`Portal token invalid or revoked`	Token wurde widerrufen oder ist ungültig. `cco-mcp-server login` erneut ausführen.
Schreibendes Werkzeug wird abgelehnt	Das Profil oder der Server läuft read-only (`readOnly` bzw. `CCO_MCP_READONLY=true`). Gewollt? Sonst Konfiguration anpassen.
MCP-Client zeigt den Server nicht	Nach Installation, Update oder Konfigurationsänderung den Client bzw. die Session neu starten.

Kommen Sie nicht weiter, erreichen Sie den Support unter stefan.baust@stefanbaust.de.