СБИС (Saby) MCP (RU) — документы, подпись, ЭДО
API СБИС (Saby) в ИИ-ассистенте: документы, этапы ЭДО, подпись, сертификаты
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
sbis-mcp-ruclaude mcp add saby-mcp-ru -e 'SBIS_SESSION_ID=<your sbis_session_id>' -- uvx sbis-mcp-ru==0.3.0
{
"mcpServers": {
"saby-mcp-ru": {
"command": "uvx",
"args": [
"sbis-mcp-ru==0.3.0"
],
"env": {
"SBIS_SESSION_ID": "<your sbis_session_id>"
}
}
}
}
متغيرات البيئة
SBIS_SESSION_IDسري Идентификатор сессии Saby (СБИС) от команды СБИС.Аутентифицировать.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
sbis-mcp-ru
API СБИС (Saby) для ИИ-ассистентов: документы и этапы документооборота, подписание вложений, сертификаты и МЧД, сотрудники, контрагенты, подразделения.
Каталог собран из первоисточника (справка saby.ru/help/integration/api) и лежит в репозитории как
sbis_mcp/endpoints.yaml: 45 методов, из них 19 на чтение,
21 на запись и 5 необратимых. Сервер исполняет ровно этот файл,
поэтому таблица ниже не может разойтись с кодом.
Установка
Два пути, выбирайте по тому, есть ли у вас терминал.
Без терминала: файл .mcpb
Скачайте sbis-mcp-ru-vX.Y.Z.mcpb со страницы релизов
и откройте двойным щелчком. Claude Desktop поставит сервер сам и спросит ключи
в отдельном окне, в конфиг лезть не придётся. Нужен Python 3.10 или новее:
зависимости сервер доставит себе при первом запуске.
В терминале
uvx sbis-mcp-ru
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"sbis-mcp": {
"command": "uvx",
"args": ["sbis-mcp-ru"],
"env": { "SBIS_SESSION_ID": "..." }
}
}
}
Ключи
Команда СБИС.Аутентифицировать по логину и паролю сотрудника с правами на API возвращает идентификатор сессии. Сессия живёт ограниченное время и обновляется той же командой, пароль в сервере не хранится.
| переменная | секрет | что это |
|---|---|---|
SBIS_SESSION_ID | да | Идентификатор сессии Saby (СБИС) от команды СБИС.Аутентифицировать. |
Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в
~/.ru-mcp/cabinets.json с правами 600, вне репозитория.
Карта методов
| раздел | методов | чтение | запись | необратимое |
|---|---|---|---|---|
| Документы и этапы | 19 | 7 | 8 | 4 |
| Аутентификация | 9 | 3 | 6 | 0 |
| Электронная подпись | 4 | 2 | 2 | 0 |
| МЧД | 4 | 2 | 1 | 1 |
| Наши организации | 3 | 2 | 1 | 0 |
| Сервисные команды | 3 | 2 | 1 | 0 |
| Сотрудники | 2 | 0 | 2 | 0 |
| Контрагенты | 1 | 1 | 0 | 0 |
| всего | 45 | 19 | 21 | 5 |
Как это выглядит в чате
Вы: список документов
sbis_search_methods("список документов")
sbis_spisok_dokumentov POST /service/ чтение
sbis_spisok_dokumentov_po_sobytiyam POST /service/ чтение
sbis_spisok_izmeneniy POST /service/ чтение
sbis_describe_method("sbis_spisok_dokumentov")
Возвращает список документов указанного типа
POST online.sbis.ru/service/
параметры: {"jsonrpc":"2.0","method":"СБИС.СписокДокументов","params":{},"id":0}
класс доступа: чтение
sbis_call_method("sbis_spisok_dokumentov", {})
Три инструмента вместо 45 функций: агент ищет метод словами, читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.
Что обычно просят:
- Выгрузить список документов нужного типа за период.
- Посмотреть, на каком этапе застряли исходящие документы.
- Проверить статус сертификатов подписи до того, как они истекут.
- Найти контрагента и его идентификатор участника ЭДО.
Безопасность
Сервер работает на машине пользователя, ключи наружу не уходят. У методов три класса доступа: чтение идёт сразу, запись и необратимые действия требуют подтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове произвольного пути.
Проверить установку
uvx sbis-mcp-ru doctor
Печатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не
показывает. С --live делает один дешёвый реальный вызов на чтение.
Родня
Ядро вынесено в schema-mcp-core. Соседние серверы: vk-mcp-ru, diadoc-mcp-ru, chestny-znak-mcp-ru. Маркетплейсы живут отдельно: marketplaces-mcp-ru.
MIT. Автор Илья Утов.
Все проекты одним списком, разобранные по назначению: ilyautov.github.io.
Privacy Policy
sbis-mcp-ru не собирает и не передаёт ваши данные: ключи лежат локально в
~/.ru-mcp/cabinets.json, запросы идут только в API СБИС (Saby), телеметрии нет.
Полный текст: PRIVACY_POLICY.md.
الأسئلة الشائعة
ما هو СБИС (Saby) MCP (RU) — документы, подпись, ЭДО؟
API СБИС (Saby) в ИИ-ассистенте: документы, этапы ЭДО, подпись, сертификаты
كيف أثبّت СБИС (Saby) MCP (RU) — документы, подпись, ЭДО؟
يعمل على جهازك. في Claude Code: claude mcp add saby-mcp-ru -e 'SBIS_SESSION_ID=<your sbis_session_id>' -- uvx sbis-mcp-ru==0.3.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج СБИС (Saby) MCP (RU) — документы, подпись, ЭДО إلى مفتاح API؟
نعم. يتطلب SBIS_SESSION_ID، وتضبطها في إعداداته.
هل СБИС (Saby) MCP (RU) — документы, подпись, ЭДО مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون СБИС (Saby) MCP (RU) — документы, подпись, ЭДО؟
ينشره ilyautov. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.