Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

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, zápis, import laboratórnych výsledkov a reset sandboxu, na 30 syntetických pacientoch, zadarmo.

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 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

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)

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

VS Code (.vscode/mcp.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)

{
  "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á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 [email protected]. 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: podrobný návod v Pythone
• Bezplatná FHIR databáza a sandbox
• AI agenti a lekárske dáta
• LLM aplikácie a zdravotnícke dáta
• Zdravotnícke API s pacientovým súhlasom

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card