# AgentOS > Документация REST API и MCP-сервера кабинета AgentOS 3: уроки, эфиры, транскрипты, анкета, персональный план, прогресс и личный менторинг студента. REST: https://aos.edgelab.space/api/v1, MCP (Streamable HTTP): https://aos.edgelab.space/mcp. Правила для агентов: - Авторизация: `Authorization: Bearer <ключ>`; ключ `aos3.sk_…` студент выпускает в кабинете, MCP-клиенты Claude и ChatGPT подключаются по OAuth (DCR + PKCE S256). - Права задают scopes ключа: `course:read`, `profile:read`, `progress:write`, `tutor:read`, `mentoring:read`. Не хватает scope – ответ 403 `INSUFFICIENT_SCOPE`. - Лимит на ключ: 60 запросов в минуту и 2000 в сутки (UTC), общий для REST и MCP; при 429 ждите `Retry-After`. - Каждая страница доступна как markdown: добавьте `.md` к адресу. Полный текст – llms-full.txt, контракт – openapi.json. Публичный контракт: REST-операций – 54, инструментов MCP – 22. ## Начало - [Документация AgentOS](https://aos.edgelab.space/docs/index.md): Что такое AgentOS, адреса REST и MCP, авторизация ключами и OAuth, с чего начать. - [Быстрый старт](https://aos.edgelab.space/docs/quickstart.md): Первый запрос к REST API на curl, Python и JavaScript и подключение MCP к Claude, ChatGPT, Claude Code и Codex. - [Авторизация и ключи](https://aos.edgelab.space/docs/auth.md): Способы входа, API-ключи aos3.sk_, scopes, OAuth, сроки жизни токенов и правила заголовков. - [Тарифы и доступ](https://aos.edgelab.space/docs/access.md): Что видят тарифы «Группа» и «Лично» и что доступно агенту по ключу, а что только в кабинете. ## REST API - [REST API](https://aos.edgelab.space/docs/api.md): Базовый URL, формат запросов и ответов и полный индекс публичных эндпоинтов по разделам. - [Вход и сессии](https://aos.edgelab.space/docs/api/auth.md): Вход по ссылке из бота, Telegram Login, Mini App и паролю; сессии кабинета и выход. - [POST /api/v1/auth/link/inspect](https://aos.edgelab.space/docs/api/auth/auth-link-inspect.md): Проверить, в чей кабинет ведёт одноразовая ссылка из бота - [POST /api/v1/auth/link/redeem](https://aos.edgelab.space/docs/api/auth/auth-link-redeem.md): Однократно обменять ссылку из бота на web-сессию - [POST /api/v1/auth/oidc/start](https://aos.edgelab.space/docs/api/auth/auth-oidc-start.md): Начать Telegram Login OIDC: URL авторизации и cookie состояния на 10 минут - [POST /api/v1/auth/oidc](https://aos.edgelab.space/docs/api/auth/auth-oidc.md): Завершить Telegram Login по code и state - [POST /api/v1/auth/tma](https://aos.edgelab.space/docs/api/auth/auth-tma.md): Проверить подписанную строку Telegram.WebApp.initData и выдать TMA bearer и профиль - [POST /api/v1/auth/tma/refresh](https://aos.edgelab.space/docs/api/auth/auth-tma-refresh.md): Продлить тот же TMA token: sliding expiry 15 минут, абсолютный срок не более 12 часов - [POST /api/v1/auth/logout](https://aos.edgelab.space/docs/api/auth/auth-logout.md): Отозвать предъявленную web-сессию или TMA token и остановить связанные активные операции - [GET /api/v1/auth/sessions](https://aos.edgelab.space/docs/api/auth/auth-sessions.md): Список действующих web- и TMA-сессий студента - [POST /api/v1/auth/sessions/revoke-all](https://aos.edgelab.space/docs/api/auth/auth-sessions-revoke-all.md): Отозвать все сессии и TMA tokens студента, включая текущую - [POST /api/v1/auth/password/login](https://aos.edgelab.space/docs/api/auth/auth-password-login.md): Войти по email и паролю - [POST /api/v1/auth/password/forgot](https://aos.edgelab.space/docs/api/auth/auth-password-forgot.md): Запросить письмо со ссылкой сброса пароля (30 минут) - [POST /api/v1/auth/password/reset](https://aos.edgelab.space/docs/api/auth/auth-password-reset.md): Однократно использовать токен письма: задать пароль, погасить ссылки и отозвать все сессии - [GET /api/v1/auth/password](https://aos.edgelab.space/docs/api/auth/auth-password-status.md): Прочитать статус пароля и почты - [POST /api/v1/auth/password/setup](https://aos.edgelab.space/docs/api/auth/auth-password-setup.md): Запросить письмо установки/смены email - [POST /api/v1/auth/password/change](https://aos.edgelab.space/docs/api/auth/auth-password-change.md): Проверить текущий пароль и заменить его - [Профиль, анкета, план](https://aos.edgelab.space/docs/api/profile.md): Профиль студента, тариф, анкета курса и персональный план. - [GET /api/v1/me](https://aos.edgelab.space/docs/api/profile/me.md): Профиль кабинета, тариф, участие, анкета, готовность плана, доступные функции и лимиты - [GET /api/v1/me/avatar](https://aos.edgelab.space/docs/api/profile/me-avatar.md): Собственный аватар, JPEG/WebP - [GET /api/v1/onboarding](https://aos.edgelab.space/docs/api/profile/onboarding-get.md): Прочитать текущую анкету, шаг, выбранный сетап и статус - [PATCH /api/v1/onboarding](https://aos.edgelab.space/docs/api/profile/onboarding-patch.md): Автосохранить шаг и частичное обновление ответов только в статусе draft - [PUT /api/v1/onboarding/setup](https://aos.edgelab.space/docs/api/profile/onboarding-setup.md): Выбрать сетап отдельно от анкеты в любом статусе, не меняя остальные ответы и статус - [POST /api/v1/onboarding/submit](https://aos.edgelab.space/docs/api/profile/onboarding-submit.md): Проверить полноту анкеты и отправить на разбор - [GET /api/v1/plan](https://aos.edgelab.space/docs/api/profile/plan-get.md): Получить состояние персонального плана - [Уроки и эфиры](https://aos.edgelab.space/docs/api/content.md): Разделы курса, уроки, эфиры, транскрипты, рекомендация следующего урока и поиск. - [GET /api/v1/sections](https://aos.edgelab.space/docs/api/content/sections.md): Разделы курса: тип, номер, название и порядок - [GET /api/v1/lessons](https://aos.edgelab.space/docs/api/content/lessons.md): Уроки и эфиры, при необходимости фильтр по разделу и kind - [GET /api/v1/lessons/{id}](https://aos.edgelab.space/docs/api/content/lesson-get.md): Карточка урока/эфира по коду: видео, конспект, таймкоды, промпты, ссылки, задание - [GET /api/v1/lessons/{id}/transcript](https://aos.edgelab.space/docs/api/content/lesson-transcript.md): Полный transcript по коду, segments с началом в секундах - [GET /api/v1/efirs](https://aos.edgelab.space/docs/api/content/efirs.md): Эфиры, расписание и записи - [GET /api/v1/next](https://aos.edgelab.space/docs/api/content/next.md): Рекомендация следующего урока и причина - [GET /api/v1/search](https://aos.edgelab.space/docs/api/content/search.md): Полнотекстовый поиск по транскриптам и таймкодам уроков/эфиров с применением gating - [Прогресс](https://aos.edgelab.space/docs/api/progress.md): Пройденные уроки, позиции видео, домашние задания и отметки шагов плана. - [PUT /api/v1/plan/milestones](https://aos.edgelab.space/docs/api/progress/plan-milestones-put.md): Заменить набор выполненных шагов плана - [GET /api/v1/progress](https://aos.edgelab.space/docs/api/progress/progress-get.md): Пройденные уроки, позиции проигрывателя в секундах, домашние задания и отметки плана - [PUT /api/v1/progress](https://aos.edgelab.space/docs/api/progress/progress-put.md): Сохранить прогресс одного урока: хотя бы одно из positionSec, completed, homework - [Тьютор и диктовка](https://aos.edgelab.space/docs/api/tutor.md): Единый диалог с AI-тьютором, память тьютора и распознавание голоса. Только из кабинета. - [POST /api/v1/transcribe](https://aos.edgelab.space/docs/api/tutor/transcribe.md): Распознать короткую запись, отправив raw audio, не multipart - [GET /api/v1/tutor/messages](https://aos.edgelab.space/docs/api/tutor/tutor-messages.md): История единого диалога - [POST /api/v1/tutor/messages](https://aos.edgelab.space/docs/api/tutor/tutor-send.md): Отправить вопрос тьютору и получить конечный JSON, не SSE - [GET /api/v1/tutor/facts](https://aos.edgelab.space/docs/api/tutor/tutor-facts.md): Факты, которые тьютор помнит о студенте, старые первыми - [DELETE /api/v1/tutor/facts/{id}](https://aos.edgelab.space/docs/api/tutor/tutor-fact-delete.md): Удалить собственный факт из памяти тьютора - [Вложения](https://aos.edgelab.space/docs/api/files.md): Файлы для сообщений тьютору. Только из кабинета. - [POST /api/v1/files](https://aos.edgelab.space/docs/api/files/files-upload.md): Загрузить вложение raw bytes, не multipart: тип сверяется с сигнатурой/UTF-8 - [GET /api/v1/files/{id}](https://aos.edgelab.space/docs/api/files/files-get.md): Скачать собственное вложение - [DELETE /api/v1/files/{id}](https://aos.edgelab.space/docs/api/files/files-delete.md): Удалить только собственную ещё не прикреплённую загрузку - [API-ключи](https://aos.edgelab.space/docs/api/keys.md): Выпуск, ротация и отзыв персональных API-ключей, журнал вызовов. Только из кабинета. - [GET /api/v1/keys](https://aos.edgelab.space/docs/api/keys/keys-list.md): История персональных API-ключей: active первыми, затем новые - [POST /api/v1/keys](https://aos.edgelab.space/docs/api/keys/keys-create.md): Создать персональный API-ключ на 90 дней - [POST /api/v1/keys/{id}/rotate](https://aos.edgelab.space/docs/api/keys/keys-rotate.md): Атомарно отозвать существующий ключ и выдать новый с тем же именем и scopes на 90 дней - [DELETE /api/v1/keys/{id}](https://aos.edgelab.space/docs/api/keys/keys-revoke.md): Отозвать собственный API-ключ - [GET /api/v1/keys/calls](https://aos.edgelab.space/docs/api/keys/keys-calls.md): Последние вызовы REST/MCP: до 20 на ключ и до 100 суммарно, новые первыми - [Личный менторинг](https://aos.edgelab.space/docs/api/mentoring.md): Персональный трек, встречи, решения, задания и чат с ментором. Тарифы «С куратором / Лично с Даши». - [GET /api/v1/mentoring/track](https://aos.edgelab.space/docs/api/mentoring/mentoring-track.md): Текущая опубликованная версия личного трека. - [GET /api/v1/mentoring/track/versions](https://aos.edgelab.space/docs/api/mentoring/mentoring-versions.md): История опубликованных версий личного трека, включая прошлые публикации; черновики скрыты. id элемента – это versionId для чтения версии. - [GET /api/v1/mentoring/sessions](https://aos.edgelab.space/docs/api/mentoring/mentoring-sessions.md): Встречи с ментором. - [GET /api/v1/mentoring/sessions/{sessionId}](https://aos.edgelab.space/docs/api/mentoring/mentoring-session.md): Одна встреча: краткое содержание или очищенный транскрипт. - [GET /api/v1/mentoring/decisions](https://aos.edgelab.space/docs/api/mentoring/mentoring-decisions.md): Решения со встреч. - [GET /api/v1/mentoring/chat/digests](https://aos.edgelab.space/docs/api/mentoring/mentoring-digests.md): Ежедневные сводки чата с ментором. - [GET /api/v1/mentoring/chat/messages](https://aos.edgelab.space/docs/api/mentoring/mentoring-messages.md): Очищенные разрешённые сообщения чата. - [GET /api/v1/mentoring/homework](https://aos.edgelab.space/docs/api/mentoring/mentoring-homework.md): Задания от ментора. - [Служебные](https://aos.edgelab.space/docs/api/ops.md): Проверка работоспособности. - [GET /healthz](https://aos.edgelab.space/docs/api/ops/healthz.md): Проверка работоспособности и SHA установленной версии ## MCP - [MCP-сервер AgentOS](https://aos.edgelab.space/docs/mcp.md): Адрес, транспорт Streamable HTTP, подключение клиентов, OAuth-поток и формат JSON-RPC ответов MCP. - [Инструменты MCP](https://aos.edgelab.space/docs/mcp/tools.md): Все 22 инструментов MCP: scope, тариф, аргументы, ответы и примеры. - [OAuth для MCP](https://aos.edgelab.space/docs/oauth.md): Авторизация MCP-клиентов: discovery, DCR, PKCE S256, согласие, токены, отзыв. ## Справка - [Ошибки](https://aos.edgelab.space/docs/errors.md): Формат ошибок REST, OAuth и MCP, все коды, HTTP-статусы и повторы. - [Лимиты](https://aos.edgelab.space/docs/limits.md): Лимиты запросов на ключ и студента, квоты кабинета, ответ 429 и Retry-After, лимиты каждого эндпоинта. ## Optional - [Схемы](https://aos.edgelab.space/docs/schemas.md): JSON Schema 99 типов публичного API, из openapi.json. - [Изменения](https://aos.edgelab.space/docs/changelog.md): История изменений публичного API и MCP AgentOS. - [OpenAPI 3.1](https://aos.edgelab.space/docs/openapi.json): машиночитаемый контракт публичных REST-операций - [Полная документация](https://aos.edgelab.space/docs/llms-full.txt): все страницы одним markdown-файлом