personaleasy-mcp-server

PersonalEasy API | EasyDental Cloud | DentalKids용 MCP 서버입니다.

도구

모든 도구는 읽기 전용입니다(readOnlyHint: true).

Related MCP server: open-dental-mcp

설치

npm install
npm run build

자격 증명

자격 증명은 절대 코드에 저장되지 않습니다. 환경 변수를 통해 구성하세요:

• PERSONALEASY_API_KEY — API 키 (헤더 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을 Easypanel 서비스의 MCP_AUTH_TOKEN 변수에 설정된 값으로 바꾸세요.

중요: 서비스에 MCP_AUTH_TOKEN이 설정되어 있지 않으면, 해당 URL을 아는 사람은 누구나 진료소 데이터를 조회할 수 있습니다. 프로덕션에서 변수가 설정되어 있는지 확인하세요.

하위 API

모든 호출은 단일 RPC 엔드포인트로 전송됩니다:

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

사용되는 메서드: RPCGetAgendamentos, RPCGetKPIPrd, RPCGetPrestadorCPF, RPCGetUnidadeAtendimento.