Skip to main content
Glama
TOTVS RM Database MCP Server

TOTVS RM Database MCP Server

by mkazimoto

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\

Related MCP server: MCP Platform Service

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides secure, API-key authenticated access to on-premise MSSQL databases, enabling SQL query execution, schema exploration, and stored procedure management through MCP.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A minimal Model Context Protocol (MCP) service for integration with external platforms. Provides CRUD operations, reference data fetching, and authentication capabilities.
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A read-only MCP server exposing TOTVS support tickets (Portal do Cliente) as tools for LLMs in Claude Code, Claude Desktop, and Cursor.
      11
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Read-only MCP connector for querying the Protheus (TOTVS) system, exposing 10 GET endpoints as MCP tools with OAuth2 authentication and friendly error handling.
      10
      MIT