MCP-Server

Verwenden Sie ccmux MCP -Server, damit ein Coding-Agent Sitzungen prüfen, Projektnotizen lesen und die Nutzung überprüfen kann. Sitzungserstellung, Tastenanschläge und Beendigung sind nur verfügbar, wenn Sie die Mutation aktivieren.

Die Server-Binärdatei ist in ccmux v0.3.0 und höher enthalten. Installieren Sie ccmux und stellen Sie sicher, dass sein Daemon ausgeführt wird, bevor Sie einen Client verbinden.

Verkabeln Sie es

Registriere in Claude Code einen lokalen stdio-Server für dein Benutzerkonto:

claude mcp add --transport stdio --scope user ccmux -- ccmux-mcp

Ausführen /mcp in Claude Code, um die Verbindung zu überprüfen. Siehe MCP-Dokumentation von Claude Code für Konfigurationsbereiche und Fehlerbehebung.

Für eine projektbezogene Konfiguration verwenden Sie .mcp.json im Projektstamm:

{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp" }
  }
}

Andere MCP-Clients verwenden ihr eigenes Konfigurationsformat. Füge einen stdio-Server mit folgendem Befehl hinzu: ccmux-mcp; Verwenden Sie den absoluten Pfad der Binärdatei, wenn der Client sie auf PATH nicht finden kann.

Der Agent verfügt jetzt über diese Tools:

Diese Tools sind schreibgeschützt. Sie stellen Informationen bereit, die dem verbundenen Daemon zur Verfügung stehen.

Wenn Sie möchten, dass es Dinge erledigt

Hinzugefügt --allow-mutate zu den Serverargumenten. Für eine projektbezogene Claude Code-Konfiguration:

{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp", "args": ["--allow-mutate"] }
  }
}

Das entsperrt:

Aus einem Grund standardmäßig deaktiviert: ein Agent, der das kann send_keys in Ihre Arbeit ein Agent ein, der alles eingeben kann, was Sie eingeben können. Das Flag ist das Opt-in. Es gibt keine Überschreibung pro Werkzeug – Sie schalten den gesamten Mutationssatz ein oder lassen ihn aus.

Ohne das Flag fehlen mutierende Tools tools/list. Starten Sie den MCP-Server über Ihren Client neu, nachdem Sie seine Argumente geändert haben.

Steuern Sie eine Remote-Maschine

CCMUX_HOST=mini.tail-xxxxx.ts.net:7474 ccmux-mcp
# or
ccmux-mcp --host mini.tail-xxxxx.ts.net:7474

Der Agent läuft lokal und fragt den Daemon auf dem Mac mini ab. Mutationswerkzeuge erfordern weiterhin --allow-mutate. Gleiches Protokoll, gleiche Tools – etwas mehr als Tailscale HTTP anstelle des lokalen Unix-Sockets. Nützlich für „Ich programmiere auf dem Laptop, aber die Claude-Nachtarbeit findet auf dem Mini statt.“

Wofür das eigentlich ist

Ein paar konkrete Formen:

Multisitzungs-Orchestrierung. Ein Agent in einer Sitzung erzeugt einen Helfer in einer anderen (spawn_session in einem anderen Projekt), liest seine Ausgabe, sobald es fertig ist (read_pane), ruft das Ergebnis zurück und beendet den Helfer. Kein Mensch auf dem Laufenden.

Maschinenübergreifendes Arbeiten. Ein Agent auf Ihrem Laptop prüft, wie es seinem Geschwister auf dem Mac mini geht (list_sessions, read_pane), ohne dass Sie SSH-ing. Oder startet einen lang laufenden Build auf dem Mini (spawn_session nach der Konfiguration des MCP-Servers mit --host und --allow-mutate) und setzt seine lokale Arbeit fort.

Projektspeicher. Ein Agent liest die Projektnotizen zu Beginn einer Sitzung (list_notes + read_note), sodass die Arbeit des vorherigen Agenten nicht wiederholt wird. Die Notizen sind reine Markdowns auf der Festplatte; Der Agent muss das nicht wissen.

Kostenbewusstsein. Bevor der Agent einen großen Lauf startet, prüft er dies get_usage , um zu sehen, was Sie diese Woche ausgegeben haben, und get_daemon_health , um zu sehen, wie viele Sitzungen bereits ausgeführt werden.

Nichts davon erfordert eine neue Infrastruktur. ccmux hatte bereits alles davon. MCP ist lediglich das Protokoll, das den Agentenzugriff ermöglicht.

Sicherheitsmodell

• Transport. stdio. Der Unix-Socket des Daemons ist auf den Benutzer beschränkt. Für HTTP-Zugriff musst du mit deinem Tailnet verbunden sein.
• Mutation. Aus, es sei denn, Sie drehen die Flagge um.
• Begrenzte Lesevorgänge. read_pane ist auf 500 Zeilen begrenzt, sodass ein fehlerhafter Agent den Daemon nicht nach unten ziehen und bei jedem Aufruf den vollständigen Scrollback anfordern kann.
• Frist pro Anruf. Jeder Handler wird in einem 30-Sekunden-Kontext ausgeführt.

Aktuelle Grenzwerte

Der Server stellt Anfrage-/Antwort-Tools bereit. Live-Abonnements, Mutationsberechtigungen pro Tool und eine Eingabeaufforderungsbibliothek sind derzeit nicht verfügbar.

Verwandte Leitfäden

• Konfigurieren Sie einen Remote-Host , bevor der Daemon als Ziel ausgewählt wird.
• Lesen Sie die Referenz HTTP API zum Erstellen eines Clients direkt gegen ccmuxd.

Haben Sie einen Fehler entdeckt oder ist etwas veraltet? Bearbeiten Sie diese Seite auf GitHub.