health-skillz MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

OAuth-based authentication against any FHIR-compliant provider
Read-only by default — no prescribing or charting
Supports all major US hospital portals (Epic MyChart, Cerner, Athena)
Parses clinical codes (LOINC, RxNorm, SNOMED) back to human language
Open-source — you see exactly what's queried

라이브 데모

실제 사용 모습

health-skillz-skill.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "health-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "health-skillz-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jmandel/health-skillz",
        "~/.claude/skills/health-skillz"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "health-skillz-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jmandel/health-skillz",
          "~/.claude/skills/health-skillz"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add health-skillz-skill -- git clone https://github.com/jmandel/health-skillz ~/.claude/skills/health-skillz

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: health-skillz

Ask plain questions about your lab result trends

👤 Patients tracking chronic conditions, cholesterol, A1c ⏱ ~15 min beginner

언제 쓸까: You've had repeated labs over months/years and want to see the trajectory, not just each result in isolation.

사전 조건

A patient portal with FHIR access — Most major US health systems support SMART on FHIR — check your portal for API/app access
Skill installed — git clone https://github.com/jmandel/health-skillz ~/.claude/skills/health-skillz

흐름

Authenticate

Use health-skillz to connect to my Epic MyChart account.✓ 복사됨

→ Browser opens SMART launch; token stored locally
Pull labs

Show my LDL, HDL, and A1c over the past 3 years as a trend.✓ 복사됨

→ Time-series table or summary with unit conversions
Contextualize

Relate these to the guideline ranges. Don't give me medical advice — just surface what's in range vs not.✓ 복사됨

→ Explicit framing as reference ranges, not diagnosis

결과: A readable longitudinal view of your key labs — useful before your next appointment.

함정

Treating Claude's output as medical advice — Always bring questions to your actual clinician. This skill is for understanding your own records, not a second opinion.

Reconcile the medication list before an appointment

👤 Patients on multiple meds from multiple providers ⏱ ~10 min beginner

언제 쓸까: You're about to see a new specialist and want a clean, current med list.

흐름

Fetch active meds

Use health-skillz. Pull my current medication list with dose, frequency, and prescribing provider.✓ 복사됨

→ Structured list with RxNorm codes resolved to names
Spot duplicates and gaps

Any duplicate therapy, same-class redundancies, or meds that look expired?✓ 복사됨

→ Flags you can raise with your doctor

결과: A med list to hand your new provider on day one.

함정

Portals sometimes miss OTC meds — Supplement manually; the portal only shows what was prescribed via it

Export a relevant subset of records for a new specialist

👤 Patients changing providers or seeing a specialist ⏱ ~20 min intermediate

언제 쓸까: You're consolidating records for a second opinion.

흐름

Filter

Use health-skillz. Pull all cardiology-related encounters, labs, and imaging from the last 2 years.✓ 복사됨

→ Filtered export grouped by encounter
Format

Format as a one-page summary a specialist can skim in 30 seconds.✓ 복사됨

→ Compact doc with key dates, diagnoses, pertinent findings

결과: A portable summary you own — not a 200-page PDF dump.

함정

Losing nuance by summarizing — Always bring the full export as backup; summary is for quick triage

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

health-skillz-skill + filesystem

Save exports to an organized local folder structure

Save the cardiology export to ~/health/specialists/cardio-2026.md✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
smart_launch	provider URL	First-time connection to a provider	OAuth redirect
get_observations	patient id, category, date range	Pulling labs or vitals	FHIR API call
get_medications	patient id, status	Med reconciliation	FHIR API call
get_encounters	patient id, date range	Visit history review	FHIR API call

비용 및 제한

운영 비용

API 쿼터: Depends on the provider's FHIR API limits
호출당 토큰: Moderate — lab results are compact
금액: Free (portal access is included with care)
팁: Pull in one category at a time; full 'everything' exports are token-expensive.

보안

권한, 시크릿, 파급범위

최소 스코프: patient/*.read

자격 증명 저장: OAuth token in local credential store; never committed

데이터 외부 송신: Your FHIR server and Anthropic API only

절대 부여 금지: user/*.write system/*.*

This is NOT medical advice. The skill surfaces your own records; decisions remain with you and your clinicians.
Health data is sensitive. Understand that by querying via Claude, excerpts of your records are sent to Anthropic's API per their data policies.
Revoke the app's access from your patient portal when you're done.

문제 해결

자주 발생하는 오류와 해결

SMART launch fails with redirect error

Most portals require pre-registering the app's redirect URI. Check the skill's docs for your provider.

Empty results despite having data in portal

Your provider may restrict FHIR scopes; try narrower queries or contact support.

Lab codes show as raw LOINC IDs

Ensure the skill's code map is current; may need to update the clone.

확인: cd ~/.claude/skills/health-skillz && git pull

대안

health-skillz 다른 것과 비교

대안	언제 쓰나	단점/장점
Manual portal export	One-time export of all records	PDF dump, not queryable
Apple Health app	iOS-centric consumer aggregation	Closed data; no LLM querying

health-skillz