sbis-mcp-ru
API СБИС (Saby) en el asistente de IA: documentos y etapas del EDI, firma electrónica, certificados, empleados. 45 métodos, la escritura solicita confirmación.
Documentación
sbis-mcp-ru
API СБИС (Saby) para asistentes de IA: documentos y etapas del flujo documental, firma de adjuntos, certificados y MChD, empleados, contrapartes, divisiones.
El catálogo se compiló a partir de la fuente original (ayuda de saby.ru/help/integration/api) y se encuentra en el repositorio como
sbis_mcp/endpoints.yaml: 45 métodos, de los cuales 19 son de lectura,
21 de escritura y 5 irreversibles. El servidor ejecuta exactamente este archivo,
por lo que la tabla siguiente no puede diferir del código.
Instalación
uvx sbis-mcp-ru
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"sbis-mcp": {
"command": "uvx",
"args": ["sbis-mcp-ru"],
"env": { "SBIS_SESSION_ID": "..." }
}
}
}
Claves
El comando Saby.Autenticar con inicio de sesión y contraseña de un empleado con derechos de API devuelve un identificador de sesión. La sesión tiene una duración limitada y se renueva con el mismo comando; la contraseña no se almacena en el servidor.
| variable | secreto | qué es |
|---|---|---|
SBIS_SESSION_ID | sí | Identificador de sesión de Saby (SBIS) del comando Saby.Autenticar. |
Las claves no tienen que estar en el entorno: el servidor admite perfiles y las guarda en
~/.ru-mcp/cabinets.json con permisos 600, fuera del repositorio.
Mapa de métodos
| sección | métodos | lectura | escritura | irreversible |
|---|---|---|---|---|
| Documentos y etapas | 19 | 7 | 8 | 4 |
| Autenticación | 9 | 3 | 6 | 0 |
| Firma electrónica | 4 | 2 | 2 | 0 |
| MChD | 4 | 2 | 1 | 1 |
| Nuestras organizaciones | 3 | 2 | 1 | 0 |
| Comandos de servicio | 3 | 2 | 1 | 0 |
| Empleados | 2 | 0 | 2 | 0 |
| Contrapartes | 1 | 1 | 0 | 0 |
| total | 45 | 19 | 21 | 5 |
Cómo se ve en el chat
Usted: lista de documentos
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", {})
Tres herramientas en lugar de 45 funciones: el agente busca el método con palabras, lee su tarjeta y lo invoca. Las operaciones de escritura e irreversibles piden confirmación.
Lo que suele solicitarse:
- Descargar la lista de documentos del tipo deseado para un período.
- Ver en qué etapa están atascados los documentos salientes.
- Comprobar el estado de los certificados de firma antes de que caduquen.
- Encontrar una contraparte y su identificador de participante de EDI.
Seguridad
El servidor se ejecuta en la máquina del usuario; las claves no salen al exterior. Los métodos tienen tres clases de acceso: la lectura se realiza de inmediato; la escritura y las acciones irreversibles requieren confirmación. El encabezado de autorización no sale de los dominios del servicio ni siquiera al invocar una ruta arbitraria.
Verificar la instalación
uvx sbis-mcp-ru doctor
Imprime cuántos métodos se cargaron, si se encontraron las claves y de dónde. No muestra
secretos. Con --live realiza una llamada real de lectura de bajo costo.
Relacionados
El núcleo está extraído en schema-mcp-core. Servidores vecinos: hh-mcp-ru, vk-mcp-ru, diadoc-mcp-ru, chestny-znak-mcp-ru. Los marketplaces viven por separado: marketplaces-mcp-ru.
MIT. Autor Ilya Utov.
Todos los proyectos en una sola lista, clasificados por propósito: ilyautov.github.io.