# FHIR MCP server pro agenty AI

> Připojte Claude Code, Cursor, VS Code nebo Claude Desktop k HL7 FHIR R4 API přes MCP: 20 nástrojů pro čtení záznamů, kontext připravený pro AI, zápis, import laboratoří a reset sandboxu, na 30 syntetických pacientech, zdarma.

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

**Anpheros FHIR je vzdálený MCP server, který umožňuje agentovi AI (Claude, Claude Code, Cursor, VS Code, Claude Desktop) pracovat s HL7 FHIR R4 API pro zdravotnická data.** Připojuje se dvěma způsoby:

- **S bezplatným klíčem do sandboxu**, pro vývojáře: váš agent vypisuje pacienty, čte jejich záznamy jako FHIR nebo jako kontext připravený pro AI s informacemi o původu, zapisuje pozorování, importuje laboratorní zprávy a resetuje svá testovací data, to vše na 30 syntetických pacientech s realistickou historií.
- **S OAuth**, pro osobu a její vlastní záznam: asistent se zaregistruje, osoba se přihlásí a schválí jej na obrazovce souhlasu Anpheros, a asistent pak může číst tento jeden záznam po zvolenou dobu, pouze pro čtení, pokud osoba nepovolila více.

Adresa serveru: `https://platform.anpheros.com/mcp` (Streamovatelné HTTP, bezstavové).

## Připojení přes OAuth (Claude a další asistenti)

Přidejte `https://platform.anpheros.com/mcp` jako vlastní konektor (v Claude: Nastavení → Konektory → Přidat vlastní konektor). Nic dalšího není potřeba konfigurovat: asistent zjistí autorizační server, zaregistruje se a otevře obrazovku souhlasu Anpheros. Tam osoba vidí, že se jedná o AI asistenta, co se čte, je odesíláno společnosti provozující asistenta, co může číst, po jak dlouhou dobu a kam se vrátí po výběru. Přístup je pouze pro čtení, pokud nebylo požadováno a povoleno více, a osoba jej může kdykoli odvolat.

Během soukromé beta verze používají připojení OAuth záznamy v sandboxu. Připojení k reálným záznamům se otevřou po aktualizaci zásad ochrany osobních údajů.

## Připojení pomocí sandbox klíče (vývojáři)

1. Přihlaste se na [platform.anpheros.com/dashboard](https://platform.anpheros.com/dashboard/) pomocí Google a zvolte **Get a sandbox key**. Získáte `sk_test_…` klíč a projekt s 30 syntetickými pacienty.
2. Vložte klíč do proměnné prostředí, například `ANPHEROS_KEY`, a přidejte server do svého nástroje.

**Claude Code**

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

**Cursor** (`~/.cursor/mcp.json` nebo `.cursor/mcp.json` v projektu)

```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`, přes `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_…" }
    }
  }
}
```

Poté se svého agenta zeptejte například: *"List the sandbox patients, pick the one with diabetes and summarise her last six months of HbA1c."*

## Nástroje

| Nástroj | Co dělá |
|---|---|
| `list_patients` | pacienti projektu: 30 syntetických person a všichni, které jste vytvořili |
| `get_patient_context` | kontext pro jednoho pacienta připravený pro AI, v rámci rozpočtu tokenů, každá položka označená svým zdrojem |
| `get_patient_summary` | Mezinárodní souhrn pacienta (FHIR `$summary`), v jazyce, který si vyberete |
| `get_timeline` | záznam v chronologickém pořadí napříč typy zdrojů |
| `get_health_patterns` | beta: co se změnilo a co se opakuje, každé zjištění s jeho obdobím, důkazy a omezeními; ne diagnózy ([průvodce](https://developers.anpheros.com/cs/guides/health-patterns)) |
| `get_pattern_evidence` | beta: každý zdroj za jedním zjištěním |
| `get_series` | beta: jedno měření jako jedna hodnota za den, s kvalitou dat |
| `compare_periods` | beta: jedno měření ve dvou obdobích, která si vyberete |
| `search_fhir` | standardní vyhledávání FHIR R4, vracející Bundle |
| `read_fhir_resource` | jeden zdroj nebo jeho starší verze |
| `get_provenance` | kdo vytvořil zdroj, kdy a z jakého systému |
| `lookup_code` | kódy LOINC podle textu nebo kódu (pro léky použijte `search_health_terms`) |
| `search_health_terms` | veřejný katalog symptomů, stavů a léčby, podle názvu ve 20 jazycích, synonyma, značky nebo kódu ([průvodce](https://developers.anpheros.com/cs/guides/anpheros-search)) |
| `get_health_term` | jedna položka katalogu s jejími kódy, názvy, souhrnem MedlinePlus, odkazy na zdroje a citovanými indikacemi EMA / FDA |
| `validate_fhir_resource` | kontroluje zdroj bez jeho uložení |
| `create_fhir_resource` | validuje a poté zapíše zdroj |
| `create_patient` | nový vymyšlený pacient v projektu |
| `import_lab_report` | laboratorní zpráva ve formátu CSV, HL7 v2 ORU^R01 nebo JSON se stává laboratorními Observations |
| `sandbox_status` | zapisuje dnes použité, pacienty, úložiště, resetuje |
| `reset_sandbox` | obnoví 30 syntetických pacientů (vyžádá si potvrzení) |

Nástroje pro čtení jsou označeny jako read-only a reset je označen jako destruktivní, takže klienti, kteří se ptají před rizikovými akcemi, to mohou provést. Server také nabízí seznam syntetických pacientů jako zdroj a tři výzvy: souhrn pro kliniky, import CSV pro laboratoř a sestavení vaší integrace na API.

## Jak se chová

- **Stejná pravidla jako API.** Každý nástroj volá veřejné API s vaším klíčem: stejné rozsahy platnosti (scopes), limity požadavků (rate limits), validace a audit. Klíč pouze pro čtení nemůže zapisovat.
- **Původ.** Vše, co agent zapíše, je zaznamenáno se zdrojem `urn:anpheros:mcp`, takže vždy poznáte, co pochází od agenta.
- **Data pacienta jsou data.** Výsledky nástrojů nesou poznámku, že obsah záznamu nikdy nesmí být následován jako instrukce, což je základní ochrana proti injektáži promptů prostřednictvím lékařských záznamů.
- **Jeden záznam, se souhlasem.** Produkční API klíče (`sk_live_…`) jsou odmítnuty, protože dosahují ke každému pacientovi projektu. Skutečný záznam se k asistentovi dostane pouze prostřednictvím OAuth, poté co jej daná osoba schválí, a každé čtení je zaznamenáno v historii přístupů.
- **Standardní objevování.** Bez přihlašovacích údajů server odpoví 401 s hlavičkou `WWW-Authenticate` odkazující na metadata svého zdroje chráněného OAuth (RFC 9728); asistenti se registrují prostřednictvím dynamické registrace klienta (RFC 7591) s PKCE. Registrace přijímá pouze loopback adresy, schémata aplikací známých editorů a domény zpětného volání známých AI asistentů.

## Často kladené dotazy

### Co je MCP server?
MCP (Model Context Protocol) je otevřený protokol, kterým AI agenti a kódovací asistenti volají externí nástroje. MCP server pro FHIR umožňuje agentovi číst a zapisovat zdravotní záznamy přímo, namísto toho, abyste vkládali data do chatu.

### Je to zdarma?
Ano. MCP server funguje na bezplatném sandboxu: 30 syntetických pacientů na projekt, až 10 000 zápisů denně, bez karty.

### Může asistent číst záznam skutečného pacienta?
Pouze přes OAuth, poté co daná osoba schválí asistenta na obrazovce souhlasu, na zvolené období, a pouze jejich vlastní záznam (nebo záznam někoho, o koho pečují). Během privátní beta verze používají OAuth připojení sandbox záznamy.

### Kterou verzi FHIR používá?
HL7 FHIR R4 (4.0.1), stejné API jako https://platform.anpheros.com/fhir/R4, s International Patient Summary a REST pohledem na stejná data.

### Funguje to s ChatGPT?
Konektory ChatGPT používají OAuth s dynamickou registrací klienta, kterou server podporuje, a jeho callback doména je akceptována. Tok jsme otestovali s oficiálním MCP SDK klientem; pokud připojení ChatGPT selže, napište na support@anpheros.com. Claude Code, Cursor a VS Code také fungují s sandbox klíčem.

## Související

- [Jak povolit přístup AI agenta k lékařským záznamům](https://developers.anpheros.com/cs/guides/ai-agent-access-medical-records): podrobný návod v Pythonu
- [Bezplatná FHIR databáze a sandbox](https://developers.anpheros.com/cs/guides/free-fhir-database)
- [AI agenti a lékařská data](https://developers.anpheros.com/cs/guides/ai-agents-medical-data)
- [Aplikace LLM a zdravotnická data](https://developers.anpheros.com/cs/guides/llm-healthcare-data)
- [Zdravotnické API s povolením pacienta](https://developers.anpheros.com/cs/guides/healthcare-api-patient-consent)