personaleasy-mcp-server

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

Herramientas

Todas las herramientas son de solo lectura (readOnlyHint: true).

Related MCP server: open-dental-mcp

Instalación

npm install
npm run build

Credenciales

Las credenciales nunca están en el código. Configúrelas mediante variables de entorno:

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

• PERSONALEASY_CLIENT_ID — el ID del cliente

• PERSONALEASY_BASE_URL — opcional, por defecto https://prsrb.onrender.com/v1/rpc

Para pruebas locales, copie .env.example a .env y complételo. El .env está en .gitignore — no lo versiones ni lo compartas.

Configuración en 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

Configuración en Claude Desktop

En 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"
      }
    }
  }
}

Despliegue en Easypanel (Docker)

El proyecto tiene dos modos de ejecución:

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

• HTTP (dist/http.js) — uso remoto; es el modo usado por el Dockerfile

En Easypanel, cree un servicio del tipo App apuntando a este repositorio (build mediante Dockerfile) y configure las variables de entorno:

Exponga el puerto 3000 en el servicio. Endpoints:

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

• GET /health — healthcheck

Instancia en producción

• 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 un cliente MCP a esta instancia:

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

Reemplace SEU_MCP_AUTH_TOKEN por el valor configurado en la variable MCP_AUTH_TOKEN del servicio en Easypanel.

Importante: sin MCP_AUTH_TOKEN configurado en el servicio, cualquier persona con esa URL puede consultar los datos de la clínica. Confirme que la variable está definida en producción.

API subyacente

Todas las llamadas van a un único endpoint RPC:

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

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