simplepractice-mcp

MCP-сервер для SimplePractice Client Portal — сторона, в которую входят клиенты практики, а не сторона клинициста. Записи, выставление счетов, документы и объявления, читаемые через собственный JSON:API портала.

Разработано и поддерживается ИИ (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 из ссылки, которую прислал ваш провайдер.

Вход

В Client Portal нет пароля. SimplePractice отправляет одноразовую ссылку (или 6-значный PIN-код); вы обмениваете её на сессионный cookie:

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 плюс сессионный cookie, и аутентифицированное чтение с этой новой сессией.

Поскольку для этого процесса нужны только HTTP и ваш почтовый ящик, этот сервер не зависит от браузера и может работать где угодно.

Без сервера

skills/simplepractice-fpx выполняет те же чтения с помощью curl, либо входя по magic-ссылке, либо извлекая сессионный cookie из вкладки браузера с помощью fpx.

Заметки о создании

Портал — это Ember-приложение, которое поставляет публичные sourcemaps, поэтому его модели, адаптеры и маршруты можно читать напрямую — docs/SIMPLEPRACTICE-API.md фиксирует конечные точки и ловушки, всё подтверждено на живом портале:

• SPA catch-all отвечает HTTP 200 с text/html для любого пути, который не определён API. /cards и /client-billing-overviews выглядят как работающие пустые конечные точки, но на самом деле это не конечные точки — обе являются include-отношениями /clients/<id>.

• hasDocumentPdf, isDefault карты и блоб permissions клиента — все строки, а не логические значения или объекты.

• Счета страницами по курсору (page[before] = cursorId строки), записи — по номеру. Они не взаимозаменяемы.

Разработка

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