# Connect Claude Code or Cursor

Coding agents reach AUGMTD's MCP server at `https://app.augmtd.ai/api/mcp`. Sign in from your browser (no key), or
send a key in a header.

## Claude Code, with sign-in

Run this once in a terminal:

```bash
claude mcp add --transport http augmtd https://app.augmtd.ai/api/mcp
```

Then run `/mcp` in Claude Code and choose augmtd to sign in. Your browser opens AUGMTD's sign-in; click **Allow**.

## Claude Code, with a key

Make a key in **Settings → Connections → API keys** (it is shown once), then:

```bash
claude mcp add --transport http augmtd https://app.augmtd.ai/api/mcp --header "Authorization: Bearer augk_YOUR_KEY"
```

## Cursor and other MCP clients

Add this to `~/.cursor/mcp.json` (or **Add to Cursor** from the connect picker in the
[reference](/docs/reference)). Cursor opens AUGMTD's sign-in in your browser; click **Allow**.

```json
{ "mcpServers": { "augmtd": { "url": "https://app.augmtd.ai/api/mcp" } } }
```

A client that cannot sign in can send a key instead:

```json
{ "mcpServers": { "augmtd": { "url": "https://app.augmtd.ai/api/mcp",
  "headers": { "Authorization": "Bearer augk_YOUR_KEY" } } } }
```

Codex (`codex mcp add augmtd --url https://app.augmtd.ai/api/mcp`) and Gemini CLI
(`gemini mcp add --transport http augmtd https://app.augmtd.ai/api/mcp`) work the same way; the picker in the
[reference](/docs/reference) has each tool's steps.

## The augmtd CLI

The `augmtd` command reads your work and proposes next steps from a terminal or a script. It needs Node.js 20 or later
and a key.

```bash
npx augmtd login
npx augmtd work list
npx augmtd work get <id>
npx augmtd help
```

- `npx augmtd login` asks for the key and saves it on your computer, readable by you only
  (`~/.config/augmtd/config.json`, or `AUGMTD_CONFIG`). `AUGMTD_KEY` uses a key for one run instead.
- On another address than `https://app.augmtd.ai`, sign in with `--base-url` (or `AUGMTD_BASE_URL`); a saved key is
  only ever sent to the address it was saved for.
- The commands come from the live API: an operation list_x is `augmtd x list`, get_x is `augmtd x get <id>`, propose_x is
  `augmtd propose x`. A new operation is a command the day the API offers it. `npx augmtd help propose promise` lists
  one command's arguments.
- Add `--json` for the raw answer (for `jq` and scripts).

Like every key, the CLI only reads and proposes: a proposal waits for your approval in AUGMTD.