Начало
Быстрый старт
1. Получите ключ#
В кабинете откройте раздел «API-ключ» и создайте ключ. По умолчанию у него course: и profile:; запись прогресса (progress:), историю тьютора (tutor:) и личный менторинг (mentoring:) включите отдельно, если они нужны. Секрет вида aos3. показывается один раз – сохраните его в менеджере паролей или переменной окружения:
export AOS_API_KEY=aos3.sk_…Для коннекторов Claude.ai и ChatGPT ключ не нужен: они входят по OAuth (шаг 3).
2. Первый запрос#
Что студенту смотреть дальше – тот же запрос, что показывает кабинет:
curl -s https://aos.edgelab.space/api/v1/next -H "Authorization: Bearer $AOS_API_KEY"Прогресс студента на трёх языках:
Прочитайте прогресс студента с API-ключом, которому выдан course:. Во всех трёх примерах используется один endpoint и переменная окружения AOS_ с настоящим ключом; ответ – JSON Progress. Примеры не выполняются автоматически.
curl
curl --fail-with-body -sS https://aos.edgelab.space/api/v1/progress \
-H "Authorization: Bearer $AOS_API_KEY"JavaScript · Node.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 · стандартная библиотека
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. Ошибки приходят в едином формате { – см. Ошибки.
3. Подключите MCP#
Адрес сервера – https:, название – AgentOS.
Claude#
- Откройте Claude в браузере или приложении: «Настройки» → «Коннекторы» → «Добавить свой коннектор».
- Название –
AgentOS, адрес –https:. Нажмите «Добавить»./ / aos. edgelab. space/ mcp - Claude откроет вход в AgentOS: войдите в кабинет и нажмите «Разрешить». API-ключ не нужен.
Если клиент предлагает выбрать способ регистрации, выбирайте автоматическую (DCR).
ChatGPT#
- Откройте ChatGPT: «Настройки» → «Коннекторы» → добавить свой MCP-сервер.
- Адрес –
https:, авторизация – OAuth с автоматической регистрацией (DCR), без/ / aos. edgelab. space/ mcp client_.secret - Войдите в кабинет AgentOS и нажмите «Разрешить», затем включите коннектор в чате.
Названия пунктов меню зависят от версии ChatGPT и настроек workspace.
Claude Code#
Выполните команду в терминале, вставив свой ключ вместо aos3.. - подключает AgentOS во всех проектах:
claude mcp add --scope user --transport http agentos https://aos.edgelab.space/mcp \
--header "Authorization: Bearer aos3.sk_…"Проверьте подключение командой / в Claude Code.
Codex#
Добавьте блок в ~/ – Codex берёт ключ из переменной окружения:
[mcp_servers.agentos]
url = "https://aos.edgelab.space/mcp"
bearer_token_env_var = "AOS_API_KEY"Добавьте строку с ключом в профиль оболочки (~/ или ~/) и откройте новый терминал:
export AOS_API_KEY=aos3.sk_…Вместо ключа можно войти по OAuth: codex , затем codex .
4. Спросите агента#
Через MCP agentos скажи, что мне делать дальше, и пришли ссылку на скилл из последнего эфираАгент вызовет инструменты AgentOS (например, aos_) и ответит с учётом прогресса студента. Полный список – Инструменты MCP.