# Устройство платформы

> Публичные адреса, требования к подключению и способы интеграции.

LegalStack — облачная платформа. Для интеграции доступны REST API, MCP-серверы для AI-агентов и вебхуки — все они работают через публичные адреса ниже.

## Публичные адреса

| Адрес | Назначение |
| --- | --- |
| `https://api.legalstack.ru` | REST API (`/api/v1/*`), OAuth 2.0 (`/oauth/*`), метаданные (`/.well-known/*`) |
| `https://mcp.legalstack.ru` | MCP-серверы для AI-агентов |
| `https://app.legalstack.ru` | Веб-приложение |
| `https://docs.legalstack.ru` | Эта документация |
| `https://legalstack.ru` | Сайт |

## Требования к подключению

- Только HTTPS с TLS 1.3. Запросы по HTTP перенаправляются на HTTPS, соединения с TLS 1.2 и ниже отклоняются.
- Поддерживаются HTTP/2 и HTTP/3.
- Авторизация — OAuth 2.0, токен передаётся в заголовке `Authorization: Bearer <токен>`. Как получить токен — в гайде [Аутентификация](https://docs.legalstack.ru/guides/authentication).
- Лимиты частоты запросов — в гайде [Лимиты запросов](https://docs.legalstack.ru/guides/rate-limiting), безопасный повтор изменяющих запросов — в гайде [Идемпотентность](https://docs.legalstack.ru/guides/idempotency).

## Способы интеграции

- **REST API** — [справочник операций](https://docs.legalstack.ru/api). Спецификация OpenAPI 3.1 каждого раздела доступна по адресу `https://docs.legalstack.ru/openapi/<раздел>.json`.
- **MCP-серверы** — [подключение и инструменты](https://docs.legalstack.ru/mcp) для AI-агентов и MCP-клиентов.
- **Вебхуки** — [подписка и проверка подписи](https://docs.legalstack.ru/guides/webhooks), [каталог событий](https://docs.legalstack.ru/webhooks).

## Данные и изоляция

Все данные принадлежат команде. Запросы выполняются в границах команды, к которой относится токен, и с правами пользователя; данные разных команд изолированы на уровне хранилища.