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

Servidor MCP FHIR para agentes de IA

Conecta Claude Code, Cursor, VS Code o Claude Desktop a una API HL7 FHIR R4 a través de MCP: 20 herramientas para leer registros, contexto listo para IA, escritura, importación de laboratorio y reinicio de sandbox, en 30 pacientes sintéticos, gratis.

Anpheros FHIR es un servidor MCP remoto que permite a un agente de IA (Claude, Claude Code, Cursor, VS Code, Claude Desktop) trabajar con una API de datos de salud HL7 FHIR R4. Se conecta de dos maneras:

• Con una clave de sandbox gratuita, para desarrolladores: su agente lista pacientes, lee sus registros como FHIR o como contexto listo para IA con procedencia, escribe observaciones, importa informes de laboratorio y reinicia sus datos de prueba, todo en 30 pacientes sintéticos con historiales realistas.
• Con OAuth, para una persona y su propio registro: el asistente se registra, la persona inicia sesión y lo aprueba en la pantalla de consentimiento de Anpheros, y el asistente puede entonces leer ese único registro, durante el período elegido, solo lectura a menos que la persona haya permitido más.

Dirección del servidor: https://platform.anpheros.com/mcp (HTTP Streamable, sin estado).

Conectar con OAuth (Claude y otros asistentes)

Añada https://platform.anpheros.com/mcp como un conector personalizado (en Claude: Settings → Connectors → Add custom connector). No hay nada más que configurar: el asistente descubre el servidor de autorización, se registra y abre la pantalla de consentimiento de Anpheros. Allí, la persona ve que se trata de un asistente de IA, que lo que lee se envía a la empresa que ejecuta el asistente, qué puede leer, durante cuánto tiempo y a dónde regresará después de elegir. El acceso es de solo lectura a menos que se haya solicitado y permitido más, y la persona puede revocarlo en cualquier momento.

Durante la beta privada, las conexiones OAuth utilizan registros de sandbox. Las conexiones a registros reales se abrirán después de que se actualice la política de privacidad.

Conéctate con una clave de sandbox (desarrolladores)

1. Inicia sesión en platform.anpheros.com/dashboard con Google y selecciona Obtener una clave de sandbox. Recibirás una clave sk_test_… y un proyecto con 30 pacientes sintéticos.
2. Coloca la clave en una variable de entorno, por ejemplo ANPHEROS_KEY, y añade el servidor a tu herramienta.

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 en el proyecto)

{
  "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, a través del puente 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_…" }
    }
  }
}

Luego, hazle a tu agente una pregunta como: "Lista los pacientes de sandbox, elige el que tiene diabetes y resume su HbA1c de los últimos seis meses."

Herramientas

Las herramientas de lectura están marcadas como de solo lectura y el reinicio está marcado como destructivo, por lo que los clientes que pregunten antes de acciones de riesgo pueden hacerlo. El servidor también ofrece la lista de pacientes sintéticos como un recurso y tres indicaciones: un resumen clínico, una importación de CSV de laboratorio y la construcción de tu integración en la API.

Cómo se comporta

• Las mismas reglas que la API. Cada herramienta llama a la API pública con su clave: los mismos ámbitos, límites de velocidad, validación y auditoría. Una clave de solo lectura no puede escribir.
• Procedencia. Todo lo que un agente escribe se registra con la fuente urn:anpheros:mcp, por lo que siempre se puede saber qué proviene de un agente.
• Los datos del paciente son datos. Los resultados de las herramientas llevan una nota que indica que el contenido del registro nunca debe seguirse como instrucciones, una protección básica contra la inyección de indicaciones a través de registros médicos.
• Un registro, con consentimiento. Las claves de API de producción (sk_live_…) son rechazadas, porque acceden a todos los pacientes de un proyecto. Un registro real llega a un asistente solo a través de OAuth, después de que esa persona lo aprueba, y cada lectura se registra en su historial de acceso.
• Descubrimiento estándar. Sin credenciales, el servidor responde con un 401 y un encabezado WWW-Authenticate que apunta a sus metadatos de recursos protegidos por OAuth (RFC 9728); los asistentes se registran a través del registro dinámico de clientes (RFC 7591), con PKCE. El registro solo acepta direcciones de loopback, los esquemas de aplicaciones de editores conocidos y los dominios de devolución de llamadas de asistentes de IA conocidos.

Preguntas frecuentes

¿Qué es un servidor MCP?

MCP (Model Context Protocol) es un protocolo abierto a través del cual los agentes de IA y los asistentes de codificación llaman a herramientas externas. Un servidor MCP para FHIR permite al agente leer y escribir registros de salud directamente, en lugar de que usted pegue datos en el chat.

¿Es gratis?

Sí. El servidor MCP funciona en el sandbox gratuito: 30 pacientes sintéticos por proyecto, hasta 10.000 escrituras al día, sin tarjeta.

¿Puede un asistente leer el registro de un paciente real?

Solo a través de OAuth, después de que esa persona apruebe al asistente en la pantalla de consentimiento, por el período que elija, y solo su propio registro (o el de alguien que cuida). Durante la beta privada, las conexiones OAuth utilizan registros de sandbox.

¿Qué versión de FHIR utiliza?

HL7 FHIR R4 (4.0.1), la misma API que https://platform.anpheros.com/fhir/R4, con el Resumen Internacional del Paciente y una vista REST de los mismos datos.

¿Funciona con ChatGPT?

Los conectores de ChatGPT utilizan OAuth con registro dinámico de clientes, que el servidor soporta, y su dominio de callback es aceptado. Hemos probado el flujo con el cliente oficial MCP SDK; si una conexión de ChatGPT falla, escriba a [email protected]. Claude Code, Cursor y VS Code también funcionan con una clave de sandbox.

Relacionado

• Cómo dar acceso a un agente de IA a historiales médicos: tutorial paso a paso en Python
• Base de datos FHIR y sandbox gratuitos
• Agentes de IA y datos médicos
• Aplicaciones LLM y datos de atención médica
• API de atención médica con consentimiento del paciente

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