simplepractice-mcp

SimplePractice クライアントポータル 用の MCP サーバー — これは、プラクティスのクライアントがログインする側であり、臨床医側ではありません。予約、請求、書類、お知らせを、ポータル独自の JSON:API 経由で読み取ります。

AI（Claude Code）によって開発・保守されています。自己責任でご利用ください。

読み取れるもの

すべて読み取り専用です。キャンセル、署名、支払いはポータルで行います。

Related MCP server: practice-fusion-mcp

セットアップ

npm install -g simplepractice-mcp
export SIMPLEPRACTICE_PRACTICE=achievebalancetherapy   # or the full host

SIMPLEPRACTICE_PRACTICE はプラクティスのポータルアドレスです — プロバイダーからメールで送られたリンクのスラッグまたは <practice>.clientsecure.me ホスト全体です。

サインイン

クライアントポータルにはパスワードがありません。SimplePractice はワンタイムリンク（または6桁のPIN）をメールで送信します。それをセッションクッキーと交換します：

1. simplepractice_request_sign_in_link { email, confirm: true }

2. メールを開き、リンクをコピーします。

3. simplepractice_verify_sign_in_token { link } — リンク全体を渡します。トークンはその # フラグメントであり、ツールが抽出します。

リンクは一度きりです — 再利用すると 401 "Authorization has already been used or expired" が返されます — 有効期限は24時間です。リクエストエンドポイントはアドレスごとおよび IPごとにレート制限されているため、送信は確認ゲート付きです：再試行ループは唯一の入り口をロックアウトします。リフレッシュトークンはありません。セッションが切れたら、再度サインインします。

チェーン全体はライブポータルに対してエンドツーエンドで検証されています — リクエスト、メールで送られたリンク、verified とセッションクッキーを返す交換、そしてその新しいセッションでの認証済み読み取りです。

このフローはHTTPと受信トレイだけで済むため、このサーバーにはブラウザ依存がなく、どこでも実行できます。

サーバーなしで

skills/simplepractice-fpx は curl で同じ読み取りを行います。マジックリンクでサインインするか、fpx でブラウザタブからセッションクッキーを取得します。

構築時のメモ

ポータルは公開ソースマップを配信する Ember アプリであるため、そのモデル、アダプター、ルートは直接読み取れます — docs/SIMPLEPRACTICE-API.md にはエンドポイントと落とし穴が記録されており、すべてライブポータルで確認済みです：

• SPA のキャッチオールは、API が定義していない任意のパスに対して HTTP 200 と text/html を返します。/cards と /client-billing-overviews は動作する空のエンドポイントのように見えますが、実際にはエンドポイントではありません — どちらも /clients/<id> の include リレーションシップです。

• hasDocumentPdf、カードの isDefault、クライアントの permissions ブロブはすべて文字列であり、ブール値やオブジェクトではありません。

• 請求はカーソルでページングされ（page[before] = 行の cursorId）、予約は番号でページングされます。この2つは互換性がありません。

開発

npm install
npm run build
npm test              # 151 tests
npm run test:coverage # 100% enforced
npm run typecheck     # vitest does not run tsc — this does

ライセンス

MIT