# FHIR MCP server pre AI agentov

> Pripojte Claude Code, Cursor, VS Code alebo Claude Desktop k HL7 FHIR R4 API cez MCP: 20 nástrojov na čítanie záznamov, kontext pripravený pre AI, písanie, import laboratórnych výsledkov a reset sandboxu, na 30 syntetických pacientoch, zadarmo.

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

**Anpheros FHIR je vzdialený MCP server, ktorý umožňuje AI agentovi (Claude, Claude Code, Cursor, VS Code, Claude Desktop) pracovať s HL7 FHIR R4 API pre zdravotnícke dáta.** Pripojenie prebieha dvoma spôsobmi:

- **S bezplatným kľúčom do sandboxu**, pre vývojárov: váš agent vypíše pacientov, prečíta ich záznamy vo formáte FHIR alebo ako kontext pripravený pre AI s pôvodom dát, zapíše pozorovania, importuje laboratórne správy a resetuje svoje testovacie dáta, všetko na 30 syntetických pacientoch s realistickou anamnézou.
- **S OAuth**, pre osobu a jej vlastný záznam: asistent sa zaregistruje, osoba sa prihlási a schváli ho na obrazovke súhlasu Anpheros, a asistent potom môže čítať tento jeden záznam, po zvolené obdobie, iba na čítanie, pokiaľ osoba nepovolila viac.

Adresa servera: `https://platform.anpheros.com/mcp` (Streamovateľné HTTP, bezstavové).

## Pripojenie cez OAuth (Claude a iní asistenti)

Pridajte `https://platform.anpheros.com/mcp` ako vlastný konektor (v Claude: Nastavenia → Konektory → Pridať vlastný konektor). Nič iné nie je potrebné konfigurovať: asistent objaví autorizačný server, zaregistruje sa a otvorí obrazovku súhlasu Anpheros. Tam osoba vidí, že ide o AI asistenta, že to, čo číta, sa posiela spoločnosti, ktorá asistenta prevádzkuje, čo môže čítať, na ako dlho a kam sa vráti po výbere. Prístup je iba na čítanie, pokiaľ nebolo požiadané o viac a povolené, a osoba ho môže kedykoľvek odvolať.

Počas súkromnej beta verzie OAuth pripojenia používajú sandbox záznamy. Pripojenia k reálnym záznamom sa otvoria po aktualizácii zásad ochrany osobných údajov.

## Pripojenie pomocou sandbox kľúča (vývojári)

1. Prihláste sa na [platform.anpheros.com/dashboard](https://platform.anpheros.com/dashboard/) pomocou Google a vyberte **Získať sandbox kľúč**. Dostanete `sk_test_…` kľúč a projekt s 30 syntetickými pacientmi.
2. Vložte kľúč do environmentálnej premennej, napríklad `ANPHEROS_KEY`, a pridajte server do vášho nástroja.

**Claude Code**

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

**Cursor** (`~/.cursor/mcp.json` alebo `.cursor/mcp.json` v projekte)

```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`, cez `mcp-remote` bridge)

```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_…" }
    }
  }
}
```

Potom sa svojho agenta opýtajte niečo ako: *"Vymenuj sandbox pacientov, vyber toho s cukrovkou a zhrň jej HbA1c za posledných šesť mesiacov."*

## Nástroje

| Nástroj | Čo robí |
|---|---|
| `list_patients` | pacienti projektu: 30 syntetických person a všetci, ktorých ste vytvorili |
| `get_patient_context` | kontext pripravený pre AI pre jedného pacienta, v rámci limitu tokenov, každá položka označená zdrojom |
| `get_patient_summary` | International Patient Summary (FHIR `$summary`), v jazyku, ktorý si želáte |
| `get_timeline` | záznam v chronologickom poradí podľa dátumu naprieč typmi zdrojov |
| `get_health_patterns` | beta: čo sa zmenilo a čo sa opakuje, každé zistenie s jeho obdobím, dôkazmi a obmedzeniami; nie diagnózy ([návod](https://developers.anpheros.com/sk/guides/health-patterns)) |
| `get_pattern_evidence` | beta: každý zdroj za jedným zistením |
| `get_series` | beta: jedno meranie ako jedna hodnota za deň, s kvalitou údajov |
| `compare_periods` | beta: jedno meranie v dvoch obdobiach, ktoré si vyberiete |
| `search_fhir` | štandardné vyhľadávanie FHIR R4, vracia Bundle |
| `read_fhir_resource` | jeden zdroj alebo jeho staršia verzia |
| `get_provenance` | kto vytvoril zdroj, kedy a z akého systému |
| `lookup_code` | kódy LOINC podľa textu alebo kódu (pre lieky, použite `search_health_terms`) |
| `search_health_terms` | verejný katalóg symptómov, stavov a liečebných postupov, podľa názvu v 20 jazykoch, synonymá, značky alebo kódu ([návod](https://developers.anpheros.com/sk/guides/anpheros-search)) |
| `get_health_term` | jedna položka katalógu s jej kódmi, názvami, súhrnom MedlinePlus, odkazmi na zdroje a citovanými indikáciami EMA / FDA |
| `validate_fhir_resource` | kontroluje zdroj bez jeho uloženia |
| `create_fhir_resource` | validuje a potom zapíše zdroj |
| `create_patient` | nový vymyslený pacient v projekte |
| `import_lab_report` | CSV, HL7 v2 ORU^R01 alebo JSON laboratórna správa sa stáva laboratórnymi Observáciami |
| `sandbox_status` | zapisuje dnes použité, pacientov, úložisko, resetuje |
| `reset_sandbox` | obnoví 30 syntetických pacientov (žiada o potvrdenie) |

Nástroje na čítanie sú označené ako read-only a reset je označený ako deštruktívny, takže klienti, ktorí sa pýtajú pred rizikovými akciami, to môžu urobiť. Server tiež ponúka zoznam syntetických pacientov ako zdroj a tri výzvy: súhrn pre lekára, import CSV laboratórnych údajov a budovanie vašej integrácie na API.

## Ako sa správa

- **Rovnaké pravidlá ako API.** Každý nástroj volá verejné API s vaším kľúčom: rovnaké rozsahy (scopes), obmedzenia rýchlosti (rate limits), validácia a audit. Kľúč iba na čítanie (read-only) nemôže zapisovať.
- **Pôvod (Provenance).** Všetko, čo agent zapíše, je zaznamenané so zdrojom `urn:anpheros:mcp`, takže vždy môžete zistiť, čo pochádza od agenta.
- **Dáta pacienta sú dáta.** Výsledky nástrojov nesú poznámku, že obsah záznamu sa nikdy nesmie nasledovať ako inštrukcie, čo je základná ochrana proti vstrekovaniu (prompt injection) prostredníctvom lekárskych záznamov.
- **Jeden záznam, so súhlasom.** Produkčné API kľúče (`sk_live_…`) sú odmietnuté, pretože dosahujú ku každému pacientovi projektu. Skutočný záznam sa k asistentovi dostane iba prostredníctvom OAuth, po tom, čo ho daná osoba schváli, a každé čítanie je zaznamenané v histórii jej prístupu.
- **Štandardné objavovanie (discovery).** Bez poverení server odpovie 401 s hlavičkou `WWW-Authenticate` odkazujúcou na jeho OAuth chránené metadáta zdroja (RFC 9728); asistenti sa registrujú prostredníctvom dynamickej registrácie klienta (RFC 7591), s PKCE. Registrácia akceptuje iba loopback adresy, schémy aplikácií známych editorov a callback domény známych AI asistentov.

## Často kladené otázky

### Čo je MCP server?
MCP (Model Context Protocol) je otvorený protokol, prostredníctvom ktorého AI agenti a kódovacie asistenti volajú externé nástroje. MCP server pre FHIR umožňuje agentovi priamo čítať a zapisovať zdravotné záznamy namiesto toho, aby ste vkladali dáta do chatu.

### Je to zadarmo?
Áno. MCP server funguje na bezplatnom sandboxe: 30 syntetických pacientov na projekt, až 10 000 zápisov denne, bez karty.

### Môže asistent čítať záznam skutočného pacienta?
Iba prostredníctvom OAuth, po tom, čo daná osoba schváli asistenta na obrazovke súhlasu, na obdobie, ktoré si zvolí, a iba ich vlastný záznam (alebo záznam niekoho, o koho sa starajú). Počas súkromnej beta verzie OAuth pripojenia používajú sandbox záznamy.

### Ktorú verziu FHIR používa?
HL7 FHIR R4 (4.0.1), rovnaké API ako https://platform.anpheros.com/fhir/R4, s International Patient Summary a REST pohľadom na rovnaké dáta.

### Funguje to s ChatGPT?
Konektory ChatGPT používajú OAuth s dynamickou registráciou klienta, ktorú server podporuje, a jeho callback doména je akceptovaná. Tok sme otestovali s oficiálnym MCP SDK klientom; ak pripojenie ChatGPT zlyhá, napíšte na support@anpheros.com. Claude Code, Cursor a VS Code tiež fungujú s sandbox kľúčom.

## Súvisiace

- [Ako udeliť prístup k lekárskym záznamom AI agentovi](https://developers.anpheros.com/sk/guides/ai-agent-access-medical-records): podrobný návod v Pythone
- [Bezplatná FHIR databáza a sandbox](https://developers.anpheros.com/sk/guides/free-fhir-database)
- [AI agenti a lekárske dáta](https://developers.anpheros.com/sk/guides/ai-agents-medical-data)
- [LLM aplikácie a zdravotnícke dáta](https://developers.anpheros.com/sk/guides/llm-healthcare-data)
- [Zdravotnícke API s pacientovým súhlasom](https://developers.anpheros.com/sk/guides/healthcare-api-patient-consent)