---
{
  "title": "Servidor MCP FHIR",
  "description": "Recientemente añadimos soporte experimental para el servidor MCP en Aidbox. Exploremos cómo configurarlo y utilizarlo para interactuar con recursos FHIR a través de una interfaz LLM.",
  "date": "2025-05-09",
  "author": "Aleksandr Kislitsyn",
  "reading-time": "7 min",
  "tags": [
    "Integrations",
    "Aidbox",
    "AI / Agents"
  ]
}
---

> For the complete documentation index, see [llms.txt](https://www.health-samurai.io/llms.txt).
> Use it to discover all available pages before guessing URLs.

---
## Cómo configurar un servidor MCP FHIR

### 1. Inicie una nueva instancia de Aidbox

Comience ejecutando el siguiente comando en su terminal:


```javascript
curl -JO https://aidbox.app/runme/mcp && docker compose up
```


Este comando descargará el archivo de configuración de Docker Compose para la nueva instancia de Aidbox con el servidor MCP habilitado y, a continuación, iniciará los servicios.

### 2. Active su instancia de Aidbox

Abra su navegador y acceda a `[http://localhost:8080](http://localhost:8080)` para activar su instancia de Aidbox:
![MCP FHIR Server get instance](image-1.avif)
La obtención de una licencia de desarrollo es gratuita: solo tiene que registrarse en el [portal de usuarios de Aidbox](https://aidbox.app/ui/portal#/signin) y crear una nueva licencia de desarrollo.

### 3. Conecte su aplicación de escritorio LLM para usar el servidor MCP de Aidbox

Para utilizar el servidor MCP de Aidbox con su aplicación de escritorio LLM local —como Claude Desktop—, siga los pasos indicados a continuación:

##### Requisitos previos
Antes de comenzar, asegúrese de contar con:

- [Node.js v18](https://nodejs.org/en/download) o superior instalado.
- Todas las [versiones de Node.js anteriores a la v18](https://github.com/supercorp-ai/supergateway/issues/19) desinstaladas, ya que Claude Desktop puede no funcionar correctamente con versiones más antiguas.

##### Pasos de configuración para Claude Desktop
- Abra Configuración → Desarrollador → Editar configuración
- Actualice el archivo `claude_desktop_config.json` con el siguiente fragmento:


```javascript
{
  "mcpServers": {
    "aidbox": {
      "command": "npx",
      "args": [
        "-y",
        "@latitude-data/supergateway",
        "--sse",
        "http://localhost:8080/sse"
      ]
    }
  }
}
```


Para obtener información detallada sobre el servidor MCP de Aidbox y cómo configurar distintas aplicaciones LLM, visite: [https://www.health-samurai.io/docs/aidbox/modules/other-modules/mcp](https://www.health-samurai.io/docs/aidbox/modules/other-modules/mcp)

## Véalo en acción

Una vez configurado todo, estará listo para interactuar con su servidor FHIR mediante **Claude Desktop** con tecnología del protocolo MCP.

### Creación de un recurso Patient básico

Comenzaremos creando un recurso Patient básico:
![create patient in MCP FHIR Server](image-2.avif)
Se le solicitará que autorice a Claude a utilizar la herramienta externa:
![cloud for MCP FHIR Server](image-3.avif)
¡Listo! El recurso Patient ha sido creado:
![MCP FHIR Server result](image-4.avif)
Claude utilizó la herramienta `create-fhir-resource` para interactuar con el [servidor FHIR](https://www.health-samurai.io/fhir-server) y crear el recurso Patient. Para verificarlo, abra la consola de Aidbox ([http://localhost:8080](http://localhost:8080)), navegue hasta el Explorador de recursos y confirme que el Patient se creó correctamente:
![resource for MCP FHIR Server](image-5.avif)

### Creación de recursos relacionados

Demos un paso más y creemos un par de recursos relacionados:
![creating resource for MCP FHIR Server](image-6.avif)
Lo más interesante es que, durante la creación del recurso Task, Claude recibió retroalimentación de Aidbox, analizó la causa raíz de los problemas que surgieron y logró resolverlos de forma automática.

### Creación de un recurso conforme a un perfil

A continuación, crearemos un recurso que se ajuste a un perfil FHIR específico:
![create profile for MCP FHIR Server](image-7.avif)

## Pruébelo usted mismo

¡Ahora es su turno! La configuración de una instancia de desarrollo de [Aidbox](https://aidbox.app/) es completamente gratuita. Pruebe a integrar su propia aplicación LLM y comience a explorar cómo la inteligencia artificial puede optimizar sus flujos de trabajo FHIR.

Consulte también: [Cómo hicimos que la interfaz de Aidbox fuera compatible con agentes de IA mediante WebMCP](/blog/aidbox-ui-webmcp) y [Los agentes no son humanos](/blog/agents-are-not-humans).