> ## Documentation Index
> Fetch the complete documentation index at: https://docs.edgelab.su/llms.txt
> Use this file to discover all available pages before exploring further.

# Аутентификация

> API-ключи, OAuth через Telegram, scopes, rate limits и правила доступа к EdgeLab MCP

# Аутентификация

EdgeLab работает через MCP, а не REST. Адрес один: `https://mcp.edgelab.su/mcp`. Авторизация обязательна -- через API-ключ (`el_live_...`) или OAuth 2.1 с подтверждением в Telegram.

## Два способа аутентификации

| Способ                       | Когда использовать                                            |
| ---------------------------- | ------------------------------------------------------------- |
| **API-ключ** (`el_live_...`) | Claude Code (с `-H` флагом), Claude Desktop, Cursor, Windsurf |
| **OAuth 2.1 через Telegram** | Claude Code (без ключа), любой клиент с поддержкой OAuth      |

Оба способа работают одновременно. Без авторизации сервер вернёт `401`.

<Tip>
  Подробнее про OAuth: [Подключение через OAuth](/guides/oauth-connect)
</Tip>

## Как работает доступ

* Авторизация обязательна для всех запросов -- без ключа или OAuth-сессии сервер вернёт `401`
* После авторизации tier пользователя (Free, Edge, Pro, VIP) определяет набор доступных tools
* Ключ передаётся в заголовке `Authorization: Bearer ...` или `x-api-key`
* OAuth 2.1 с PKCE -- авторизация через Telegram-бота, без паролей и email

<Warning>
  Если в старых заметках у тебя встречается `edgelab_live_...`, это устаревший формат. Текущий префикс только `el_live_`.
</Warning>

## Формат ключа

API-ключ выглядит так:

```text theme={null}
el_live_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4
```

Правила:

* Префикс: `el_live_`
* Хвост: `48` hex-символов
* Общая длина: `56` символов

## Где получить ключ

Ключ создаётся через Telegram-бота [@InvestorEdgeLabbot](https://t.me/InvestorEdgeLabbot).

1. Открой бота и нажми **START**
2. Бот создаёт аккаунт и связывает `telegram_id` с профилем
3. Бот отправляет API-ключ
4. Этот ключ используешь в MCP-клиенте или своём агенте

<Note>
  Регистрация и авторизация идут через Telegram. Отдельной веб-регистрации для MCP нет — всё через бота.
</Note>

## OAuth через Telegram

При подключении через OAuth (например, Claude Code):

1. Клиент запускает OAuth flow → открывается браузер
2. На странице — кнопка **«Открыть Telegram»**
3. Нажимаешь → попадаешь в бота → подтверждаешь
4. Страница автоматически перенаправляет обратно → клиент получает токен

Никаких паролей, форм или email-подтверждений. 10–15 секунд.

Подробный гайд: [Подключение через OAuth](/guides/oauth-connect)

## Заголовки авторизации

<CodeGroup>
  ```http Authorization theme={null}
  Authorization: Bearer el_live_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4
  ```

  ```http x-api-key theme={null}
  x-api-key: el_live_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4
  ```
</CodeGroup>

Оба варианта валидны. Обычно удобнее `Authorization: Bearer ...`.

## Scopes по тарифам

| Тариф | Scopes | Что это значит                                                                                                     |
| ----- | -----: | ------------------------------------------------------------------------------------------------------------------ |
| Free  |      1 | Только `knowledge:read` и публичные гайды                                                                          |
| Edge  |     21 | Полный личный контур: профиль, прогресс, points, support, notifications, events, network, contributions, referrals |
| Pro   |     22 | Всё из Edge + предложение событий + use cases + API Use Cases                                                      |
| VIP   |     22 | Всё из Pro + rate limit 300/min + early access                                                                     |

<Accordion title="Полный список scopes по тарифам">
  ### Free

  ```text theme={null}
  knowledge:read
  ```

  ### Edge

  ```text theme={null}
  knowledge:read, knowledge:write, profile:read, profile:write
  progress:read, progress:write, achievements:read, points:read
  billing:read, billing:write, support:read, support:write
  notifications:read, notifications:write, events:read
  network:read, network:write, contributions:read, contributions:write
  referrals:read, referrals:write
  ```

  ### Pro

  ```text theme={null}
  Всё из Edge + events:write (propose_event, list_proposals)
  ```

  ### VIP

  ```text theme={null}
  Те же scopes что Pro + rate limit 300/min + early access
  ```
</Accordion>

## Rate limits

| Тариф |     Лимит |
| ----- | --------: |
| Free  |  `30/min` |
| Edge  |  `60/min` |
| Pro   | `120/min` |
| VIP   | `300/min` |

Если лимит превышен, MCP-сервер вернёт ошибку `rate_limit_exceeded`. Для циклов и cron-процессов добавь backoff и паузы между вызовами.

## Tools по тарифам

### Free (18 tools)

После авторизации (OAuth или ключ) пользователь с Free-тарифом получает:

```text theme={null}
health, search_knowledge, get_knowledge, list_knowledge
list_categories, get_knowledge_children, list_recent_knowledge
get_sections, get_dashboard, get_faq, get_billing_plans
list_events, get_event, get_event_calendar, register
write_review, list_recent_knowledge, get_dashboard
```

### Edge и выше (63 tools)

С подпиской открываются личные и социальные tools: профиль, прогресс, achievements, points, subscriptions, auth, events, network, contributions, support, notifications и admin-инструменты для нужных ролей.

## Практические правила

* Не вставляй ключ в URL
* Не коммить ключ в git
* Для каждого агента лучше держать отдельный ключ
* Если ключ засветился, ротируй или удаляй его через auth tools
* Для Free-доступа достаточно OAuth (ключ не обязателен, но авторизация нужна)