MCP-сервер СБИС: документы, этапы и контрагенты Saby для агента

ilyautov/sbis-mcp-ru· Проверено 12.11.2026· 6на GitHub

Подключает агента к API СБИС (Saby): документы и этапы документооборота, подписание вложений, сертификаты и МЧД, контрагенты, сотрудники. Запись и необратимые действия идут только после подтверждения.

2 реализации:

45 методов API СБИС за тремя инструментами: агент ищет метод словами, читает его карточку и вызывает; 19 методов на чтение, 21 на запись, 5 необратимых.

Как подключить

Что сделать до подключения

Менеджер пакетов uv с командой uvx; для Claude Desktop без терминала — файл .mcpb со страницы релизов и Python 3.10 или новее

Учётная запись сотрудника с правами на API СБИС

SBIS_SESSION_ID

Идентификатор сессии из команды СБИС.Аутентифицировать по логину и паролю сотрудника с правами на API; сессия живёт ограниченное время и обновляется той же командой

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SBIS_SESSION_ID=<идентификатор сессии Saby>' --transport stdio sbis \
  -- uvx sbis-mcp-ru

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.sbis]
command = "uvx"
args = ["sbis-mcp-ru"]

[mcp_servers.sbis.env]
SBIS_SESSION_ID = "<идентификатор сессии Saby>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "sbis": {
      "command": "uvx",
      "args": ["sbis-mcp-ru"],
      "env": {
        "SBIS_SESSION_ID": "<идентификатор сессии Saby>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "sbis": {
      "type": "stdio",
      "command": "uvx",
      "args": ["sbis-mcp-ru"],
      "env": {
        "SBIS_SESSION_ID": "<идентификатор сессии Saby>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "sbis": {
      "command": "uvx",
      "args": ["sbis-mcp-ru"],
      "env": {
        "SBIS_SESSION_ID": "<идентификатор сессии Saby>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "sbis": {
      "command": "uvx",
      "args": ["sbis-mcp-ru"],
      "env": {
        "SBIS_SESSION_ID": "<идентификатор сессии Saby>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "sbis": {
        "type": "local",
        "command": ["uvx", "sbis-mcp-ru"],
        "environment": {
          "SBIS_SESSION_ID": "<идентификатор сессии Saby>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "sbis": {
      "command": "uvx",
      "args": ["sbis-mcp-ru"],
      "env": {
        "SBIS_SESSION_ID": "<идентификатор сессии Saby>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "sbis": {
      "command": "uvx",
      "args": ["sbis-mcp-ru"],
      "env": {
        "SBIS_SESSION_ID": "<идентификатор сессии Saby>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

sbis_search_methodsищет метод API словами

sbis_describe_methodпоказывает карточку метода

sbis_call_methodвызывает метод СБИС

Сервер на Node.js только для чтения: документы, события, контрагенты и вложения ЭДО по логину и паролю Saby; запись обещана в версии 0.2.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Свой аккаунт Saby с доступом к API; для тестового стенда SBIS_BASE_URL=https://fix-online.sbis.ru

SBIS_LOGIN

Логин и пароль (SBIS_PASSWORD) вашего аккаунта Saby с доступом к API; можно вместо переменных положить их в ~/.sbis-mcp/config.json

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'SBIS_LOGIN=<логин Saby>' --env 'SBIS_PASSWORD=<пароль Saby>' --env SBIS_BASE_URL=https://online.sbis.ru --transport stdio sbis-mcp \
  -- npx -y sbis-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.sbis-mcp]
command = "npx"
args = ["-y", "sbis-mcp"]

[mcp_servers.sbis-mcp.env]
SBIS_LOGIN = "<логин Saby>"
SBIS_PASSWORD = "<пароль Saby>"
SBIS_BASE_URL = "https://online.sbis.ru"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "sbis-mcp": {
      "command": "npx",
      "args": ["-y", "sbis-mcp"],
      "env": {
        "SBIS_LOGIN": "<логин Saby>",
        "SBIS_PASSWORD": "<пароль Saby>",
        "SBIS_BASE_URL": "https://online.sbis.ru"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "sbis-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "sbis-mcp"],
      "env": {
        "SBIS_LOGIN": "<логин Saby>",
        "SBIS_PASSWORD": "<пароль Saby>",
        "SBIS_BASE_URL": "https://online.sbis.ru"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "sbis-mcp": {
      "command": "npx",
      "args": ["-y", "sbis-mcp"],
      "env": {
        "SBIS_LOGIN": "<логин Saby>",
        "SBIS_PASSWORD": "<пароль Saby>",
        "SBIS_BASE_URL": "https://online.sbis.ru"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "sbis-mcp": {
      "command": "npx",
      "args": ["-y", "sbis-mcp"],
      "env": {
        "SBIS_LOGIN": "<логин Saby>",
        "SBIS_PASSWORD": "<пароль Saby>",
        "SBIS_BASE_URL": "https://online.sbis.ru"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "sbis-mcp": {
        "type": "local",
        "command": ["npx", "-y", "sbis-mcp"],
        "environment": {
          "SBIS_LOGIN": "<логин Saby>",
          "SBIS_PASSWORD": "<пароль Saby>",
          "SBIS_BASE_URL": "https://online.sbis.ru"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "sbis-mcp": {
      "command": "npx",
      "args": ["-y", "sbis-mcp"],
      "env": {
        "SBIS_LOGIN": "<логин Saby>",
        "SBIS_PASSWORD": "<пароль Saby>",
        "SBIS_BASE_URL": "https://online.sbis.ru"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "sbis-mcp": {
      "command": "npx",
      "args": ["-y", "sbis-mcp"],
      "env": {
        "SBIS_LOGIN": "<логин Saby>",
        "SBIS_PASSWORD": "<пароль Saby>",
        "SBIS_BASE_URL": "https://online.sbis.ru"
      }
    }
  }
}

Инструменты сервера

sbis_configпоказывает настройки

sbis_current_userчитает текущего пользователя

sbis_list_documentsперечисляет документы

sbis_list_documents_by_eventищет документы по событиям

sbis_read_documentчитает документ

sbis_list_counterpartiesперечисляет контрагентов

sbis_get_attachmentскачивает вложение

Что попросить агента

«Выгрузи список входящих документов за <период>»Агент вызовет sbis_search_methods("список документов"), sbis_describe_method и sbis_call_method с методом sbis_spisok_dokumentov

«Посмотри, на каком этапе застряли исходящие документы»Агент найдёт методы документов и этапов через sbis_search_methods и вызовет их через sbis_call_method

«Проверь, какие сертификаты подписи скоро истекают»Агент найдёт метод сертификатов через sbis_search_methods и вызовет его через sbis_call_method

«Найди контрагента <ИНН или название> и его идентификатор участника ЭДО»Агент найдёт метод контрагентов через sbis_search_methods и вызовет его через sbis_call_method

«Открой документ <номер> и скачай вложения»sbis-mcp: агент вызовет sbis_read_document и sbis_get_attachment

Для каких задач

Выгрузить список документов нужного типа за период

Посмотреть, на каком этапе застряли исходящие документы

Проверить сертификаты подписи до того, как они истекут

Найти контрагента и его идентификатор участника ЭДО

Прочитать документ и скачать вложения

Ограничения

Оба проекта новые и почти без звёзд: у sbis-mcp-ru 6, у sbis-mcp 0; sbis-mcp прямо пишет, что не связан с ООО «Тензор»

sbis-mcp в версии 0.1 только читает: подпись КЭП и запись документов в нём выключены

Сессия СБИС живёт ограниченное время, у sbis-mcp — около 21 дня, потом её нужно получить заново

Ограничения API Saby: не больше 300 вызовов авторизации в минуту с одного IP, вложение до 73 МБ и до 10 вложений на документ

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
sbis-mcp-ru	Илья Утов	6	локально	токен	3	5 октября 2026
sbis-mcp	pyrfor	0	локально	токен	7	7 августа 2026

Частые вопросы

Почему в sbis-mcp-ru всего три инструмента?

Вместо 45 функций агент вызывает sbis_search_methods, находит метод словами, читает его карточку через sbis_describe_method и вызывает sbis_call_method. Так схемы всех методов не занимают контекст.

Агент может подписать или отправить документ без меня?

В sbis-mcp-ru методы на чтение выполняются сразу, а запись и необратимые действия требуют подтверждения. В sbis-mcp запись выключена флагом writable, по умолчанию false.

Где хранятся ключи?

sbis-mcp-ru хранит кабинеты в ~/.ru-mcp/cabinets.json с правами 600 и не собирает телеметрию. Пароль в сервере не хранится, только идентификатор сессии.

Как проверить, что всё настроено?

Выполните uvx sbis-mcp-ru doctor: команда покажет, сколько методов загрузилось и найдены ли ключи, без вывода секретов. С флагом --live она сделает один дешёвый вызов на чтение.

Как подключить СБИС MCP к Claude Desktop?

Проще всего скачать sbis-mcp-ru-vX.Y.Z.mcpb со страницы релизов и открыть двойным щелчком: Claude Desktop поставит сервер и спросит ключ в отдельном окне. Вручную пропишите в claude_desktop_config.json команду uvx sbis-mcp-ru и переменную SBIS_SESSION_ID.

Есть ли MCP-сервер СБИС от Тензора?

Оба сервера в карточке сделаны сторонними разработчиками и работают через открытый API Saby со справки saby.ru/help/integration/api. sbis-mcp прямо пишет, что с ООО «Тензор» не связан.

Работает ли сервер из России?

СБИС — российский сервис, серверы работают на вашем компьютере и обращаются только к API Saby.

MCP-сервер СБИС: документы, этапы и контрагенты Saby для агента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Какую реализацию выбрать

Частые вопросы

Похожие серверы