TOTVS RM Database MCP Server — Windows Service

Instala e gerencia o TOTVS RM Database MCP Server como um serviço Windows, garantindo que ele seja iniciado automaticamente junto com o sistema operacional.

---

Pré-requisitos

Requisito	Versão mínima
Node.js	18+ (testado com v24)
Sistema Operacional	Windows 10 / Server 2019+
Permissão	Administrador

O servidor MCP deve estar presente em:

C:\MCP\totvs-rm-database-mcp-server\

---

Instalação das dependências

cd c:\GIT\ExtrairRAG-BancoDados-WindowsService
npm install

---

Instalar o serviço

Execute o terminal como Administrador.

node install-service.js

O serviço será registrado no Windows com as seguintes configurações:

Propriedade	Valor
Nome	TotvsRmDatabaseMcpServer
Descrição	MCP Server HTTP para banco de dados TOTVS RM
Endpoint	http://localhost:3000/mcp
Inicialização	Automática
Variável PORT	3000
Variável MCP_API_KEY	xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

---

Remover o serviço

Execute o terminal como Administrador.

node uninstall-service.js

---

Gerenciar o serviço manualmente

# Verificar status
Get-Service -Name TotvsRmDatabaseMcpServer

# Iniciar
Start-Service -Name TotvsRmDatabaseMcpServer

# Parar
Stop-Service -Name TotvsRmDatabaseMcpServer

# Reiniciar
Restart-Service -Name TotvsRmDatabaseMcpServer

---

Logs

Os logs do serviço são gerados pelo node-windows na pasta:

C:\MCP\totvs-rm-database-mcp-server\daemon\

Arquivos gerados:

• TotvsRmDatabaseMcpServer.log — saída padrão (stdout)
• TotvsRmDatabaseMcpServer_error.log — erros (stderr)

---

Estrutura do projeto

ExtrairRAG-BancoDados-WindowsService\
├── install-service.js      # Registra e inicia o serviço Windows
├── uninstall-service.js    # Remove o serviço Windows
├── package.json
└── node_modules\
    └── node-windows\       # Biblioteca de integração com o SCM do Windows

---

Autenticação no MCP Server

O servidor exige um Bearer token em todas as requisições ao endpoint /mcp:

Para alterar a chave, edite o arquivo .env em C:\MCP\totvs-rm-database-mcp-server\.env e reinicie o serviço.