# Connect your agent

> Add the hosted MCP server to Claude Code, claude.ai, Codex, Cursor or VS Code. No code, about two minutes.

Our MCP server runs with the API, so there is nothing to install. Add one URL to your agent app:

```text
https://mcp.trykubi.com
```

The first time, your browser opens our sign-in page. Pick the screens the agent may use and what it may do, then return to your app. You can disconnect it any time from **Connected apps** in the dashboard.

## Claude Code

```bash
claude mcp add --transport http kubi https://mcp.trykubi.com
```

Then run `/mcp` inside Claude Code and sign in (or `claude mcp login kubi` from your shell).

## claude.ai and Claude Desktop

Open **Customize > Connectors**, click **+ Add**, then **Add custom connector**. Name it Kubi, paste the URL above and click **Continue**, then **Add**.

## Codex

```bash
codex mcp add kubi --url https://mcp.trykubi.com
codex mcp login kubi
```

## Cursor

Add the server to `mcp.json`:

```json
{
  "mcpServers": {
    "kubi": { "url": "https://mcp.trykubi.com" }
  }
}
```

## VS Code

Open the Command Palette, run **MCP: Add Server**, choose **HTTP** and paste the URL.

## Using an API key instead of signing in

For agents that run without a person (CI, servers), send a key in the header:

```text
Authorization: Bearer kubi_...
```

## The tools your agent gets

| Tool | What it does |
|---|---|
| `screenshot` | The screen as an image, with its size and id |
| `zoom` | A region at full resolution, for small text |
| `act` | 1 to 20 actions (click, type, keys, scroll, drag), then the screen after them |
| `wait` | Pause; returns an image only if the screen changed |
| `exec` | Run a shell command; short output inline, long runs get an id |
| `exec_status` | Wait up to 25 s for a command to finish |
| `list_screens`, `status` | Your screens, and each one's state and health |
| `viewer_link` | A view-only live link to share with a person |
| `clipboard` | Read the clipboard, or set it when given text |
| `read_file`, `write_file` | A file up to 64 KiB, as text or base64 |

`start`, `stop` and `restart` are off unless you turn them on. The server never offers tools to create or delete screens, make keys or touch billing.

:::note
Each tool call answers within 30 seconds, well inside the 60-second limit some apps use.
:::