К содержанию
AgentOSДокументация
  • Загружаем индекс…
llms.txtКабинет

Начало

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

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. Примеры не выполняются автоматически.

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" } } – см. Ошибки.

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.