# Quickstart

Make your first call to Covo in five minutes, with a personal access token or through OAuth.

## 1. Get a token

In Studio, open Settings, then Developer Access, and choose Create a token. Pick a preset (Read only, Development or Deployment), the Concierges it may reach, and when it expires. Copy the token: it starts with `cc_pat_` and is shown once.

> Apps that support OAuth (Meta Muse, ChatGPT, Claude, Grok and most coding tools) do not need a token: the person approves the app instead. See [Authentication](https://covo.lanaai.io/docs/authentication).

## 2. Call the API

```bash
export COVO_TOKEN=cc_pat_...
curl https://covo.lanaai.io/api/v1/me -H "Authorization: Bearer $COVO_TOKEN"
```

You get the account, the token's scopes and the agents it can reach. Then list agents:

```bash
curl https://covo.lanaai.io/api/v1/agents -H "Authorization: Bearer $COVO_TOKEN"
```

## 3. Or connect over MCP

Point any MCP client at the server with the token as a bearer header. With Claude Code:

```bash
claude mcp add --transport http covo https://covo.lanaai.io/mcp \
  --header "Authorization: Bearer $COVO_TOKEN"
```

Then ask the assistant to run `get_account` and `list_agents`. Other tools: [Coding tools](https://covo.lanaai.io/docs/connect/coding-tools).

## 4. Make a safe change

1. Read with `get_agent_configuration` and note `revision`.
2. Check with `preview_agent_changes` (changes nothing).
3. Apply with `update_agent_configuration`, sending `expected_revision`. A version is saved first, so `restore_version` can undo it.
4. Test with `run_agent_test`, then publish with `publish_agent` and `confirm: true` once the person agrees.

The full sequence and why: [Safe change workflow](https://covo.lanaai.io/docs/workflow).