# 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

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--install` | bool | write the config into the named clients (or every one found) |  |
| `--show-key` | bool | put the signed-in key in the printed config instead of $KOSA8_API_KEY |  |
| `--uninstall` | bool | remove kosa8-cloud from the named clients (or every one found) |  |

---
Source: https://docs.kosa8.com/reference/cloud-mcp/