personaleasy-mcp-server

Сервер MCP для API PersonalEasy | EasyDental Cloud | DentalKids.

Инструменты

Все инструменты только для чтения (readOnlyHint: true).

Related MCP server: open-dental-mcp

Установка

npm install
npm run build

Учетные данные

Учетные данные никогда не хранятся в коде. Настройте через переменные окружения:

• PERSONALEASY_API_KEY — api-key (заголовок x-api-key)

• PERSONALEASY_CLIENT_ID — ID клиента

• PERSONALEASY_BASE_URL — опционально, по умолчанию https://prsrb.onrender.com/v1/rpc

Для локального тестирования скопируйте .env.example в .env и заполните. Файл .env находится в .gitignore — не версионируйте и не распространяйте его.

Настройка в 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

Настройка в Claude Desktop

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

Развертывание на Easypanel (Docker)

Проект имеет два режима выполнения:

• stdio (dist/index.js) — локальное использование (Claude Code / Claude Desktop)

• HTTP (dist/http.js) — удаленное использование; это режим, используемый Dockerfile

На Easypanel создайте сервис типа App, указывающий на этот репозиторий (сборка через Dockerfile), и настройте переменные окружения:

Откройте порт 3000 в сервисе. Конечные точки:

• POST /mcp — конечная точка MCP (Streamable HTTP, stateless)

• GET /health — проверка работоспособности

Экземпляр в продакшене

• Базовый URL: https://dk-projetos-mcps.nv8gf3.easypanel.host

• Проверка работоспособности: GET https://dk-projetos-mcps.nv8gf3.easypanel.host/health → {"status":"ok"}

• Конечная точка MCP: POST https://dk-projetos-mcps.nv8gf3.easypanel.host/mcp

Для подключения MCP-клиента к этому экземпляру:

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

Замените SEU_MCP_AUTH_TOKEN на значение, настроенное в переменной MCP_AUTH_TOKEN сервиса на Easypanel.

Важно: без настроенного MCP_AUTH_TOKEN в сервисе любой человек с этим URL сможет запрашивать данные клиники. Убедитесь, что переменная определена в продакшене.

Базовая API

Все вызовы направляются на единую конечную точку RPC:

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

Используемые методы: RPCGetAgendamentos, RPCGetKPIPrd, RPCGetPrestadorCPF, RPCGetUnidadeAtendimento.