Esta página foi traduzida pela API Cloud Translation.

Use a Cloud Healthcare API com o MCP e outros agentes

Este guia mostra-lhe como usar a caixa de ferramentas da MCP para bases de dados para ligar a API Cloud Healthcare a vários ambientes de desenvolvimento integrado (IDEs) e ferramentas para programadores. Utiliza o protocolo Model Context Protocol (MCP), um protocolo aberto para ligar modelos de linguagem (conteúdo extenso) (MDIs/CE) a origens de dados, como conjuntos de dados de cuidados de saúde, o que lhe permite pesquisar e interagir com dados de cuidados de saúde diretamente a partir das suas ferramentas existentes.

Este guia demonstra o processo de associação para os seguintes IDEs:

Cursor
Windsurf (anteriormente Codeium)
Visual Studio Code (Copilot)
Cline (extensão do VS Code)
Claude para computador
Código do Claude

Antes de começar

Na Google Cloud consola, na página do seletor de projetos, selecione ou crie um Google Cloud projeto.
Certifique-se de que a faturação está ativada para o seu Google Cloud projeto.
Ative a Cloud Healthcare API no Google Cloud projeto.
Configure as funções e as autorizações necessárias para concluir esta tarefa. Precisa da função Leitor de recursos FHIR de cuidados de saúde (roles/healthcare.fhirResourceReader) e da função Visualizador DICOM de cuidados de saúde (roles/healthcare.dicomViewer) ou de autorizações IAM equivalentes para se ligar ao projeto.
Configure as Credenciais padrão da aplicação (ADC) para o seu ambiente.

Instale a caixa de ferramentas do MCP

O conjunto de ferramentas funciona como um servidor de protocolo Model Context Protocol (MCP) de código aberto que se encontra entre o seu IDE e a Cloud Healthcare API, oferecendo um plano de controlo seguro e eficiente para as suas ferramentas de IA.

Transfira a versão mais recente da caixa de ferramentas do MCP como um ficheiro binário. Selecione o binário correspondente ao seu sistema operativo (SO) e arquitetura da CPU. Tem de usar a caixa de ferramentas do MCP versão v0.19.1 ou posterior:
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
Substitua VERSION pela versão da caixa de ferramentas do MCP, por exemplo, v0.19.1.
macOS darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox
Substitua VERSION pela versão da caixa de ferramentas do MCP, por exemplo, v0.19.1.
macOS darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox
Substitua VERSION pela versão da caixa de ferramentas do MCP, por exemplo, v0.19.1.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox
Substitua VERSION pela versão da caixa de ferramentas do MCP, por exemplo, v0.19.1.
Torne o ficheiro binário executável:
```
chmod +x toolbox
```
Valide a instalação:
```
./toolbox --version
```

Configure clientes e associações

Esta secção explica como associar a Cloud Healthcare API às suas ferramentas.

Código do Claude

Instale o Claude Code.
Crie um ficheiro .mcp.json na raiz do projeto, se ainda não existir.

Adicione a configuração, substitua as variáveis de ambiente pelos seus valores e guarde:

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

Reinicie o Claude Code para carregar as novas definições. Quando reabre, a ferramenta indica que o servidor MCP configurado foi detetado.

Claude para computador

Abra o Claude Desktop e navegue para Definições.
No separador Programador, clique em Editar configuração para abrir o ficheiro de configuração.

Adicione a configuração, substitua as variáveis de ambiente pelos seus valores e guarde:

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

Reinicie o Claude Desktop.
O novo ecrã de chat apresenta um ícone de martelo (MCP) com o novo servidor MCP.

Cline

Abra a extensão Cline no VS Code e toque no ícone Servidores MCP.
Toque em Configurar servidores MCP para abrir o ficheiro de configuração.

Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde:

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

É apresentado um estado ativo verde depois de o servidor se ligar com êxito.

Cursor

Crie o diretório .cursor na raiz do projeto se não existir.
Cria o ficheiro .cursor/mcp.json se não existir e abre-o.

Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde:

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

Abra o Cursor e navegue para Definições > Definições do cursor > MCP. É apresentado um estado ativo verde quando o servidor se liga.

Visual Studio Code (Copilot)

Abra o VS Code e crie um diretório .vscode na raiz do projeto, se ainda não existir.
Crie o ficheiro .vscode/mcp.json se não existir e abra-o.

Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde:

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

Atualize a janela do VS Code. A extensão compatível com MCP deteta automaticamente a configuração e inicia o servidor.

Windsurf

Abra o Windsurf e navegue para o assistente Cascade.
Clique no ícone do MCP e, de seguida, clique em Configurar para abrir o ficheiro de configuração.

Adicione a seguinte configuração, substitua as variáveis de ambiente pelos seus valores e guarde:

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

          }
        }

Nota: a variável de ambiente HEALTHCARE_PROJECTespecifica o ID do projeto Google Cloud predefinido que a caixa de ferramentas do MCP deve usar. Todas as operações, como a pesquisa de pacientes ou a procura de instâncias DICOM, são executadas neste projeto.

Use as ferramentas

A sua ferramenta de IA está agora ligada à Cloud Healthcare API através do MCP. Experimente pedir ao seu assistente de IA para pesquisar pacientes FHIR, obter registos de um determinado paciente, procurar um estudo DICOM ou listar os arquivos DICOM no conjunto de dados.

As seguintes ferramentas estão disponíveis para o LLM:

get_dataset: obtém os detalhes de um conjunto de dados.
list_datasets: apresenta os conjuntos de dados de saúde num projeto.
list_fhir_stores: apresenta em lista os armazenamentos de FHIR no conjunto de dados especificado.
list_dicom_stores: apresenta em lista os armazenamentos DICOM no conjunto de dados especificado.
get_fhir_store: recebe a configuração do FHIR store especificado.
get_fhir_store_metrics: recebe métricas associadas ao FHIR store.
get_fhir_resource: recebe o conteúdo de um recurso FHIR.
get_fhir_resource_version: recebe o conteúdo de uma versão (atual ou do histórico) de um recurso FHIR.
fhir_patient_everything: obtém um recurso FHIR Patient e recursos relacionados com esse paciente.
fhir_patient_search: pesquisa recursos de pacientes FHIR na loja FHIR de acordo com os critérios especificados.
get_dicom_store: recebe a configuração da loja DICOM especificada.
get_dicom_store_metrics: recebe métricas associadas ao arquivo DICOM.
search_dicom_studies: devolve uma lista de estudos DICOM correspondentes.
search_dicom_series: devolve uma lista de séries DICOM correspondentes.
search_dicom_instances: devolve uma lista de instâncias DICOM correspondentes.
retrieve_dicom_instance_rendered: devolve uma codificação base64 de uma imagem renderizada no formato JPEG para uma instância DICOM associada ao estudo, à série e ao UID da instância SOP especificados.

Use a Cloud Healthcare API com o MCP e outros agentes Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Instale a caixa de ferramentas do MCP

linux/amd64

macOS darwin/arm64

macOS darwin/amd64

windows/amd64

Configure clientes e associações

Código do Claude

Claude para computador

Cline

Cursor

Visual Studio Code (Copilot)

Windsurf

Use as ferramentas

Use a Cloud Healthcare API com o MCP e outros agentes