电子病历与人工智能医疗助手集成：FHIR记录、上下文API和MCP服务器

将语言模型连接到病历时，在第一次提示之前会引发三个问题：模型看到什么，谁允许它看到，以及当它想写回什么时会发生什么。Anpheros Platform 在 API 中回答了这三个问题，因此您构建的助手（或您的用户已有的助手）可以在不自行制定规则的情况下处理病历。本指南涵盖了上下文 API、MCP 服务器和提案流程。

面向开发者的技术版本： AI 医疗助手 · MCP 服务器 在 developers.anpheros.com 上，包含请求、响应和限制。本页面是通俗易懂的版本。

模型看到什么：上下文 API

POST /v1/context 在您设置的令牌预算内构建一个适合 AI 读取的患者摘要。每个项目都带有 author_type（患者、执业者、设备、导入、派生）及其来源，因此模型可以区分实验室值、自我报告的症状以及医生的诊断和猜测。预算决定了首先包含哪些内容：活动问题、当前用药、过敏、近期结果，然后是其余内容。您会收到带标签的部分，或者使用 format: "text"，会收到一个准备好用于提示的渲染块，外加一个 omitted 列表，列出了未包含的内容。

curl -X POST "$BASE/v1/context" \
     -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
     -d '{"patient": "'$PID'", "budget_tokens": 2000, "task": "pre-visit summary", "format": "text"}'

相同的来源标签也是日后可辩护的依据：助手的摘要可以说明每个陈述的来源。

谁允许它：同意，而非配置

上述调用中的令牌来自个人，通过 OAuth 2.1 和 PKCE，并带有他们选择的范围和时长。AI 应用程序与其他任何应用程序一样进行注册，与其他任何应用程序一样请求，并列在个人的“连接”中。撤销会在下一次请求时停止它。仅凭项目密钥只能看到项目创建的患者；它绝不能替代同意。

写回：提案，而非写入

由注册为 AI 代理的应用程序在个人同意下进行的写入将被保留。平台会验证它，响应 202 Accepted 并附带一个提案 ID，但不会更改任何内容。个人会看到提案、其内容以及发送它的助手，并接受或拒绝它。接受的提案将按发送时的原样写入，并根据 HL7 的 AI 透明度指南标记为 AI 编写。可以查看病历的项目会收到一个精简的 proposal.created 网页钩子。

这是让助手有用的规则（“我注意到您提到了新药，要不要添加？”），但它永远不会成为记录的作者。

MCP 服务器

支持模型上下文协议（Model Context Protocol）的助手直接连接到 https://platform.anpheros.com/mcp（可流式传输的 HTTP）。个人通过 OAuth 连接，在自己的病历上进行操作；开发者可以使用沙盒密钥连接到 30 位合成患者。工具是您从 API 中期望的：

• list_patients、get_patient_context、get_patient_summary（国际患者摘要）、get_timeline
• get_health_patterns、get_pattern_evidence、get_series、compare_periods（变化和复发的内容，附带证据；非诊断）
• search_fhir、read_fhir_resource、get_provenance、lookup_code
• validate_fhir_resource、create_fhir_resource、create_patient、import_lab_report
• sandbox_status、reset_sandbox

服务器在 MCP 注册表中列为 com.anpheros/fhir。Claude、ChatGPT 和其他客户端的设置请参见 developers.anpheros.com/guides/mcp。

私有模型和欧盟居民身份

平台不会代表您调用模型；它提供上下文并接受提案。由哪个模型读取上下文由您决定：托管 API、私有部署、医院自有硬件上的模型。病历本身保留在欧盟，位于 europe-west4 的 Cloud Run 中，每次访问都有来源和审计。

它不是什么

平台不进行诊断，也不推荐治疗，上下文 API 也不是临床决策支持。它在同意下，以带标签的方式向模型提供事实。模型所说内容的责任在于部署它的任何人。

常见问题

我可以将 ChatGPT 或 Claude 连接到患者病历吗？

可以，通过 MCP 服务器，在个人同意其自身病历的情况下通过 OAuth 进行。用于开发时，沙盒密钥可为助手提供 30 位合成患者。

AI 会写入病历吗？

只有作为个人批准的提案。AI 代理发送的任何内容都未经批准不会被应用，并且接受的条目会被标记为 AI 编写。

如何防止模型看到过多信息？

三种方式：个人授予的范围、这些范围上的类别过滤器，以及上下文调用中的令牌预算，它按临床相关性对项目进行排序并在达到预算时停止。

是否有适用于我自己的应用程序中的健康聊天机器人的 API？

是的。您的应用程序通过 OAuth 获取个人同意，调用上下文 API，将结果发送给您选择的模型，如果模型建议添加条目，则将其作为写入提交；平台将其转换为提案。TypeScript 和 Dart SDK 涵盖了这些调用。

数据在哪里处理？

病历存储在欧盟并从欧盟提供服务。模型在哪里运行由您决定；平台本身从不将病历数据发送到模型。