# Getting started
`circleci` is a command-line interface to CircleCI for use in your terminal or your scripts.

## Installation

Installation instructions are in the [README](https://github.com/CircleCI-Public/circleci-cli#readme)

## Configuration

Run `circleci auth login` to authenticate with your CircleCI account. You can also set the
`CIRCLE_TOKEN` environment variable.

## Get Running

Run `circleci run get` to view the runs for the current project in an interactive terminal UI (TUI).

## Model Context Protocol

The CLI supports the MCP protocol. To enable it, run:

Claude:
```shell
circleci mcp claude enable # Enable in Claude desktop
claude mcp add-from-claude-desktop -s user # Add with current user scope
```

Cursor:
```shell
circleci mcp cursor enable
```

VS Code:
```shell
circleci mcp vscode enable
```

## Support

Report bugs or search for existing feature requests in our
[issue tracker](https://github.com/CircleCI-Public/circleci-cli/issues)
