sbis-mcp-ru

sbis-mcp-ru

API СБИС (Saby) para assistentes de IA: documentos e etapas do fluxo de documentos, assinatura de anexos, certificados e MChD, funcionários, contrapartes, unidades organizacionais.

O catálogo foi compilado a partir da fonte original (ajuda do saby.ru/help/integration/api) e está no repositório como sbis_mcp/endpoints.yaml: 45 métodos, sendo 19 de leitura, 21 de escrita e 5 irreversíveis. O servidor executa exatamente esse arquivo, portanto a tabela abaixo não pode divergir do código.

Instalação

Dois caminhos, escolha conforme você tenha ou não um terminal.

Sem terminal: arquivo .mcpb

Baixe o sbis-mcp-ru-vX.Y.Z.mcpb na página de releases e abra com um duplo clique. O Claude Desktop instalará o servidor sozinho e solicitará as chaves em uma janela separada, sem precisar mexer na configuração. É necessário Python 3.10 ou superior: o servidor instalará as dependências por conta própria no primeiro início.

No terminal

uvx sbis-mcp-ru

Claude Desktop, claude_desktop_config.json:

{
  "mcpServers": {
    "sbis-mcp": {
      "command": "uvx",
      "args": ["sbis-mcp-ru"],
      "env": { "SBIS_SESSION_ID": "..." }
    }
  }
}

Chaves

O comando Saby.Autenticar com login e senha de um funcionário com direitos de API retorna um identificador de sessão. A sessão tem duração limitada e é renovada pelo mesmo comando; a senha não é armazenada no servidor.

variável	segredo	o que é
SBIS_SESSION_ID	sim	Identificador de sessão Saby (SBIS) do comando Saby.Autenticar.

As chaves não precisam ficar no ambiente: o servidor suporta cofres e as armazena em ~/.ru-mcp/cabinets.json com permissões 600, fora do repositório.

Mapa de métodos

seção	métodos	leitura	escrita	irreversível
Documentos e etapas	19	7	8	4
Autenticação	9	3	6	0
Assinatura eletrônica	4	2	2	0
MChD	4	2	1	1
Nossas organizações	3	2	1	0
Comandos de serviço	3	2	1	0
Funcionários	2	0	2	0
Contrapartes	1	1	0	0
total	45	19	21	5

Como fica no chat

Você: 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", {})

Três ferramentas em vez de 45 funções: o agente busca o método por palavras, lê o cartão dele e o executa. Escrita e ações irreversíveis pedem confirmação.

O que costumam pedir:

• Exportar a lista de documentos do tipo desejado em um período.
• Ver em qual etapa os documentos de saída estão travados.
• Verificar o status dos certificados de assinatura antes que expirem.
• Encontrar uma contraparte e o identificador de participante de EDI dela.

Segurança

O servidor roda na máquina do usuário; as chaves não saem para fora. Os métodos têm três classes de acesso: leitura é imediata, escrita e ações irreversíveis exigem confirmação. O cabeçalho de autorização não sai dos domínios do serviço, mesmo ao chamar um caminho arbitrário.

Verificar instalação

uvx sbis-mcp-ru doctor

Imprime quantos métodos foram carregados, se as chaves foram encontradas e de onde. Segredos não são exibidos. Com --live faz uma chamada real barata de leitura.

Relacionados

O núcleo foi extraído para schema-mcp-core. Servidores vizinhos: hh-mcp-ru, vk-mcp-ru, diadoc-mcp-ru, chestny-znak-mcp-ru. Os marketplaces ficam separados: marketplaces-mcp-ru.

MIT. Autor Ilya Utov.

Todos os projetos em uma lista, organizados por finalidade: ilyautov.github.io.

Política de Privacidade

sbis-mcp-ru não coleta nem transmite seus dados: as chaves ficam localmente em ~/.ru-mcp/cabinets.json, as requisições vão apenas para a API Saby (SBIS), não há telemetria. Texto completo: PRIVACY_POLICY.md.