# MCP

> 22 разделов и 212 инструментов платформы LegalStack для AI-агентов

Платформа LegalStack даёт AI-агентам инструменты по протоколу [MCP](https://modelcontextprotocol.io) версии 2026-07-28 через транспорт Streamable HTTP. Агенты внутри платформы получают все разделы, внешние клиенты подключаются к `https://mcp.legalstack.ru/mcp`.

## Подключение

Все инструменты, доступные снаружи, — в одном подключении `https://mcp.legalstack.ru/mcp`. Отдельный раздел — `https://mcp.legalstack.ru/mcp/<раздел>`.

Сервер защищён OAuth 2.1 по спецификации MCP и принимает только токены, привязанные к ключу клиента по DPoP (RFC 9449): в метаданных защищённого ресурса `https://mcp.legalstack.ru/.well-known/oauth-protected-resource/mcp` указано `dpop_bound_access_tokens_required: true`. Без токена сервер отвечает `401` с заголовком `WWW-Authenticate` и адресом этих метаданных. Клиент находит сервер авторизации `https://api.legalstack.ru`, регистрируется через `/oauth/register`, запрашивает scope `mcp:tools:execute` и на каждый запрос подписывает доказательство DPoP с серверным nonce из заголовка `DPoP-Nonce`, см. гайд [Аутентификация](https://docs.legalstack.ru/guides/authentication). Инструменты выполняются от имени вошедшего пользователя и в границах его прав.

Сервер принимает клиентов с протоколом MCP 2026-07-28.

### Мост для клиентов без DPoP

Клиент без поддержки DPoP подключается через мост `legalstack-mcp-bridge`: мост выполняет вход, хранит ключ DPoP и токены и передаёт запросы клиента по stdio. Установка на macOS и Linux:

```sh
curl -fsSL https://docs.legalstack.ru/downloads/mcp-bridge/install.sh | sh
```

Установка на Windows в PowerShell:

```powershell
irm https://docs.legalstack.ru/downloads/mcp-bridge/install.ps1 | iex
```

Установщик выбирает сборку для системы и процессора, сверяет её контрольную сумму из `SHA256SUMS` и кладёт мост в `~/.local/bin`, а на Windows в `%LOCALAPPDATA%\LegalStack\bin` с добавлением папки в PATH. Другую папку задаёт переменная `LEGALSTACK_BIN_DIR`. Сборки и контрольные суммы каждой версии лежат в `https://docs.legalstack.ru/downloads/mcp-bridge/<версия>/`, номер текущей версии — в `https://docs.legalstack.ru/downloads/mcp-bridge/latest.json`.

Вход: `legalstack-mcp-bridge login --url https://mcp.legalstack.ru/mcp`. Ключ DPoP и токены хранятся в файле `~/.legalstack/mcp-bridge.json`, зашифрованном ключом из системного хранилища: Связки ключей macOS, Диспетчера учётных данных Windows или Secret Service в Linux. Если системного хранилища нет, например на сервере без графической сессии, файл хранится незашифрованным с доступом только для владельца, и мост предупреждает об этом при каждом запуске. Выход: `legalstack-mcp-bridge logout`, версия: `legalstack-mcp-bridge --version`.

Подключение моста в клиентах:

- Claude Code: `claude mcp add legalstack -- legalstack-mcp-bridge --url https://mcp.legalstack.ru/mcp`.
- Cursor: в `.cursor/mcp.json` добавьте в `mcpServers` сервер `"legalstack": { "command": "legalstack-mcp-bridge", "args": ["--url", "https://mcp.legalstack.ru/mcp"] }`.
- VS Code: в `.vscode/mcp.json` добавьте в `servers` сервер `"legalstack": { "type": "stdio", "command": "legalstack-mcp-bridge", "args": ["--url", "https://mcp.legalstack.ru/mcp"] }`.
- Codex: в `~/.codex/config.toml` добавьте раздел `[mcp_servers.legalstack]` с `command = "legalstack-mcp-bridge"` и `args = ["--url", "https://mcp.legalstack.ru/mcp"]`.
- Клиент с собственной поддержкой DPoP: транспорт Streamable HTTP, адрес `https://mcp.legalstack.ru/mcp`, авторизация OAuth с динамической регистрацией клиента.
- Удалённые клиенты без DPoP (например, коннекторы в веб-интерфейсах) подключить нельзя: платформа не выдаёт токенов без привязки к клиенту.

## Права на действия

Внешние клиенты подчиняются правам на действия основного агента команды. Действие с режимом «Спрашивать» сервер выполняет только после подтверждения пользователя через запрос клиента; клиент без поддержки таких запросов это действие не выполнит. Действие с режимом «Запрещено» не выполняется.

## Разделы

| Раздел | Инструментов | Доступно снаружи |
| --- | --- | --- |
| [Согласования](https://docs.legalstack.ru/mcp/approvals) | 9 | все |
| [Автоматизации](https://docs.legalstack.ru/mcp/automation) | 12 | 11 из 12 |
| [Калькуляторы](https://docs.legalstack.ru/mcp/calculator) | 4 | все |
| [Календарь](https://docs.legalstack.ru/mcp/calendar) | 7 | все |
| [Облачные хранилища](https://docs.legalstack.ru/mcp/cloud) | 6 | 4 из 6 |
| [Проверка документов](https://docs.legalstack.ru/mcp/compliance) | 3 | все |
| [Подключения](https://docs.legalstack.ru/mcp/connections) | 1 | все |
| [Документы](https://docs.legalstack.ru/mcp/documents) | 27 | 26 из 27 |
| [Файлы](https://docs.legalstack.ru/mcp/files) | 5 | нет |
| [Формы](https://docs.legalstack.ru/mcp/interfaces) | 8 | все |
| [Базы знаний](https://docs.legalstack.ru/mcp/knowledge) | 16 | все |
| [Почта](https://docs.legalstack.ru/mcp/mail) | 5 | 4 из 5 |
| [МойСклад](https://docs.legalstack.ru/mcp/moysklad) | 9 | 8 из 9 |
| [Навигация](https://docs.legalstack.ru/mcp/navigation) | 1 | все |
| [1С](https://docs.legalstack.ru/mcp/onec) | 13 | все |
| [Реестры](https://docs.legalstack.ru/mcp/registry) | 30 | 29 из 30 |
| [СБИС](https://docs.legalstack.ru/mcp/saby) | 16 | 13 из 16 |
| [Задания агента](https://docs.legalstack.ru/mcp/schedules) | 6 | нет |
| [Подписание](https://docs.legalstack.ru/mcp/signatures) | 7 | все |
| [Задачи](https://docs.legalstack.ru/mcp/tasks) | 16 | 9 из 16 |
| [Команда](https://docs.legalstack.ru/mcp/team) | 6 | все |
| [Telegram](https://docs.legalstack.ru/mcp/telegram) | 5 | 4 из 5 |

Инструменты рабочей папки агента и служебные инструменты доступны только агентам внутри платформы.