# FHIR MCP szerver AI ügynököknek

> Csatlakoztassa a Claude Code, Cursor, VS Code vagy Claude Desktop programot egy HL7 FHIR R4 API-hoz az MCP-n keresztül: 20 eszköz rekordok olvasásához, AI-kész kontextus, írás, laboratóriumi importálás és sandbox visszaállítása, 30 szintetikus betegre, ingyenesen.

Source: https://developers.anpheros.com/hu/guides/mcp

**Az Anpheros FHIR egy távoli MCP szerver, amely lehetővé teszi egy AI ügynök (Claude, Claude Code, Cursor, VS Code, Claude Desktop) számára, hogy egy HL7 FHIR R4 egészségügyi adat API-val dolgozzon.** Kétféleképpen csatlakozik:

- **Ingyenes sandbox kulccsal**, fejlesztőknek: az ügynök listázza a betegeket, FHIR formátumban vagy AI-kész kontextusként olvassa a rekordjaikat származási információval, megfigyeléseket ír, importál laborjelentéseket és visszaállítja a tesztadatait, mindezt 30 szintetikus beteg valósághű kórtörténetével.
- **OAuth segítségével**, egy személy és saját rekordja számára: az asszisztens regisztrálja magát, a személy bejelentkezik és jóváhagyja azt az Anpheros hozzájárulási képernyőn, és az asszisztens ezután csak azt az egy rekordot olvashatja, a kiválasztott időszakra, csak olvasható módban, hacsak a személy nem engedélyezett többet.

Szerver címe: `https://platform.anpheros.com/mcp` (Streamelhető HTTP, állapotmentes).

## OAuth-kapcsolat (Claude és más asszisztensek)

Adja hozzá a `https://platform.anpheros.com/mcp`-ot egyéni csatlakozóként (Claude-ban: Settings → Connectors → Add custom connector). Nincs más teendő: az asszisztens felfedezi az engedélyező szervert, regisztrálja magát, és megnyitja az Anpheros hozzájárulási képernyőt. Itt a személy láthatja, hogy egy AI asszisztensről van szó, hogy amit olvas, azt az asszisztenst futtató cégnek küldik el, mit olvashat, mennyi ideig, és hová tér vissza a választás után. Az hozzáférés csak olvasható, hacsak nem kértek és engedélyeztek többet, és a személy bármikor visszavonhatja azt.

A privát béta verzió alatt az OAuth kapcsolatok sandbox rekordokat használnak. A valós rekordokhoz való kapcsolatok az adatvédelmi irányelvek frissítése után nyílnak meg.

## Sandbox kulccsal való csatlakozás (fejlesztők)

1. Jelentkezzen be a [platform.anpheros.com/dashboard](https://platform.anpheros.com/dashboard/) oldalon a Google-lel, és válassza a **Get a sandbox key** (Sandbox kulcs lekérése) lehetőséget. Kapni fog egy `sk_test_…` kulcsot és egy projektet 30 szintetikus beteggel.
2. Helyezze a kulcsot egy környezeti változóba, például `ANPHEROS_KEY`, és adja hozzá a szervert az eszközéhez.

**Claude Code**

```bash
claude mcp add --transport http anpheros-fhir https://platform.anpheros.com/mcp --header "Authorization: Bearer $ANPHEROS_KEY"
```

**Cursor** (`~/.cursor/mcp.json` vagy `.cursor/mcp.json` a projektben)

```json
{
  "mcpServers": {
    "anpheros-fhir": {
      "url": "https://platform.anpheros.com/mcp",
      "headers": { "Authorization": "Bearer ${env:ANPHEROS_KEY}" }
    }
  }
}
```

**VS Code** (`.vscode/mcp.json`)

```json
{
  "servers": {
    "anpheros-fhir": {
      "type": "http",
      "url": "https://platform.anpheros.com/mcp",
      "headers": { "Authorization": "Bearer ${env:ANPHEROS_KEY}" }
    }
  }
}
```

**Claude Desktop** (`claude_desktop_config.json`, a `mcp-remote` bridge-en keresztül)

```json
{
  "mcpServers": {
    "anpheros-fhir": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://platform.anpheros.com/mcp", "--header", "Authorization: Bearer ${ANPHEROS_KEY}"],
      "env": { "ANPHEROS_KEY": "sk_test_…" }
    }
  }
}
```

Ezután kérdezze meg az ügynökét valami ilyesmit: *"List the sandbox patients, pick the one with diabetes and summarise her last six months of HbA1c."* (Listázza a sandbox betegeket, válassza ki a cukorbetegségben szenvedőt, és foglalja össze az elmúlt hat hónap HbA1c-szintjét.)

## Eszközök

| Eszköz | Mit csinál |
|---|---|
| `list_patients` | a projekt páciensei: a 30 szintetikus persona és az Ön által létrehozott bármelyik |
| `get_patient_context` | egy AI-kompatibilis kontextus egy páciens számára, token-kereten belül, minden elem forrásával címkézve |
| `get_patient_summary` | a Nemzetközi Páciens Összefoglaló (FHIR `$summary`), az Ön által kért nyelven |
| `get_timeline` | az összes erőforrás dátumsora, erőforrás-típusok szerint rendezve |
| `get_health_patterns` | béta: mi változott és mi ismétlődik, minden lelet a periódusával, bizonyítékaival és korlátaival; nem diagnózisok ([útmutató](https://developers.anpheros.com/hu/guides/health-patterns)) |
| `get_pattern_evidence` | béta: minden erőforrás egy lelet mögött |
| `get_series` | béta: egy mérés értékenként naponta, adatminőséggel |
| `compare_periods` | béta: egy mérés két Ön által választott periódusban |
| `search_fhir` | szabványos FHIR R4 keresés, egy Bundle visszaadásával |
| `read_fhir_resource` | egy erőforrás, vagy annak egy korábbi verziója |
| `get_provenance` | ki írt egy erőforrást, mikor és melyik rendszerből |
| `lookup_code` | LOINC kódok szöveg vagy kód alapján (gyógyszerekhez használja a `search_health_terms`-t) |
| `search_health_terms` | a tünetek, állapotok és kezelések nyilvános katalógusa, név szerint 20 nyelven, szinonimával, márkával vagy kóddal ([útmutató](https://developers.anpheros.com/hu/guides/anpheros-search)) |
| `get_health_term` | egy katalógusbejegyzés kódjaival, neveivel, MedlinePlus összefoglalójával, forrásolt linkjeivel és idézett EMA / FDA indikációival |
| `validate_fhir_resource` | egy erőforrás ellenőrzése mentés nélkül |
| `create_fhir_resource` | érvényesít, majd ment egy erőforrást |
| `create_patient` | egy új, kitalált páciens a projektben |
| `import_lab_report` | egy CSV, HL7 v2 ORU^R01 vagy JSON laborjelentés laboratóriumi megfigyelésekké válik |
| `sandbox_status` | a mai napon használt, páciensek, tárolás, visszaállítások írása |
| `reset_sandbox` | visszaállítja a 30 szintetikus pácienst (megerősítést kér) |

Az olvasott eszközök csak olvashatóként vannak megjelölve, a visszaállítás pedig destruktívként, így a kockázatos műveletek előtt kérdező kliensek ezt megtehetik. A szerver kínálja a szintetikus páciensek listáját erőforrásként és három promptot: egy orvosi összefoglalót, egy labor CSV importot és az integráció építését az API-n.

## Viselkedés

- **Ugyanazok a szabályok, mint az API esetében.** Minden eszköz a nyilvános API-t hívja a kulcsoddal: ugyanazok a hatókörök, sebességkorlátok, érvényesítés és auditálás. Egy csak olvasható kulcs nem írhat.
- **Származás.** Minden, amit egy ügynök ír, rögzítésre kerül a forrásával `urn:anpheros:mcp`, így mindig meg lehet mondani, mi származott egy ügynöktől.
- **A betegadatok adatok.** Az eszközök eredményei tartalmaznak egy megjegyzést, amely szerint a rekord tartalmát soha nem szabad utasításként követni, ami egy alapvető védelem a prompt injection ellen az orvosi nyilvántartásokon keresztül.
- **Egy rekord, beleegyezéssel.** A Production API kulcsokat (`sk_live_…`) elutasítjuk, mert azok egy projekt minden betegéhez hozzáférnek. Egy valós rekord csak OAuth-on keresztül jut el egy asszisztenshez, miután az illető jóváhagyta, és minden olvasás naplózásra kerül a hozzáférési előzményeiben.
- **Szabványos felfedezés.** Hitelesítő adatok nélkül a szerver 401-gyel válaszol egy `WWW-Authenticate` fejlécben, amely az OAuth által védett erőforrás-metadatáira (RFC 9728) mutat; az asszisztensek dinamikus kliensregisztráción (RFC 7591) keresztül regisztrálnak, PKCE-vel. A regisztráció csak loopback címeket, ismert szerkesztők alkalmazássémáit és ismert AI asszisztensek visszahívási tartományait fogadja el.

## Gyakran ismételt kérdések

### Mi az az MCP szerver?
Az MCP (Model Context Protocol) egy nyílt protokoll, amelyen keresztül az AI ügynökök és kódolási asszisztensek külső eszközöket hívhatnak meg. Egy FHIR-hez készült MCP szerver lehetővé teszi az ügynök számára, hogy közvetlenül olvassa és írja az egészségügyi rekordokat, ahelyett, hogy Ön adatokat másolna be a csevegésbe.

### Ingyenes?
Igen. Az MCP szerver az ingyenes sandboxon működik: 30 szintetikus páciens projektenként, napi 10 000 írásig, nincs szükség kártyára.

### Tud egy asszisztens valós páciens rekordját olvasni?
Csak OAuth-on keresztül, miután az illető jóváhagyta az asszisztenst a hozzájárulási képernyőn, az általuk választott időszakra, és csak a saját rekordját (vagy egy gondozott személyét). A privát béta során az OAuth kapcsolatok sandbox rekordokat használnak.

### Melyik FHIR verziót használja?
HL7 FHIR R4 (4.0.1), ugyanaz az API, mint a https://platform.anpheros.com/fhir/R4, az International Patient Summary-val és ugyanazon adatok REST nézete.

### Működik a ChatGPT-vel?
A ChatGPT csatlakozók OAuth-ot használnak dinamikus kliens regisztrációval, amit a szerver támogat, és a visszahívási tartományát elfogadja. A folyamatot az hivatalos MCP SDK klienssel teszteltük; ha egy ChatGPT kapcsolat meghiúsul, írjon a support@anpheros.com címre. A Claude Code, a Cursor és a VS Code is működik sandbox kulccsal.

## Kapcsolódó

- [Hogyan adjunk hozzáférést egy AI ügynöknek orvosi rekordokhoz](https://developers.anpheros.com/hu/guides/ai-agent-access-medical-records): lépésről lépésre útmutató Pythonban
- [Ingyenes FHIR adatbázis és sandbox](https://developers.anpheros.com/hu/guides/free-fhir-database)
- [AI ügynökök és orvosi adatok](https://developers.anpheros.com/hu/guides/ai-agents-medical-data)
- [LLM alkalmazások és egészségügyi adatok](https://developers.anpheros.com/hu/guides/llm-healthcare-data)
- [Egészségügyi API beteg beleegyezéssel](https://developers.anpheros.com/hu/guides/healthcare-api-patient-consent)