Esta página se ha traducido con Cloud Translation API.

Usar la API Cloud Healthcare con MCP y otros agentes

En esta guía se explica cómo usar MCP Toolbox for Databases para conectar la API Cloud Healthcare a varios entornos de desarrollo integrado (IDEs) y herramientas para desarrolladores. Utiliza Model Context Protocol (MCP), un protocolo abierto para conectar modelos de lenguaje extensos (LLMs) a fuentes de datos, como conjuntos de datos sanitarios, lo que te permite buscar e interactuar con datos sanitarios directamente desde tus herramientas.

En esta guía se muestra el proceso de conexión de los siguientes IDEs:

Cursor
Windsurf (antes Codeium)
Visual Studio Code (Copilot)
Cline (extensión de VS Code)
Claude para ordenadores
Código de Claude

Antes de empezar

En la Google Cloud consola, en la página del selector de proyectos, selecciona o crea un Google Cloud proyecto.
Asegúrate de que la facturación esté habilitada en tu Google Cloud proyecto.
Habilita la API Cloud Healthcare en el Google Cloud proyecto.
Configura los roles y permisos necesarios para completar esta tarea. Necesitarás el rol Lector de recursos FHIR de Healthcare (roles/healthcare.fhirResourceReader) y el rol Lector de imágenes DICOM de Healthcare (roles/healthcare.dicomViewer), o permisos de gestión de identidades y accesos equivalentes, para conectarte al proyecto.
Configura las credenciales predeterminadas de la aplicación (ADC) en tu entorno.

Instalar MCP Toolbox

La caja de herramientas actúa como un servidor Model Context Protocol (MCP) de código abierto que se encuentra entre tu IDE y la API Cloud Healthcare, lo que proporciona un plano de control seguro y eficiente para tus herramientas de IA.

Descarga la última versión de MCP Toolbox como archivo binario. Selecciona el binario correspondiente a tu sistema operativo y a la arquitectura de tu CPU. Debes usar la versión v0.19.1 o una posterior de MCP Toolbox:
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
Sustituye VERSION por la versión de MCP Toolbox (por ejemplo, v0.19.1).
macOS darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox
Sustituye VERSION por la versión de MCP Toolbox (por ejemplo, v0.19.1).
macOS darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox
Sustituye VERSION por la versión de MCP Toolbox (por ejemplo, v0.19.1).
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox
Sustituye VERSION por la versión de MCP Toolbox (por ejemplo, v0.19.1).
Haz que el archivo binario sea ejecutable:
```
chmod +x toolbox
```
Verifica la instalación:
```
./toolbox --version
```

Configurar clientes y conexiones

En esta sección se explica cómo conectar la API Cloud Healthcare a tus herramientas.

Código de Claude

Instala Claude Code.
Crea un archivo .mcp.json en la raíz de tu proyecto, si no existe.

Añade la configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Reinicia Claude Code para cargar los nuevos ajustes. Cuando se vuelva a abrir, la herramienta indicará que se ha detectado el servidor de MCP configurado.

Claude para ordenadores

Abre Claude Desktop y ve a Configuración.
En la pestaña Desarrollador, haz clic en Editar configuración para abrir el archivo de configuración.

Añade la configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Reinicia Claude Desktop.
En la nueva pantalla de chat se muestra un icono de martillo (MCP) con el nuevo servidor MCP.

Cline

Abre la extensión Cline en VS Code y toca el icono Servidores MCP.
Toca Configurar servidores MCP para abrir el archivo de configuración.

Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Si el servidor se conecta correctamente, aparecerá el estado activo en verde.

Cursor

Crea el directorio .cursor en la raíz de tu proyecto si no existe.
Crea el archivo .cursor/mcp.json si no existe y ábrelo.

Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Abre Cursor y ve a Configuración > Configuración del cursor > MCP. El estado activo de color verde aparece cuando el servidor se conecta.

Visual Studio Code (Copilot)

Abre VS Code y crea un directorio .vscode en la raíz de tu proyecto si no existe.
Crea el archivo .vscode/mcp.json si no existe y ábrelo.

Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

        {
          "servers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }
          }
        }

Vuelve a cargar la ventana de VS Code. La extensión compatible con MCP detecta automáticamente la configuración e inicia el servidor.

Windsurf

Abre Windsurf y ve al asistente de Cascade.
Haz clic en el icono de MCP y, a continuación, en Configurar para abrir el archivo de configuración.

Añade la siguiente configuración, sustituye las variables de entorno por tus valores y guarda los cambios:

        {
          "mcpServers": {
            "healthcare": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-healthcare","--stdio"],
              "env": {
                "HEALTHCARE_PROJECT": "PROJECT_ID",
                "HEALTHCARE_REGION": "REGION",
                "HEALTHCARE_DATASET": "DATASET_ID"
              }
            }

          }
        }

Nota: La variable de entorno HEALTHCARE_PROJECT especifica el ID de proyecto predeterminado Google Cloud que debe usar MCP Toolbox. Todas las operaciones, como buscar pacientes o consultar instancias DICOM, se ejecutan en este proyecto.

Usar las herramientas

Tu herramienta de IA ahora está conectada a la API Cloud Healthcare mediante MCP. Prueba a pedirle a tu asistente de IA que busque pacientes de FHIR, que consulte los registros de un paciente concreto, que busque un estudio DICOM o que muestre los almacenes DICOM del conjunto de datos.

El LLM tiene acceso a las siguientes herramientas:

get_dataset obtiene los detalles de un conjunto de datos.
list_datasets: muestra los conjuntos de datos sanitarios de un proyecto.
list_fhir_stores: muestra los almacenes FHIR del conjunto de datos especificado.
list_dicom_stores: muestra los almacenes DICOM del conjunto de datos especificado.
get_fhir_store: obtiene la configuración del almacén FHIR especificado.
get_fhir_store_metrics obtiene las métricas asociadas al almacén FHIR.
get_fhir_resource: obtiene el contenido de un recurso FHIR.
get_fhir_resource_version obtiene el contenido de una versión (actual o histórica) de un recurso FHIR.
fhir_patient_everything obtiene un recurso Patient de FHIR y los recursos relacionados con ese paciente.
fhir_patient_search busca recursos de pacientes FHIR en el almacén FHIR según los criterios especificados.
get_dicom_store: obtiene la configuración del almacén DICOM especificado.
get_dicom_store_metrics: obtiene las métricas asociadas al almacén DICOM.
search_dicom_studies: devuelve una lista de estudios DICOM coincidentes.
search_dicom_series: devuelve una lista de series DICOM coincidentes.
search_dicom_instances: devuelve una lista de instancias DICOM coincidentes.
retrieve_dicom_instance_rendered: devuelve una codificación en Base64 de una imagen renderizada en formato JPEG de una instancia DICOM asociada al estudio, la serie y el SOP Instance UID proporcionados.

Usar la API Cloud Healthcare con MCP y otros agentes Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Antes de empezar

Instalar MCP Toolbox

linux/amd64

macOS darwin/arm64

macOS darwin/amd64

windows/amd64

Configurar clientes y conexiones

Código de Claude

Claude para ordenadores

Cline

Cursor

Visual Studio Code (Copilot)

Windsurf

Usar las herramientas

Usar la API Cloud Healthcare con MCP y otros agentes