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

Serwer FHIR MCP dla agentów AI

Połącz Claude Code, Cursor, VS Code lub Claude Desktop z API HL7 FHIR R4 przez MCP: 20 narzędzi do odczytu rekordów, kontekst gotowy na AI, zapisywanie, importowanie wyników badań i resetowanie sandboxa, na 30 syntetycznych pacjentach, za darmo.

Anpheros FHIR to zdalny serwer MCP, który umożliwia agentowi AI (Claude, Claude Code, Cursor, VS Code, Claude Desktop) pracę z API danych medycznych HL7 FHIR R4. Łączy się on na dwa sposoby:

• Z darmowym kluczem piaskownicy, dla deweloperów: Twój agent listuje pacjentów, odczytuje ich rekordy jako FHIR lub jako kontekst gotowy dla AI z informacją o pochodzeniu danych, zapisuje obserwacje, importuje wyniki badań laboratoryjnych i resetuje dane testowe, wszystko na 30 syntetycznych pacjentach z realistycznymi historiami chorób.
• Z OAuth, dla osoby i jej własnego rekordu: Asystent rejestruje się, osoba loguje się i zatwierdza go na ekranie zgody Anpheros, a następnie asystent może odczytać ten jeden rekord, przez wybrany okres, tylko do odczytu, chyba że osoba zezwoliła na więcej.

Adres serwera: https://platform.anpheros.com/mcp (Strumieniowy HTTP, bezstanowy).

Połączenie z OAuth (Claude i inne asystenty)

Dodaj https://platform.anpheros.com/mcp jako niestandardowe połączenie (w Claude: Ustawienia → Połączenia → Dodaj niestandardowe połączenie). Nic więcej nie trzeba konfigurować: asystent wykrywa serwer autoryzacji, rejestruje się i otwiera ekran zgody Anpheros. Tam użytkownik widzi, że jest to asystent AI, co jest odczytywane i wysyłane do firmy zarządzającej asystentem, co może odczytać, na jak długo i dokąd wróci po dokonaniu wyboru. Dostęp jest tylko do odczytu, chyba że poproszono o więcej i zostało to zatwierdzone, a użytkownik może go w każdej chwili odwołać.

Podczas prywatnych testów beta połączenia OAuth wykorzystują rekordy sandbox. Połączenia z rzeczywistymi rekordami zostaną otwarte po zaktualizowaniu polityki prywatności.

Połącz się z kluczem sandbox (deweloperzy)

1. Zaloguj się na platform.anpheros.com/dashboard za pomocą Google i wybierz Get a sandbox key. Otrzymasz klucz sk_test_… i projekt z 30 syntetycznymi pacjentami.
2. Umieść klucz w zmiennej środowiskowej, na przykład ANPHEROS_KEY, i dodaj serwer do swojego narzędzia.

Claude Code

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

Cursor (~/.cursor/mcp.json lub .cursor/mcp.json w projekcie)

{
  "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, przez mostek 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_…" }
    }
  }
}

Następnie zadaj swojemu agentowi coś w stylu: "Wylistuj pacjentów z sandboxa, wybierz tego z cukrzycą i podsumuj jej HbA1c z ostatnich sześciu miesięcy."

Narzędzia

Narzędzia do odczytu są oznaczone jako tylko do odczytu, a reset jako niszczący, dzięki czemu klienci mogą pytać przed ryzykownymi działaniami. Serwer oferuje również listę syntetycznych pacjentów jako zasób oraz trzy podpowiedzi: podsumowanie dla lekarza, import CSV laboratorium i budowanie integracji na API.

Jak to działa

• Te same zasady co API. Każde narzędzie wywołuje publiczne API za pomocą Twojego klucza: te same zakresy, limity żądań, walidacja i audyt. Klucz tylko do odczytu nie może zapisywać.
• Pochodzenie danych. Wszystko, co zapisuje agent, jest rejestrowane ze źródłem urn:anpheros:mcp, dzięki czemu zawsze można określić, co pochodzi od agenta.
• Dane pacjenta to dane. Wyniki narzędzi zawierają informację, że zawartość rekordu nigdy nie powinna być traktowana jako instrukcje, co stanowi podstawowe zabezpieczenie przed wstrzyknięciem promptu za pośrednictwem dokumentacji medycznej.
• Jeden rekord, za zgodą. Klucze produkcyjne API (sk_live_…) są odrzucane, ponieważ mają dostęp do każdego pacjenta projektu. Rzeczywisty rekord trafia do asystenta tylko poprzez OAuth, po jego zatwierdzeniu przez osobę, a każdy odczyt jest rejestrowany w historii dostępu tej osoby.
• Standardowe odkrywanie. Bez poświadczeń serwer odpowiada kodem 401 z nagłówkiem WWW-Authenticate wskazującym na jego metadane zasobów chronionych przez OAuth (RFC 9728); asystenci rejestrują się poprzez dynamiczną rejestrację klienta (RFC 7591), z PKCE. Rejestracja akceptuje tylko adresy loopback, schematy aplikacji znanych edytorów i domeny zwrotne znanych asystentów AI.

Często zadawane pytania

Czym jest serwer MCP?

MCP (Model Context Protocol) to otwarty protokół, za pomocą którego agenci AI i asystenci kodowania wywołują zewnętrzne narzędzia. Serwer MCP dla FHIR pozwala agentowi na bezpośrednie odczytywanie i zapisywanie historii medycznych, zamiast wklejania danych do czatu.

Czy jest to darmowe?

Tak. Serwer MCP działa na darmowym środowisku sandbox: 30 syntetycznych pacjentów na projekt, do 10 000 zapisów dziennie, bez karty.

Czy asystent może odczytać dane prawdziwego pacjenta?

Tylko za pośrednictwem OAuth, po tym jak dana osoba zatwierdzi asystenta na ekranie zgody, na wybrany przez siebie okres, i tylko jego własne dane (lub dane osoby, którą się opiekuje). Podczas prywatnej wersji beta, połączenia OAuth korzystają z danych z sandbox.

Z której wersji FHIR korzysta?

HL7 FHIR R4 (4.0.1), to samo API co https://platform.anpheros.com/fhir/R4, z International Patient Summary i widokiem REST tych samych danych.

Czy działa z ChatGPT?

Konektory ChatGPT używają OAuth z dynamiczną rejestracją klienta, którą serwer obsługuje, a jego domena zwrotna jest akceptowana. Przepływ został przetestowany z oficjalnym klientem MCP SDK; jeśli połączenie ChatGPT się nie powiedzie, napisz na adres [email protected]. Claude Code, Cursor i VS Code również działają z kluczem sandbox.

Powiązane

• Jak nadać agentowi AI dostęp do dokumentacji medycznej: samouczek krok po kroku w Pythonie
• Darmowa baza danych FHIR i piaskownica
• Agenci AI i dane medyczne
• Aplikacje LLM i dane dotyczące opieki zdrowotnej
• API opieki zdrowotnej z zgodą pacjenta

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