personaleasy-mcp-server

MCP-Server für die PersonalEasy API | EasyDental Cloud | DentalKids.

Tools

Alle Tools sind schreibgeschützt (readOnlyHint: true).

Related MCP server: open-dental-mcp

Installation

npm install
npm run build

Anmeldedaten

Die Anmeldedaten befinden sich niemals im Code. Konfigurieren Sie sie über Umgebungsvariablen:

• PERSONALEASY_API_KEY — der API-Schlüssel (Header x-api-key)

• PERSONALEASY_CLIENT_ID — die Kunden-ID

• PERSONALEASY_BASE_URL — optional, Standard https://prsrb.onrender.com/v1/rpc

Kopieren Sie für lokale Tests .env.example nach .env und füllen Sie es aus. Die .env-Datei befindet sich in .gitignore – versionieren oder teilen Sie sie nicht.

Konfiguration in 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

Konfiguration in Claude Desktop

In 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 auf Easypanel (Docker)

Das Projekt hat zwei Ausführungsmodi:

• stdio (dist/index.js) — lokale Nutzung (Claude Code / Claude Desktop)

• HTTP (dist/http.js) — Fernzugriff; dies ist der vom Dockerfile verwendete Modus

Erstellen Sie auf Easypanel einen Dienst vom Typ App, der auf dieses Repository verweist (Build über Dockerfile), und konfigurieren Sie die Umgebungsvariablen:

Machen Sie Port 3000 im Dienst verfügbar. Endpunkte:

• POST /mcp — MCP-Endpunkt (Streamable HTTP, zustandslos)

• GET /health — Healthcheck

Produktionsinstanz

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

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

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

Um einen MCP-Client mit dieser Instanz zu verbinden:

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

Ersetzen Sie SEU_MCP_AUTH_TOKEN durch den Wert, der in der Variablen MCP_AUTH_TOKEN des Dienstes auf Easypanel konfiguriert wurde.

Wichtig: Ohne einen konfigurierten MCP_AUTH_TOKEN im Dienst kann jeder mit dieser URL die Daten der Klinik abfragen. Stellen Sie sicher, dass die Variable in der Produktion definiert ist.

Zugrundeliegende API

Alle Aufrufe erfolgen an einen einzigen RPC-Endpunkt:

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

Verwendete Methoden: RPCGetAgendamentos, RPCGetKPIPrd, RPCGetPrestadorCPF, RPCGetUnidadeAtendimento.