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

Server FHIR MCP per agenti AI

Connetti Claude Code, Cursor, VS Code o Claude Desktop a un'API HL7 FHIR R4 tramite MCP: 20 strumenti per leggere record, contesto pronto per AI, scrittura, importazione esami e reset sandbox, su 30 pazienti sintetici, gratuito.

Anpheros FHIR è un server MCP remoto che consente a un agente AI (Claude, Claude Code, Cursor, VS Code, Claude Desktop) di lavorare con un'API di dati sanitari HL7 FHIR R4. Si connette in due modi:

• Con una chiave sandbox gratuita, per sviluppatori: il tuo agente elenca i pazienti, legge i loro record come FHIR o come contesto pronto per l'IA con provenienza, scrive osservazioni, importa referti di laboratorio e resetta i suoi dati di test, tutto su 30 pazienti sintetici con storie realistiche.
• Con OAuth, per una persona e il suo record: l'assistente si registra, la persona accede e lo approva sulla schermata di consenso Anpheros, e l'assistente può quindi leggere quel singolo record, per il periodo scelto, in sola lettura a meno che la persona non abbia consentito di più.

Indirizzo del server: https://platform.anpheros.com/mcp (HTTP streamable, stateless).

Connettersi con OAuth (Claude e altri assistenti)

Aggiungere https://platform.anpheros.com/mcp come connettore personalizzato (in Claude: Settings → Connectors → Add custom connector). Non è necessaria alcuna altra configurazione: l'assistente scopre il server di autorizzazione, si registra autonomamente e apre la schermata di consenso di Anpheros. Qui la persona vede che si tratta di un assistente AI, cosa viene inviato all'azienda che gestisce l'assistente, cosa può leggere, per quanto tempo e dove tornerà dopo aver scelto. L'accesso è in sola lettura a meno che non sia stato richiesto e consentito altro, e la persona può revocarlo in qualsiasi momento.

Durante la beta privata, le connessioni OAuth utilizzano record sandbox. Le connessioni a record reali si apriranno dopo l'aggiornamento dell'informativa sulla privacy.

Connettiti con una chiave sandbox (sviluppatori)

1. Accedi a platform.anpheros.com/dashboard con Google e scegli Get a sandbox key. Otterrai una chiave sk_test_… e un progetto con 30 pazienti sintetici.
2. Inserisci la chiave in una variabile d'ambiente, ad esempio ANPHEROS_KEY, e aggiungi il server al tuo strumento.

Claude Code

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

Cursor (~/.cursor/mcp.json o .cursor/mcp.json nel progetto)

{
  "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, tramite il bridge 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_…" }
    }
  }
}

Quindi, chiedi al tuo agente qualcosa come: "List the sandbox patients, pick the one with diabetes and summarise her last six months of HbA1c."

Strumenti

Gli strumenti di lettura sono contrassegnati come di sola lettura e il reset è contrassegnato come distruttivo, in modo che i client che chiedono prima di azioni rischiose possano farlo. Il server offre anche l'elenco dei pazienti sintetici come risorsa e tre prompt: un riassunto per il clinico, un'importazione CSV di laboratorio e la creazione della tua integrazione sull'API.

Come si comporta

• Le stesse regole dell'API. Ogni strumento chiama l'API pubblica con la tua chiave: gli stessi scope, limiti di frequenza, validazione e audit. Una chiave di sola lettura non può scrivere.
• Provenienza. Tutto ciò che un agente scrive viene registrato con la sorgente urn:anpheros:mcp, in modo da poter sempre sapere cosa proviene da un agente.
• I dati del paziente sono dati. I risultati degli strumenti riportano una nota che il contenuto del record non deve mai essere seguito come istruzioni, una protezione di base contro l'iniezione di prompt tramite cartelle cliniche.
• Un record, con consenso. Le chiavi API di produzione (sk_live_…) vengono rifiutate, perché raggiungono ogni paziente di un progetto. Un record reale raggiunge un assistente solo tramite OAuth, dopo che la persona lo ha approvato, e ogni lettura viene registrata nella sua cronologia di accesso.
• Discovery standard. Senza credenziali il server risponde 401 con un header WWW-Authenticate che punta ai metadati della sua risorsa protetta da OAuth (RFC 9728); gli assistenti si registrano tramite registrazione dinamica del client (RFC 7591), con PKCE. La registrazione accetta solo indirizzi loopback, gli schemi delle app degli editori noti e i domini di callback degli assistenti AI noti.

Domande frequenti

Cos'è un server MCP?

MCP (Model Context Protocol) è un protocollo aperto tramite il quale agenti AI e assistenti di codifica chiamano strumenti esterni. Un server MCP per FHIR consente all'agente di leggere e scrivere record sanitari direttamente, invece di incollare dati nella chat.

È gratuito?

Sì. Il server MCP funziona sulla sandbox gratuita: 30 pazienti sintetici per progetto, fino a 10.000 scritture al giorno, nessuna carta di credito richiesta.

Un assistente può leggere il record di un paziente reale?

Solo tramite OAuth, dopo che la persona approva l'assistente nella schermata di consenso, per il periodo scelto, e solo il proprio record (o quello di qualcuno di cui si prende cura). Durante la beta privata, le connessioni OAuth utilizzano record sandbox.

Quale versione FHIR utilizza?

HL7 FHIR R4 (4.0.1), la stessa API di https://platform.anpheros.com/fhir/R4, con l'International Patient Summary e una vista REST degli stessi dati.

Funziona con ChatGPT?

I connettori ChatGPT utilizzano OAuth con registrazione dinamica del client, che il server supporta, e il suo dominio di callback è accettato. Abbiamo testato il flusso con il client MCP SDK ufficiale; se una connessione ChatGPT fallisce, scrivi a [email protected]. Anche Claude Code, Cursor e VS Code funzionano con una chiave sandbox.

Correlati

• Come dare a un agente AI l'accesso alle cartelle cliniche: tutorial passo-passo in Python
• Database FHIR gratuito e sandbox
• Agenti AI e dati medici
• Applicazioni LLM e dati sanitari
• API sanitarie con consenso del paziente

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