Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
FHIR MCP server pro AI agenty
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.
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)
- Přihlaste se na 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. - Vložte klíč do proměnné prostředí, například
ANPHEROS_KEY, a přidejte server do svého nástroje.
Claude Code
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)
{
"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, přes 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_…" }
}
}
}
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) |
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) |
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-Authenticateodkazují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 [email protected]. 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: podrobný návod v Pythonu
- Bezplatná FHIR databáze a sandbox
- AI agenti a lékařská data
- Aplikace LLM a zdravotnická data
- Zdravotnické API s povolením pacienta
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card