# Быстрый старт

## 1. Получите ключ

В кабинете откройте раздел «API-ключ» и создайте ключ. По умолчанию у него `course:read` и `profile:read`; запись прогресса (`progress:write`), историю тьютора (`tutor:read`) и личный менторинг (`mentoring:read`) включите отдельно, если они нужны. Секрет вида `aos3.sk_…` показывается один раз – сохраните его в менеджере паролей или переменной окружения:

```bash
export AOS_API_KEY=aos3.sk_…
```

Для коннекторов Claude.ai и ChatGPT ключ не нужен: они входят по OAuth (шаг 3).

## 2. Первый запрос

Что студенту смотреть дальше – тот же запрос, что показывает кабинет:

```bash
curl -s https://aos.edgelab.space/api/v1/next -H "Authorization: Bearer $AOS_API_KEY"
```

Прогресс студента на трёх языках:

Прочитайте прогресс студента с API-ключом, которому выдан `course:read`. Во всех трёх примерах используется один endpoint и переменная окружения `AOS_API_KEY` с настоящим ключом; ответ – JSON [Progress](/docs/schemas#progress). Примеры не выполняются автоматически.

**curl**

```bash
curl --fail-with-body -sS https://aos.edgelab.space/api/v1/progress \
  -H "Authorization: Bearer $AOS_API_KEY"
```

**JavaScript · Node.js**

```js
const response = await fetch('https://aos.edgelab.space/api/v1/progress', {
  headers: { Authorization: `Bearer ${process.env.AOS_API_KEY}` },
});
const body = await response.json();
if (!response.ok) throw new Error(`${response.status}: ${JSON.stringify(body)}`);
console.log(body);
```

**Python · стандартная библиотека**

```python
import json
import os
import urllib.request

request = urllib.request.Request(
    "https://aos.edgelab.space/api/v1/progress",
    headers={"Authorization": f"Bearer {os.environ['AOS_API_KEY']}"},
)
with urllib.request.urlopen(request) as response:
    print(json.load(response))
```

Ответ – JSON. Ошибки приходят в едином формате `{ "error": { "code", "message" } }` – см. [Ошибки](/docs/errors).

## 3. Подключите MCP

Адрес сервера – `https://aos.edgelab.space/mcp`, название – `AgentOS`.

### Claude

1. Откройте Claude в браузере или приложении: «Настройки» → «Коннекторы» → «Добавить свой коннектор».
2. Название – `AgentOS`, адрес – `https://aos.edgelab.space/mcp`. Нажмите «Добавить».
3. Claude откроет вход в AgentOS: войдите в кабинет и нажмите «Разрешить». API-ключ не нужен.

Если клиент предлагает выбрать способ регистрации, выбирайте автоматическую (DCR).

### ChatGPT

1. Откройте ChatGPT: «Настройки» → «Коннекторы» → добавить свой MCP-сервер.
2. Адрес – `https://aos.edgelab.space/mcp`, авторизация – OAuth с автоматической регистрацией (DCR), без `client_secret`.
3. Войдите в кабинет AgentOS и нажмите «Разрешить», затем включите коннектор в чате.

Названия пунктов меню зависят от версии ChatGPT и настроек workspace.

### Claude Code

Выполните команду в терминале, вставив свой ключ вместо `aos3.sk_…`. `--scope user` подключает AgentOS во всех проектах:

```bash
claude mcp add --scope user --transport http agentos https://aos.edgelab.space/mcp \
  --header "Authorization: Bearer aos3.sk_…"
```

Проверьте подключение командой `/mcp` в Claude Code.

### Codex

Добавьте блок в `~/.codex/config.toml` – Codex берёт ключ из переменной окружения:

```toml
[mcp_servers.agentos]
url = "https://aos.edgelab.space/mcp"
bearer_token_env_var = "AOS_API_KEY"
```

Добавьте строку с ключом в профиль оболочки (`~/.zshrc` или `~/.bashrc`) и откройте новый терминал:

```bash
export AOS_API_KEY=aos3.sk_…
```

Вместо ключа можно войти по OAuth: `codex mcp add agentos --url https://aos.edgelab.space/mcp`, затем `codex mcp login agentos`.

## 4. Спросите агента

```text
Через MCP agentos скажи, что мне делать дальше, и пришли ссылку на скилл из последнего эфира
```

Агент вызовет инструменты AgentOS (например, `aos_next`) и ответит с учётом прогресса студента. Полный список – [Инструменты MCP](/docs/mcp/tools).
