chainctl develop mcp

chainctl develop mcp

Serve tools for development sessions to an MCP client over stdio.

Synopsis

Serve the develop session tools over the Model Context Protocol on stdin and stdout, for an agent such as Claude Code to manage your sessions and read, edit and run commands in them:

claude mcp add develop – chainctl develop mcp

The tools are exec, wait, kill, read, write, edit, upload (a file from this machine) and download (a file to this machine); service_start, service_list and service_stop (long-lived processes, in a session with agent contexts); and session_create, session_list, session_rename, session_extend and session_delete. A session parameter is a session name or short id, resolved in –parent as the other develop verbs resolve it. Paths are absolute in the guest or relative to /work. write and edit refuse a file that changed since this server last read it. session_delete takes the session’s full name again in confirm_name. Nothing is asked on the terminal: a choice the verbs would prompt for fails with the candidates instead.

Run long builds and tests with the exec tool’s run_in_background, then wait for them: the command runs detached in the guest, so the server’s other calls go on beside it. A ‘chainctl develop exec’ from Bash instead holds the guest for the whole command, and another API replica’s calls queue behind it.

chainctl develop mcp [--parent GROUP]

Options inherited from parent commands

      --api string         The url of the Chainguard platform API. (default "https://console-api.enforce.dev")
      --audience string    The Chainguard token audience to request. (default "https://console-api.enforce.dev")
      --config string      A specific chainctl config file. Uses CHAINCTL_CONFIG environment variable if a file is not passed explicitly.
      --console string     The url of the Chainguard platform Console. (default "https://console.chainguard.dev")
      --force-color        Force color output even when stdout is not a TTY.
  -h, --help               Help for chainctl
      --issuer string      The url of the Chainguard STS endpoint. (default "https://issuer.enforce.dev")
      --log-level string   Set the log level (debug, info) (default "ERROR")
      --non-interactive    Disable prompts; fail if a session or group choice is ambiguous.
  -o, --output string      Output format. One of: [csv, env, go-template, id, json, markdown, none, table, terse, tree, wide]
      --parent string      Organization or folder name/ID (defaults to $CHAINCTL_SANDBOX_GROUP, then default.group).
  -v, --v int              Set the log verbosity level.

SEE ALSO

• chainctl develop - Open or resume a cloud development session.