personaleasy-mcp-server

Servidor MCP para a API PersonalEasy | EasyDental Cloud | DentalKids.

Tools

Todas as tools são somente leitura (readOnlyHint: true).

Related MCP server: open-dental-mcp

Instalação

npm install
npm run build

Credenciais

As credenciais nunca ficam no código. Configure via variáveis de ambiente:

• PERSONALEASY_API_KEY — a api-key (header x-api-key)

• PERSONALEASY_CLIENT_ID — o ID do cliente

• PERSONALEASY_BASE_URL — opcional, padrão https://prsrb.onrender.com/v1/rpc

Para testes locais, copie .env.example para .env e preencha. O .env está no .gitignore — não o versione nem o compartilhe.

Configuração no Claude Code

claude mcp add personaleasy --env PERSONALEASY_API_KEY=SUA_KEY --env PERSONALEASY_CLIENT_ID=SEU_CLIENT_ID -- node D:/MCPS/personaleasy-mcp-server/dist/index.js

Configuração no Claude Desktop

Em claude_desktop_config.json:

{
  "mcpServers": {
    "personaleasy": {
      "command": "node",
      "args": ["D:/MCPS/personaleasy-mcp-server/dist/index.js"],
      "env": {
        "PERSONALEASY_API_KEY": "SUA_KEY",
        "PERSONALEASY_CLIENT_ID": "SEU_CLIENT_ID"
      }
    }
  }
}

Deploy no Easypanel (Docker)

O projeto tem dois modos de execução:

• stdio (dist/index.js) — uso local (Claude Code / Claude Desktop)

• HTTP (dist/http.js) — uso remoto; é o modo usado pelo Dockerfile

No Easypanel, crie um serviço do tipo App apontando para este repositório (build via Dockerfile) e configure as variáveis de ambiente:

Exponha a porta 3000 no serviço. Endpoints:

• POST /mcp — endpoint MCP (Streamable HTTP, stateless)

• GET /health — healthcheck

Instância em produção

• URL base: https://dk-projetos-mcps.nv8gf3.easypanel.host

• Healthcheck: GET https://dk-projetos-mcps.nv8gf3.easypanel.host/health → {"status":"ok"}

• Endpoint MCP: POST https://dk-projetos-mcps.nv8gf3.easypanel.host/mcp

Para conectar um cliente MCP a essa instância:

claude mcp add --transport http personaleasy https://dk-projetos-mcps.nv8gf3.easypanel.host/mcp --header "Authorization: Bearer SEU_MCP_AUTH_TOKEN"

Substitua SEU_MCP_AUTH_TOKEN pelo valor configurado na variável MCP_AUTH_TOKEN do serviço no Easypanel.

Importante: sem MCP_AUTH_TOKEN configurado no serviço, qualquer pessoa com essa URL consegue consultar os dados da clínica. Confirme que a variável está definida em produção.

API subjacente

Todas as chamadas vão para um único endpoint RPC:

POST {BASE_URL}
Headers: x-api-key
Body: { "clientId": "...", "method": "RPCGet...", "params": { ... } }

Métodos usados: RPCGetAgendamentos, RPCGetKPIPrd, RPCGetPrestadorCPF, RPCGetUnidadeAtendimento.