sbis-mcp-ru 是面向 AI 助手的 СБИС(Saby)API MCP 服务器,将 СБИС 集成能力以工具形式提供给 AI 助手使用。仓库说明其命令目录来自官方来源(saby.ru/help/integration/api),并以 sbis_mcp/endpoints.yaml 形式保存在仓库中,服务器严格按该文件执行,共 45 个方法,其中 19 个读取、21 个写入、5 个不可逆操作,因此能力表不会与代码脱节。
主要能力覆盖文档和文档流转阶段、附件签名、证书与机器可读授权书(МЧД)、员工、往来单位、部门等。
使用方式提供两种路径。无终端用户可下载 sbis-mcp-ru-vX.Y.Z.mcpb 发布文件并双击打开,Claude Desktop 会自动安装服务器并在单独窗口询问密钥,无需修改配置;需要 Python 3.10 或更新版本,依赖在首次启动时由服务器自动安装。也可通过 Claude Desktop 的 claude_desktop_config.json 配置。认证方面,СБИС.Аутентифицировать 命令使用具有 API 权限的员工登录名和密码返回会话标识,会话有有效期限,可通过同一命令刷新,服务器不保存密码。密钥可不放在环境变量中,服务器支持将配置柜保存到 ~/.ru-mcp/cabinets.json,权限 600,位于仓库之外。
在对话中,用户可用自然语言如“列表文档”触发,服务器以三个工具替代 45 个函数:代理用词语搜索方法、读取其说明卡片并调用。写入和不可逆操作会请求确认。常见用途包括:按期间导出指定类型的文档列表;查看发出的文档卡在哪个阶段;在签名证书过期前检查其状态;查找往来单位及其电子文档交换参与者标识。
安全与隐私方面,服务器在用户机器上运行,密钥不外传;方法分三类访问权限,读取立即执行,写入和不可逆操作需确认;即使调用任意路径,授权头也不会离开服务域。服务器不收集或传输用户数据,密钥本地存放于 ~/.ru-mcp/cabinets.json,请求仅发往 СБИС(Saby)API,无遥测,完整说明见 PRIVACY_POLICY.md。
提供安装校验命令,可打印加载的方法数量、是否找到密钥及来源,不显示机密;加 --live 会执行一次廉价的真实读取调用。核心已抽离为 schema-mcp-core。同系列服务器包括 vk-mcp-ru、diadoc-mcp-ru、chestny-znak-mcp-ru,市场平台类为 marketplaces-mcp-ru。项目采用 MIT 许可,作者为 Илья Утов。