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

FHIR MCP-сервер для ИИ-агентов

Подключите Claude Code, Cursor, VS Code или Claude Desktop к HL7 FHIR R4 API через MCP: 20 инструментов для чтения записей, контекст, готовый для ИИ, запись, импорт анализов и сброс sandbox, на 30 синтетических пациентах, бесплатно.

Anpheros FHIR — это удаленный MCP-сервер, который позволяет ИИ-агенту (Claude, Claude Code, Cursor, VS Code, Claude Desktop) работать с API HL7 FHIR R4 для медицинских данных. Он подключается двумя способами:

С бесплатным ключом песочницы для разработчиков: ваш агент может получать список пациентов, читать их записи в формате FHIR или в виде готового для ИИ контекста с указанием источника, записывать наблюдения, импортировать лабораторные отчеты и сбрасывать тестовые данные, все это на 30 синтетических пациентах с реалистичной историей болезни.
С помощью OAuth для человека и его собственной записи: помощник регистрируется, человек входит в систему и одобряет его на экране согласия Anpheros, после чего помощник может читать эту одну запись в течение выбранного периода, только для чтения, если человек не разрешил большего.

Адрес сервера: https://platform.anpheros.com/mcp (потоковая передача HTTP, без сохранения состояния).

Подключение через OAuth (Claude и другие ассистенты)

Добавьте https://platform.anpheros.com/mcp как пользовательский коннектор (в Claude: Settings → Connectors → Add custom connector). Никаких других настроек не требуется: ассистент обнаружит сервер авторизации, зарегистрируется и откроет экран согласия Anpheros. Там пользователь увидит, что это ИИ-ассистент, какие данные отправляются компании, управляющей ассистентом, какие данные он может читать, как долго и куда вернется после выбора. Доступ предоставляется только для чтения, если не было запрошено и разрешено большее, и пользователь может отозвать его в любое время.

Во время закрытого бета-тестирования OAuth-подключения используют записи из песочницы (sandbox). Подключения к реальным записям откроются после обновления политики конфиденциальности.

Подключение с помощью sandbox-ключа (для разработчиков)

Войдите на platform.anpheros.com/dashboard через Google и выберите Get a sandbox key. Вы получите sk_test_… ключ и проект с 30 синтетическими пациентами.
Поместите ключ в переменную окружения, например ANPHEROS_KEY, и добавьте сервер в свой инструмент.

Claude Code

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

Cursor (~/.cursor/mcp.json или .cursor/mcp.json в проекте)

{
  "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, через мост 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_…" }
    }
  }
}

Затем попросите вашего агента, например: "List the sandbox patients, pick the one with diabetes and summarise her last six months of HbA1c."

Инструменты

Инструмент	Назначение
`list_patients`	пациенты проекта: 30 синтетических персон и любые созданные вами
`get_patient_context`	контекст для одного пациента, готовый для ИИ, в пределах лимита токенов, каждый элемент помечен источником
`get_patient_summary`	Международная сводка пациента (FHIR `$summary`) на запрашиваемом вами языке
`get_timeline`	записи в хронологическом порядке по типам ресурсов
`get_health_patterns`	бета: что изменилось и что повторяется, каждое наблюдение с его периодом, доказательствами и ограничениями; не диагнозы (руководство)
`get_pattern_evidence`	бета: каждый ресурс, связанный с одним наблюдением
`get_series`	бета: одно измерение как одно значение в день, с указанием качества данных
`compare_periods`	бета: одно измерение в двух выбранных вами периодах
`search_fhir`	стандартный поиск FHIR R4, возвращающий Bundle
`read_fhir_resource`	один ресурс или его более ранняя версия
`get_provenance`	кто создал ресурс, когда и из какой системы
`lookup_code`	коды LOINC по тексту или коду (для лекарств используйте `search_health_terms`)
`search_health_terms`	публичный каталог симптомов, состояний и методов лечения по названию на 20 языках, синониму, бренду или коду (руководство)
`get_health_term`	одна запись каталога с ее кодами, названиями, сводкой MedlinePlus, ссылками на источники и цитируемыми показаниями EMA / FDA
`validate_fhir_resource`	проверяет ресурс без его сохранения
`create_fhir_resource`	проверяет, затем записывает ресурс
`create_patient`	новый вымышленный пациент в проекте
`import_lab_report`	CSV, HL7 v2 ORU^R01 или JSON отчет о лабораторных исследованиях становится лабораторными наблюдениями
`sandbox_status`	записывает использованные сегодня данные, пациентов, хранилище, выполняет сброс
`reset_sandbox`	восстанавливает 30 синтетических пациентов (запрашивает подтверждение)

Инструменты для чтения помечены как доступные только для чтения, а сброс помечен как деструктивный, поэтому клиенты могут запрашивать подтверждение перед выполнением рискованных действий. Сервер также предлагает список синтетических пациентов в виде ресурса и три подсказки: сводка для клинициста, импорт CSV-файла лаборатории и создание вашей интеграции на основе API.

Как это работает

Те же правила, что и для API. Каждый инструмент вызывает публичный API с вашим ключом: те же области действия, ограничения скорости, валидация и аудит. Ключ только для чтения не может записывать.
Происхождение. Все, что записывает агент, фиксируется с указанием источника urn:anpheros:mcp, поэтому вы всегда можете определить, что было создано агентом.
Данные пациента — это данные. Результаты работы инструментов содержат примечание о том, что содержимое записей никогда не должно использоваться в качестве инструкций, что является базовой защитой от внедрения подсказок через медицинские записи.
Одна запись, с согласия. Ключи API для производственной среды (sk_live_…) отклоняются, поскольку они получают доступ ко всем пациентам проекта. Реальная запись попадает к ассистенту только через OAuth, после одобрения этого человека, и каждое чтение регистрируется в его истории доступа.
Стандартное обнаружение. Без учетных данных сервер отвечает кодом 401 с заголовком WWW-Authenticate, указывающим на метаданные его ресурса, защищенного OAuth (RFC 9728); ассистенты регистрируются через динамическую регистрацию клиентов (RFC 7591) с использованием PKCE. Регистрация принимает только loopback-адреса, схемы приложений известных редакторов и домены обратных вызовов известных AI-ассистентов.

Часто задаваемые вопросы

Что такое MCP сервер?

MCP (Model Context Protocol) — это открытый протокол, с помощью которого ИИ-агенты и помощники по написанию кода вызывают внешние инструменты. MCP сервер для FHIR позволяет агенту напрямую читать и записывать медицинские записи, вместо того чтобы вставлять данные в чат.

Это бесплатно?

Да. MCP сервер работает на бесплатном песочнице: 30 синтетических пациентов на проект, до 10 000 записей в день, без карты.

Может ли помощник прочитать запись реального пациента?

Только через OAuth, после того как человек одобрит помощника на экране согласия, на выбранный им период, и только его собственную запись (или запись того, кого он опекает). Во время закрытого бета-тестирования OAuth-соединения используют записи песочницы.

Какую версию FHIR он использует?

HL7 FHIR R4 (4.0.1), тот же API, что и https://platform.anpheros.com/fhir/R4, с International Patient Summary, и REST-представление тех же данных.

Работает ли это с ChatGPT?

Коннекторы ChatGPT используют OAuth с динамической регистрацией клиента, которую сервер поддерживает, и его домен обратного вызова принимается. Мы протестировали поток с официальным клиентом MCP SDK; если соединение ChatGPT не удается, напишите на [email protected]. Claude Code, Cursor и VS Code также работают с ключом песочницы.

Связанные материалы

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