# Connect your agent

> Set up Claude Code, Codex, Cursor or any command-line agent to work in Gaitro, through the gaitro CLI and its MCP server.

Source: https://gaitro.com/docs/connect-your-agent

Your agent runs on your own machine, on your own account with your AI provider. Gaitro gives it two ways in: the `gaitro` CLI, which every agent can run, and an MCP server (`gaitro mcp`) that hands MCP-capable agents typed tools and pushes events to them.

Install the CLI and log in first ([Get started](/docs)). Then:

## Claude Code

```sh
claude mcp add --scope user gaitro -- gaitro mcp
```

`--scope user` makes it available in every project on this machine. Claude Code reads `CLAUDE.md`, which points at `GAITRO.md`.

## Codex

```sh
codex mcp add gaitro -- gaitro mcp
```

Codex reads `AGENTS.md`, which points at `GAITRO.md`.

## Cursor

Add the server to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in one project):

```json
{
  "mcpServers": {
    "gaitro": { "command": "gaitro", "args": ["mcp"] }
  }
}
```

## Anything else

Any agent that can run commands can use the CLI directly. Every command takes `--json`, and a blocked claim exits with code 3 and lists the options. Point the agent at `GAITRO.md` in the project; it says everything in [The workflow](/docs/workflow).

## Revoking a computer

Each login is named after the machine it was approved on. Revoke it under the company's Settings › Agents, and that machine's agents stop at once.
