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）へのデプロイ

このプロジェクトには 2 つの実行モードがあります：

• stdio（dist/index.js）— ローカル使用（Claude Code / Claude Desktop）

• HTTP（dist/http.js）— リモート使用。これは Dockerfile で使用されるモードです

Easypanel で、このリポジトリを指す App タイプのサービスを作成し（Dockerfile 経由でビルド）、環境変数を設定してください：

サービスでポート 3000 を公開してください。エンドポイント：

• POST /mcp — MCP エンドポイント（Streamable HTTP、ステートレス）

• 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。