Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card
Server FHIR MCP pentru agenți AI
Conectează Claude Code, Cursor, VS Code sau Claude Desktop la un API HL7 FHIR R4 prin MCP: 20 de instrumente pentru citirea fișierelor, context pregătit pentru AI, scriere, import analize și resetare sandbox, pe 30 de pacienți sintetici, gratuit.
Anpheros FHIR este un server MCP la distanță care permite unui agent AI (Claude, Claude Code, Cursor, VS Code, Claude Desktop) să lucreze cu o API de date medicale HL7 FHIR R4. Se conectează în două moduri:
- Cu o cheie sandbox gratuită, pentru dezvoltatori: agentul dvs. listează pacienți, citește înregistrările acestora ca FHIR sau ca un context pregătit pentru AI cu proveniență, scrie observații, importă rapoarte de analize și resetează datele de test, totul pe 30 de pacienți sintetici cu istorii realiste.
- Cu OAuth, pentru o persoană și propria sa înregistrare: asistentul se înregistrează, persoana se autentifică și îl aprobă pe ecranul de consimțământ Anpheros, iar asistentul poate apoi citi acea singură înregistrare, pentru perioada aleasă, doar în citire, cu excepția cazului în care persoana a permis mai mult.
Adresa serverului: https://platform.anpheros.com/mcp (HTTP Streamable, stateless).
Conectați-vă cu OAuth (Claude și alți asistenți)
Adăugați https://platform.anpheros.com/mcp ca un conector personalizat (în Claude: Settings → Connectors → Add custom connector). Nu este necesară nicio altă configurare: asistentul descoperă serverul de autorizare, se înregistrează singur și deschide ecranul de consimțământ Anpheros. Acolo, persoana vede că este un asistent AI, că ceea ce citește este trimis companiei care rulează asistentul, ce poate citi, pentru cât timp și unde se va întoarce după ce a ales. Accesul este doar pentru citire, cu excepția cazului în care s-a cerut mai mult și s-a permis, iar persoana îl poate revoca oricând.
În timpul beta-ului privat, conexiunile OAuth utilizează înregistrări sandbox. Conexiunile la înregistrări reale se deschid după actualizarea politicii de confidențialitate.
Conectați-vă cu o cheie sandbox (dezvoltatori)
- Autentificați-vă la platform.anpheros.com/dashboard cu Google și alegeți Get a sandbox key. Veți primi o cheie
sk_test_…și un proiect cu 30 de pacienți sintetici. - Plasați cheia într-o variabilă de mediu, de exemplu
ANPHEROS_KEY, și adăugați serverul la instrumentul dvs.
Claude Code
claude mcp add --transport http anpheros-fhir https://platform.anpheros.com/mcp --header "Authorization: Bearer $ANPHEROS_KEY"
Cursor (~/.cursor/mcp.json sau .cursor/mcp.json în proiect)
{
"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, prin intermediul punții mcp-remote)
{
"mcpServers": {
"anpheros-fhir": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://platform.anpheros.com/mcp", "--header", "Authorization: Bearer ${ANPHEROS_KEY}"],
"env": { "ANPHEROS_KEY": "sk_test_…" }
}
}
}
Apoi, întrebați agentul ceva de genul: "List the sandbox patients, pick the one with diabetes and summarise her last six months of HbA1c."
Instrumente
| Instrument | Ce face |
|---|---|
list_patients |
pacienții proiectului: cele 30 de persoane sintetice și oricare pe care le-ați creat |
get_patient_context |
un context pregătit pentru AI pentru un pacient, în limita unui buget de token-uri, fiecare element etichetat cu sursa sa |
get_patient_summary |
Rezumatul Internațional al Pacientului (FHIR $summary), în limba solicitată |
get_timeline |
înregistrarea în ordine cronologică pe tipuri de resurse |
get_health_patterns |
beta: ce s-a schimbat și ce se repetă, fiecare constatare cu perioada sa, dovezi și limitări; nu diagnostice (ghid) |
get_pattern_evidence |
beta: fiecare resursă din spatele unei constatări |
get_series |
beta: o măsurătoare ca o singură valoare pe zi, cu calitatea datelor |
compare_periods |
beta: o măsurătoare în două perioade alese de dvs. |
search_fhir |
căutare standard FHIR R4, returnând un Bundle |
read_fhir_resource |
o resursă sau o versiune anterioară a acesteia |
get_provenance |
cine a scris o resursă, când și din ce sistem |
lookup_code |
coduri LOINC după text sau după cod (pentru medicamente, folosiți search_health_terms) |
search_health_terms |
catalogul public de simptome, afecțiuni și tratamente, după nume în 20 de limbi, sinonim, marcă sau cod (ghid) |
get_health_term |
o intrare în catalog cu codurile sale, nume, rezumat MedlinePlus, link-uri sursă și indicații EMA / FDA citate |
validate_fhir_resource |
verifică o resursă fără a o salva |
create_fhir_resource |
validează, apoi scrie o resursă |
create_patient |
un nou pacient creat în proiect |
import_lab_report |
un raport de laborator CSV, HL7 v2 ORU^R01 sau JSON devine observații de laborator |
sandbox_status |
scrie utilizări de astăzi, pacienți, stocare, resetări |
reset_sandbox |
restaurează cei 30 de pacienți sintetici (cere confirmare) |
Instrumentele de citire sunt marcate ca read-only, iar resetarea este marcată ca distructivă, astfel încât clienții care întreabă înainte de acțiuni riscante pot face acest lucru. Serverul oferă, de asemenea, lista pacienților sintetici ca resursă și trei prompt-uri: un rezumat clinic, un import CSV de laborator și construirea integrării dvs. pe API.
Cum se comportă
- Aceleași reguli ca și API-ul. Fiecare instrument apelează API-ul public cu cheia dvs.: aceleași scopuri (scopes), limite de rată (rate limits), validare și audit. O cheie de tip read-only nu poate scrie.
- Proveniență. Tot ceea ce scrie un agent este înregistrat cu sursa
urn:anpheros:mcp, astfel încât puteți spune întotdeauna ce a provenit de la un agent. - Datele pacientului sunt date. Rezultatele instrumentelor poartă o notă conform căreia conținutul înregistrării nu trebuie urmat niciodată ca instrucțiuni, o protecție de bază împotriva injecției de prompt prin intermediul dosarelor medicale.
- O singură înregistrare, cu consimțământ. Cheile API de producție (
sk_live_…) sunt refuzate, deoarece accesează fiecare pacient al unui proiect. O înregistrare reală ajunge la un asistent numai prin OAuth, după ce persoana respectivă și-a dat aprobarea, iar fiecare citire este înregistrată în istoricul de acces al acesteia. - Descoperire standard. Fără credențiale, serverul răspunde cu 401 și un antet
WWW-Authenticatecare indică metadatele resurselor protejate prin OAuth (RFC 9728); asistenții se înregistrează prin înregistrare dinamică a clienților (RFC 7591), cu PKCE. Înregistrarea acceptă numai adrese loopback, schemele de aplicații ale editorilor cunoscuți și domeniile de callback ale asistenților AI cunoscuți.
Întrebări frecvente
Ce este un server MCP?
MCP (Model Context Protocol) este un protocol deschis prin care agenții AI și asistenții de codare apelează instrumente externe. Un server MCP pentru FHIR permite agentului să citească și să scrie înregistrări medicale direct, în loc să copiați și să lipiți date în chat.
Este gratuit?
Da. Serverul MCP funcționează pe sandbox-ul gratuit: 30 de pacienți sintetici per proiect, până la 10.000 de scrieri pe zi, fără card.
Poate un asistent să citească dosarul unui pacient real?
Doar prin OAuth, după ce persoana respectivă aprobă asistentul pe ecranul de consimțământ, pentru perioada aleasă de ei și doar dosarul lor (sau al unei persoane de care au grijă). În timpul beta-ului privat, conexiunile OAuth folosesc înregistrări sandbox.
Ce versiune FHIR folosește?
HL7 FHIR R4 (4.0.1), același API ca https://platform.anpheros.com/fhir/R4, cu International Patient Summary și o vizualizare REST a acelorași date.
Funcționează cu ChatGPT?
Conectorii ChatGPT folosesc OAuth cu înregistrare dinamică a clienților, pe care serverul o suportă, iar domeniul său de callback este acceptat. Am testat fluxul cu clientul oficial MCP SDK; dacă o conexiune ChatGPT eșuează, scrieți la [email protected]. Claude Code, Cursor și VS Code funcționează, de asemenea, cu o cheie sandbox.
Conexe
- Cum să acordați unui agent AI acces la dosarele medicale: tutorial pas cu pas în Python
- Bază de date FHIR gratuită și sandbox
- Agenți AI și date medicale
- Aplicații LLM și date din domeniul sănătății
- API de sănătate cu consimțământul pacientului
Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card