ACP-Connector

Der acp-connector bridged das Agent Client Protocol (ACP) zu lokalen Agent-Prozessen über stdio und stellt die Steuerung als MCP-Tools bereit. Er ist für lokale Agent-Runtimes gedacht, die über ACP initialisiert werden, Sessions öffnen, Prompts entgegennehmen und Status- oder Permission-Requests an den Host zurückgeben.

Für CLYE AI immer über mcp starten – sonst läuft nur der lokale stdio-Server und AI_HUB_URL greift nicht. Siehe MCP-Registrierung und Docker.

Wofür `acp-connector` gedacht ist – und wofür nicht

Der acp-connector ist für den Fall gedacht, dass CLYE selbst der Assistent bleibt und einen lokalen ACP-Agenten nur als zusätzliches Tool verwendet.

Das ist etwas anderes als Assistenten andocken:

acp-connector: CLYE bleibt der eigentliche Assistent. Lokale ACP-Agenten werden über MCP als Werkzeuge angebunden.
Assistenten andocken: Ein Assistent kann so konfiguriert werden, dass Chats und zugewiesene Tasks direkt an einen verbundenen lokalen Prozess gehen. In diesem Modus laufen Chat und Task nicht über das eingebaute In-CLYE-LLM.

Wichtig:

eine angedockte Session wird nicht zusätzlich als normales LLM-Tool installiert
im Chat gibt es keinen Fallback auf das eingebaute Modell; ohne aktive Verbindung erscheint stattdessen ein klarer Hinweis auf den fehlenden lokalen Assistenten
wenn die lokale Session für eine Task gerade fehlt, bleibt der zugewiesene Task zunächst pending und wird später erneut versucht

Für das Andocken eines Assistenten nutzt du in der CLI clye acp mit dem API-Key des Bot-Spaces – nicht clye acp-connector.

Start und Konfiguration

clye mcp clye acp-connector \
  --acp-agents-config /pfad/zu/agents.json \
  --workspace /pfad/zum/projekt

{
  "agents": [
    {
      "id": "local-agent",
      "command": "mein-agent",
      "args": ["--stdio"],
      "description": "Lokaler ACP-Agent"
    }
  ]
}

Flag	Standard	Beschreibung
`--acp-agents-config`	`ACP_AGENTS_CONFIG`	JSON-Datei mit Agent-Profilen.
`--workspace`	Aktuelles Verzeichnis	Default-Workspace für `fs/*`-Validierung.
`--acp-auto-approve`	`true`	Genehmigt `session/request_permission` automatisch.

MCP-Tools

Tool	Parameter	Beschreibung
`acp_list_agents`	-	Listet konfigurierte Agent-Profile.
`acp_agent_info`	`agent_id` (Pflicht)	Lädt ein Agent-Profil per ID.
`acp_spawn`	`command` (Pflicht), `args`, `cwd`, `env`, `workspace`, `enable_fs`, `enable_terminal`	Startet einen ACP-Agent-Prozess, initialisiert ihn und registriert eine Verbindung.
`acp_session_new`	`connection_id` (Pflicht), `cwd`, `mcp_servers`	Erstellt eine ACP-Session.
`acp_session_prompt`	`connection_id` (Pflicht), `session_id` (Pflicht), `prompt_text`, `prompt_blocks`	Sendet einen Prompt und gibt Stop-Reason plus gepufferte Updates zurück.
`acp_session_cancel`	`connection_id` (Pflicht), `session_id` (Pflicht)	Sendet `session/cancel`.
`acp_run`	`command` (Pflicht), `args`, `cwd`, `workspace`, `prompt_text` (Pflicht)	One-shot-Ablauf: Spawn, Initialize, Session und Prompt in einem Tool.
`acp_list_runs`	-	Listet gespeicherte Run-IDs aus `acp_run`.
`acp_run_status`	`run_id` (Pflicht)	Gibt Statusdaten für einen Run zurück.
`acp_status`	`connection_id`	Zeigt Prozessstatus für eine Verbindung oder alle Verbindungen.
`acp_stop`	`connection_id` (Pflicht)	Beendet den Agent-Prozess und entfernt die Verbindung.

workspace begrenzt Dateisystem-Clientmethoden des Agents. enable_fs und enable_terminal steuern, welche Client-Capabilities gegenüber dem ACP-Agent beworben werden.

Wofür acp-connector gedacht ist – und wofür nicht​

Start und Konfiguration​

MCP-Tools​

Inhalt

Wofür `acp-connector` gedacht ist – und wofür nicht

Start und Konfiguration

MCP-Tools