O problema
Pergunte a um agente de IA como uma rubrica de folha é calculada no Senior, qual tabela guarda o histórico de cargos ou que função LSP lê um campo de tela. Sem fonte, ele responde com confiança — e erra: inventa nome de tabela, mistura versões, descreve uma regra que não existe.
O conhecimento certo existe. Está na documentação oficial, no portal do desenvolvedor, na base de suporte e no fórum de produtos. Só não está ao alcance do agente na hora em que ele precisa.
O que é
O senior-mcp é um servidor MCP (Model Context Protocol) que transforma esse conhecimento em ferramentas que o agente chama sozinho. Hoje ele cobre o Senior Sistemas, um dos maiores fornecedores de HCM/ERP do Brasil.
As ferramentas se agrupam assim:
- Busca com fonte —
senior_searchresponde em linguagem natural, com filtros por fonte, produto, módulo e versão;senior_get_chunkdevolve o trecho completo;senior_catalogesenior_statsmostram o que está indexado. - Regras LSP — referência da linguagem de regras do Senior, exemplos e templates; validação e formatação de uma regra antes de ela ir para o cliente.
- Dicionário de dados — estrutura exata das tabelas do Senior HCM e busca por campo ou descrição de negócio, para o agente montar SQL sem inventar coluna.
- Mapa de telas — localiza uma tela do sistema pelo nome, pelo código ou pela descrição de negócio.
- Relatórios — templates de SQL e de envelope SOAP para relatórios do Senior HCM.
- Contexto e validação de resposta — monta um pacote de evidências antes da resposta e confere as citações contra ele depois.
Como funciona
Cada consulta passa por uma busca híbrida, numa base PostgreSQL com pgvector:
- Vetor (75%) — similaridade semântica sobre embeddings: acha o trecho certo mesmo com outras palavras.
- Palavra-chave (25%) — casamento por termo: acha o nome exato de tabela, campo ou função que o embedding perde.
- Fonte — cada resultado volta com citação (título, origem e link), para o agente mostrar de onde tirou a resposta.
Rerank opcional. Existe uma camada de rerank com a Voyage AI, ligada por configuração. Numa avaliação interna (abr/2026, versão 2.1, 50 consultas geradas automaticamente), ela subiu o MRR@10 — a métrica que mede se o resultado certo aparece no topo — de 71,0% para 76,4% (+5,4 pp). Ainda não está ligada no serviço em uso: antes, quero repetir a avaliação na versão atual.
O acesso exige token, e o token fica no servidor. Nenhum segredo vai para o cliente nem para o navegador.
Uso real
Uso o senior-mcp com o Claude Code (e com o Codex) no trabalho de consultoria: escrever e revisar regras LSP, montar SQL sobre as tabelas do Senior, desenhar integrações. Antes de escrever código, o agente consulta a documentação e a referência da linguagem — e responde com o trecho que sustenta a resposta.
A consulta vira parte do fluxo do agente, não uma aba de documentação aberta ao lado.
Roadmap — em expansão
O Senior foi o primeiro sistema porque é onde está a minha experiência. O próximo passo é a camada que vale para qualquer sistema de RH e folha no Brasil:
- eSocial e FGTS — obrigações de folha e de recolhimento.
- CLT e convenções coletivas — a regra trabalhista que todo cálculo de folha precisa respeitar.
- Outros sistemas de RH/ERP — o mesmo padrão de indexação, para outras bases de conhecimento.
- Conector no Claude Marketplace — instalação direta para quem já usa Claude.
Nada desta lista está indexado hoje. Quando entrar, o número entra junto, com a fonte.
Status
| Estado | Escopo |
|---|---|
| Em uso | Conhecimento público do Senior Sistemas (documentação oficial, portal do desenvolvedor, suporte, fórum) · busca híbrida com fonte · ferramentas de regras LSP, dicionário de dados, telas e relatórios · acesso por token |
| Opcional | Rerank Voyage AI: +5,4 pp em MRR@10 na avaliação interna de abr/2026; nova avaliação antes de ligar no serviço |
| Em expansão | eSocial, FGTS, CLT, convenções coletivas · outros sistemas de RH/ERP · conector no Claude Marketplace |
Acesso de avaliação sob pedido. Quer testar o senior-mcp com o seu agente? Escreva para guilherme@gbbragadev.com e eu libero um token de avaliação.
Meu papel
Concepção da indexação híbrida, camada de rerank e avaliação de retrieval, integração PostgreSQL/pgvector, design do contrato MCP e operação do serviço.
O senior-mcp é uma infraestrutura independente, sem vínculo com o Senior Sistemas. Marcas citadas pertencem aos seus titulares.