> ## 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.

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

> Практический гайд по подключению агента к EdgeLab через MCP: конфиг, tools, cron-паттерны и уровни доступа

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

Твой агент подключается к MCP-серверу `https://mcp.edgelab.su/mcp`, проходит авторизацию и вызывает tools. REST нет -- только MCP.

## Что понадобится

* MCP-клиент: Claude Code, Claude Desktop, Cursor, Windsurf или свой runtime
* Telegram-бот [@InvestorEdgeLabbot](https://t.me/InvestorEdgeLabbot) — для регистрации и получения ключа
* Ключ `el_live_...` или OAuth через Telegram — для личных tools

## Два пути авторизации

| Путь                     | Для кого                                               | Как работает                                                                          |
| ------------------------ | ------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| **API-ключ**             | Claude Code (с `-H`), Claude Desktop, Cursor, Windsurf | Ключ от [@InvestorEdgeLabbot](https://t.me/InvestorEdgeLabbot) -- в заголовок конфига |
| **OAuth через Telegram** | Claude Code (без ключа)                                | Автоматически при первом запросе. Нужен браузер + Telegram                            |

<Tip>
  Claude Code поддерживает оба варианта. С ключом проще -- не нужен браузер. Без ключа -- OAuth flow запустится автоматически.
</Tip>

## Схема доступа

| Уровень | Tools | Что получает агент                                                                                                         |
| ------- | :---: | -------------------------------------------------------------------------------------------------------------------------- |
| Free    |   18  | Guides, FAQ, поиск, events, register                                                                                       |
| Edge    |   39  | Free + профиль, прогресс, achievements, points, billing, support, notifications, events, network, contributions, referrals |
| Pro     |   63  | Edge + `events:write`, usecases, priority support                                                                          |
| VIP     |   63  | Pro + rate limit 300/min + early access                                                                                    |

Авторизация обязательна для всех уровней. Без ключа или OAuth сервер вернёт `401`.

## Шаг за шагом

<Steps>
  <Step title="Добавь MCP-конфиг">
    <CodeGroup>
      ```bash Claude Code с ключом theme={null}
      claude mcp add --transport http -H "Authorization: Bearer el_live_твой_ключ" edgelab https://mcp.edgelab.su/mcp
      ```

      ```bash Claude Code без ключа (OAuth) theme={null}
      claude mcp add --transport http edgelab https://mcp.edgelab.su/mcp
      ```

      ```json Claude Code (конфиг) theme={null}
      {
        "mcpServers": {
          "edgelab": {
            "type": "streamable-http",
            "url": "https://mcp.edgelab.su/mcp"
          }
        }
      }
      ```

      ```json Claude Desktop (с ключом) theme={null}
      {
        "mcpServers": {
          "edgelab": {
            "url": "https://mcp.edgelab.su/mcp",
            "headers": {
              "Authorization": "Bearer el_live_ваш_ключ"
            }
          }
        }
      }
      ```

      ```json Cursor / Windsurf (с ключом) theme={null}
      {
        "mcpServers": {
          "edgelab": {
            "url": "https://mcp.edgelab.su/mcp",
            "headers": {
              "x-api-key": "el_live_ваш_ключ"
            }
          }
        }
      }
      ```
    </CodeGroup>
  </Step>

  <Step title="Авторизуйся">
    **Claude Code (OAuth через Telegram):**
    При первом вызове tool откроется браузер → страница с кнопкой «Открыть Telegram» → подтверди в боте → готово. [Подробнее](/guides/oauth-connect)

    **Остальные клиенты (API-ключ):**
    Открой [@InvestorEdgeLabbot](https://t.me/InvestorEdgeLabbot) → START → бот выдаст ключ → добавь в конфиг.
  </Step>

  <Step title="Проверь public tools">
    Задачу агенту ставь естественным языком -- MCP-клиент сам выберет tool. Например:

    ```text theme={null}
    Вызови tool health чтобы проверить EdgeLab MCP
    ```

    или:

    ```text theme={null}
    Покажи первые 3 гайда из EdgeLab
    ```

    Под капотом клиент сделает tool call:

    ```json theme={null}
    { "name": "health", "arguments": {} }
    ```

    ```json theme={null}
    {
      "name": "list_knowledge",
      "arguments": { "category": "guide", "page": 1, "per_page": 3 }
    }
    ```

    <Warning>
      MCP tools нельзя вызывать через `curl` или raw HTTP -- получишь `401`. MCP работает только через клиент (Claude Code, Claude Desktop, Cursor, Windsurf). Claude.ai (веб и мобильное приложение) тоже не поддерживает подключение к внешним MCP-серверам.
    </Warning>
  </Step>

  <Step title="Проверь personal tools">
    После авторизации вызови что-то из личного контура:

    ```json theme={null}
    {
      "name": "get_user_profile",
      "arguments": {}
    }
    ```

    Или:

    ```json theme={null}
    {
      "name": "get_dashboard",
      "arguments": {}
    }
    ```
  </Step>
</Steps>

## Полезные группы tools

### Knowledge

```text theme={null}
search_knowledge, get_knowledge, list_knowledge
list_categories, get_knowledge_children
list_recent_knowledge, get_sections
```

### Profile и progress

```text theme={null}
get_user_profile, get_full_profile, update_profile
link_telegram, track_progress, get_progress, get_progress_history
```

### Events

```text theme={null}
list_events, get_event, get_event_calendar
rsvp_event, cancel_rsvp, propose_event, list_proposals
```

### Network

```text theme={null}
list_members, search_members, get_matches
list_connect_requests, send_connect_request, respond_connect_request
```

### Support и notifications

```text theme={null}
create_ticket, list_tickets, get_ticket, send_ticket_message
list_notifications, mark_notification_read, get_unread_count
```

## Рабочий паттерн агента

Обычно flow такой:

1. Агент ищет данные через `list_*` или `search_*`
2. Потом добирает детали через `get_*`
3. После этого делает действие: `rsvp_event`, `update_profile`, `create_ticket`, `submit_contribution`

Это надёжнее, чем пытаться «угадывать» id или контекст.

## Cron и фоновая автоматизация

Если агент работает по расписанию, ориентируйся на MCP tools:

| Частота         | Tool                    | Зачем                                 |
| --------------- | ----------------------- | ------------------------------------- |
| Каждые 10 минут | `get_unread_count`      | Проверить новые уведомления           |
| Каждое утро     | `list_recent_knowledge` | Забрать свежие материалы              |
| Каждое утро     | `list_events`           | Проверить ближайшие события           |
| После урока     | `track_progress`        | Обновить прогресс                     |
| 1–2 раза в день | `get_matches`           | Проверить новые совпадения в нетворке |

## Rate limit и ошибки

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

Если агент получает `rate_limit_exceeded`, добавь backoff и не делай агрессивный polling.

## Что дальше

<CardGroup cols={2}>
  <Card title="Быстрый старт" icon="rocket" href="/quickstart">
    Минимальное MCP-подключение
  </Card>

  <Card title="OAuth через Telegram" icon="paper-plane" href="/guides/oauth-connect">
    Подробный гайд по OAuth-подключению
  </Card>

  <Card title="Аутентификация" icon="key" href="/authentication">
    Формат ключа, scopes и правила доступа
  </Card>

  <Card title="Обзор tools" icon="book" href="/api-reference/introduction">
    Какие MCP tools доступны
  </Card>
</CardGroup>