sankhya-mcp

MCP local para o Cursor consultar o Sankhya Om. Um servidor, autenticação invisível, credenciais no vault Sankhya – Clientes do 1Password.

Este repositório é o projeto. Na máquina da equipe ele deve viver em:

C:\projetos\sankhya-mcp

O agente que gerou o código não consegue criar pasta no seu C:\. Clone (ou copie) o git para esse caminho.

O que o modelo vê

Não existe tool de login. Default é direct (MobileLoginSP no host da URL do Login). Gateway só se o item tiver mode=gateway e client_id, client_secret, x_token.

Somente SELECT. Default 200 linhas, teto 2000. Notas do 1Password (VPN, RDP, banco) não são lidas.

Related MCP server: Lexiguard HR

Pré-requisitos na máquina

1. Node.js 20+

2. 1Password desktop + CLI (op --version)

3. App: Configurações → Developer → Integrar com 1Password CLI

4. App aberto na bandeja

5. VPN do cliente quando o Om for host interno / *.snk.ativy.com

Conferiu o CLI:

op vault list
op item list --vault tkrys7yhgj64dmo643ovrxa7ie

(O ID evita o traço “bonito” do nome do vault.)

Instalação (Windows)

git clone <url-deste-repo> C:\projetos\sankhya-mcp
cd C:\projetos\sankhya-mcp
npm install
npm run build

No Cursor: Settings → MCP → adicionar o conteúdo de examples/cursor-mcp.json (já aponta para C:\projetos\sankhya-mcp\scripts\sankhya-mcp.cmd).

Reinicie o MCP. Na conversa: “lista os perfis Sankhya” e depois “no cliente Fralia, SELECT CODPROD, DESCRPROD FROM TGFPRO”.

Opcional no env do MCP:

"SANKHYA_DEFAULT_PROFILE": "Fralia"

Se sankhya_list_profiles falhar com spawn op ENOENT, o Prompt acha o op e o processo do MCP não (comum no Windows com winget). No Prompt: where op. Cole o caminho no mcp.json:

"SANKHYA_OP_BIN": "C:\\\\Users\\\\SEU_USUARIO\\\\AppData\\\\Local\\\\Microsoft\\\\WinGet\\\\Links\\\\op.exe"

Não peça ao Agent para reinstalar o CLI nem para listar o cofre via terminal. A tool certa é sankhya_list_profiles.

Item no 1Password (Login)

Desenvolvimento

npm test
npm run typecheck
npm run dev

Documentação de desenho: docs/analise-viabilidade.md.