kosa8 docs

Commands / kosa8 cloud mcp

kosa8 cloud mcp

Connect Claude Code, Cursor or Codex to kosa8 Cloud's MCP server

Usage

kosa8 mcp [CLIENT...]

kosa8 Cloud has a remote MCP server at https://api.kosa8.com/mcp. An AI agent connected to it can create cloud sandboxes, run commands in them, put them to sleep and delete them, and read this month's usage, with your Cloud API key.

With no flags this prints the config for Claude Code, Cursor, Codex and any other MCP client, reading the key from $KOSA8_API_KEY (--show-key puts the signed-in key in instead). Nothing is written.

--install writes it into the clients named (claude-code, cursor, codex), or every one found on this machine: Claude Code with claude mcp add --scope user, Cursor in ~/.cursor/mcp.json (mode 0600, the old file kept as .bak), Codex in ~/.codex/config.toml (Codex reads the key from KOSA8_API_KEY, so it is not written there). --uninstall takes it out again. The server is named kosa8-cloud, beside the local kosa8 server from kosa8 mcp install.

kosa8 cloud mcp # print every config kosa8 cloud mcp cursor --show-key # Cursor's, with the key in it kosa8 cloud mcp --install claude-code

Options

FlagTypeWhat it doesDefault
--installboolwrite the config into the named clients (or every one found)—
--show-keyboolput the signed-in key in the printed config instead of $KOSA8_API_KEY—
--uninstallboolremove kosa8-cloud from the named clients (or every one found)—