Skip to main content

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.

Подключение через OAuth

EdgeLab MCP поддерживает OAuth 2.1 для аутентификации. OAuth нужен когда у клиента нет API-ключа или он предпочитает стандартный flow. Claude Code поддерживает оба варианта: и ключ через -H флаг, и OAuth.

Когда нужен OAuth

КлиентAPI-ключOAuth
Claude Code (CLI)+ (через -H флаг)+ (автоматически)
Claude Desktop++
Cursor+
Windsurf+
Свой агент+ (проще)+
API-ключ проще и быстрее — получи в боте @InvestorEdgeLabbot и подключайся. OAuth нужен когда ключа нет или клиент предпочитает стандартный flow.

Как это работает

MCP Client (Claude Code)
    ↓ DCR (Dynamic Client Registration)
    ↓ OAuth 2.1 + PKCE
EdgeLab MCP Server
    ↓ /authorize → redirect
Telegram Auth Page
    ↓ user confirms in bot
Supabase session created

Access granted with tier/scopes
Всё происходит автоматически. Клиент регистрируется через DCR, получает client_id, запускает OAuth flow. Пользователь подтверждает через Telegram — клиент получает токен.

Подключение Claude Code

1

Добавь MCP сервер

# Без ключа -- OAuth flow запустится автоматически:
claude mcp add --transport http edgelab https://mcp.edgelab.su/mcp

# Или с ключом (OAuth не нужен):
claude mcp add --transport http -H "Authorization: Bearer el_live_твой_ключ" edgelab https://mcp.edgelab.su/mcp
Или добавь в конфиг Claude Code (~/.claude/settings.json):
{
  "mcpServers": {
    "edgelab": {
      "type": "streamable-http",
      "url": "https://mcp.edgelab.su/mcp"
    }
  }
}
2

Запусти Claude Code

При первом вызове инструмента EdgeLab, Claude Code автоматически:
  1. Зарегистрирует себя через DCR
  2. Откроет браузер для авторизации
  3. Покажет страницу авторизации через Telegram
3

Подтверди через Telegram

В браузере откроется страница с кнопкой «Открыть Telegram».
  1. Нажми кнопку — откроется бот @InvestorEdgeLabbot
  2. Нажми START (или /start) — бот привяжет твой аккаунт
  3. Страница автоматически определит подтверждение и перенаправит обратно в Claude Code
Весь процесс занимает 10–15 секунд. Никаких паролей, email-подтверждений или форм.
Если у тебя уже есть аккаунт EdgeLab через Telegram — авторизация пройдёт мгновенно. Если нет — бот создаст аккаунт автоматически при первом подтверждении.

Подключение через конфиг

Для клиентов с JSON-конфигурацией MCP:
{
  "mcpServers": {
    "edgelab": {
      "type": "streamable-http",
      "url": "https://mcp.edgelab.su/mcp"
    }
  }
}
Без заголовков — OAuth flow запустится автоматически при первом запросе.

Что получает OAuth-пользователь

После аутентификации MCP сервер определяет tier пользователя из Supabase и открывает соответствующие tools:
TierToolsRate limit
Free1830/min
Edge3960/min
Pro63120/min
VIP63300/min

OAuth + API-ключ

Оба способа работают одновременно. Если у тебя уже есть el_live_ ключ, он продолжит работать через заголовки. OAuth — альтернативный путь для клиентов без поддержки заголовков.

Discovery endpoint

OAuth metadata доступен по стандартному пути:
https://mcp.edgelab.su/.well-known/oauth-authorization-server
Там перечислены все endpoints: authorization, token, registration, scopes.

Поддерживаемые возможности

  • OAuth 2.1 с PKCE (S256)
  • Dynamic Client Registration (DCR) — клиенты регистрируются автоматически
  • Telegram-авторизация — без email и паролей
  • Token rotation — refresh tokens ротируются автоматически
  • Scopes: openid, email, profile, knowledge:read, profile:read, profile:write, progress:write, billing:read и другие

Troubleshooting

Проверь что клиент поддерживает OAuth 2.1. Должен уметь:
  • Читать /.well-known/oauth-authorization-server
  • Выполнять DCR на /register
  • Запускать authorization code flow с PKCE
Убедись что браузер по умолчанию настроен и может открывать ссылки. Claude Code автоматически запускает OAuth flow через системный браузер.
Попробуй нажать /start ещё раз в боте @InvestorEdgeLabbot. Если проблема остаётся — обратись в поддержку через Telegram-канал.
Убедись что подписка активна. Проверь через:
# В Claude Code после подключения
get_my_subscription

Что дальше

API-ключи

Альтернативный способ через API-ключ

Подключение агента

Полный гайд по подключению агента

Безопасность ключей

Хранение и ротация ключей

Обзор tools

Какие MCP tools доступны