Esta página foi traduzida pela API Cloud Translation.

Usar a API Cloud Healthcare com o MCP e outros agentes

Neste guia, mostramos como usar a MCP Toolbox para bancos de dados e conectar a API Cloud Healthcare a vários ambientes de desenvolvimento integrado (IDEs) e ferramentas para desenvolvedores. Ele usa o Protocolo de Contexto de Modelo (MCP), um protocolo aberto para conectar modelos de linguagem grandes (LLMs) a fontes de dados, como conjuntos de dados de saúde, permitindo que você pesquise e interaja com dados de saúde diretamente das suas ferramentas atuais.

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

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

Antes de começar

No console do Google Cloud , na página do seletor de projetos, selecione ou crie um projeto do Google Cloud .
Verifique se o faturamento está ativado para o projeto do Google Cloud .
Ative a API Cloud Healthcare no Google Cloud projeto.
Configure os papéis e as permissões necessárias para concluir essa tarefa. Você vai precisar do papel Leitor de recursos FHIR do Healthcare (roles/healthcare.fhirResourceReader) e do papel Leitor DICOM do Healthcare (roles/healthcare.dicomViewer) ou permissões equivalentes do IAM para se conectar ao projeto.
Configure as Credenciais padrão do aplicativo (ADC) para seu ambiente.

Instalar a MCP Toolbox

A caixa de ferramentas funciona como um servidor Protocolo de Contexto de Modelo (MCP) de código aberto que fica entre seu ambiente de desenvolvimento integrado e a API Cloud Healthcare, fornecendo um plano de controle seguro e eficiente para suas ferramentas de IA.

Faça o download da versão mais recente da MCP Toolbox como um binário. Selecione o binário correspondente ao seu sistema operacional (SO) e à arquitetura da CPU. Use a versão v0.19.1 ou mais recente da caixa de ferramentas do MCP:
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
Substitua VERSION pela versão da MCP Toolbox. 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 MCP Toolbox. 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 MCP Toolbox. 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 MCP Toolbox. Por exemplo, v0.19.1.
Torne o binário executável:
```
chmod +x toolbox
```
Verifique a instalação:
```
./toolbox --version
```

Configurar clientes e conexões

Esta seção explica como conectar a API Cloud Healthcare às suas ferramentas.

Código do Claude

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

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

        {
          "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 configurações. Quando ela for reaberta, a ferramenta vai indicar que o servidor MCP configurado foi detectado.

Claude para computador

Abra o Claude para computador e acesse Configurações.
Na guia Desenvolvedor, clique em Editar configuração para abrir o arquivo de configuração.

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

        {
          "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.
A nova tela de chat mostra 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 arquivo de configuração.

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

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

Um status ativo verde aparece depois que o servidor se conecta.

Cursor

Crie o diretório .cursor na raiz do projeto se ele não existir.
Crie o arquivo .cursor/mcp.json, se ele não existir, e abra-o.

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

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

Abra Cursor e navegue até Configurações > Configurações do cursor > MCP. Um status ativo verde aparece quando o servidor se conecta.

Visual Studio Code (Copilot)

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

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

        {
          "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 detecta automaticamente a configuração e inicia o servidor.

Windsurf

Abra o Windsurf e navegue até o assistente do Cascade.
Clique no ícone do MCP e em Configurar para abrir o arquivo de configuração.

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

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

          }
        }

Observação:a variável de ambiente HEALTHCARE_PROJECT especifica o ID do projeto Google Cloud padrão para uso da MCP Toolbox. Todas as operações, como pesquisar pacientes ou procurar instâncias DICOM, são executadas nesse projeto.

Usar as ferramentas

Sua ferramenta de IA agora está conectada à API Cloud Healthcare usando o MCP. Peça ao seu assistente de IA para pesquisar pacientes FHIR, recuperar registros de um paciente específico, procurar um estudo DICOM ou listar os armazenamentos DICOM no conjunto de dados.

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

get_dataset: recupera os detalhes de um conjunto de dados.
list_datasets: lista conjuntos de dados de saúde em um projeto.
list_fhir_stores: lista os armazenamentos de FHIR no conjunto de dados especificado.
list_dicom_stores: lista os repositórios DICOM no conjunto de dados especificado.
get_fhir_store: recebe a configuração do armazenamento FHIR especificado.
get_fhir_store_metrics: recebe métricas associadas ao repositório FHIR.
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 histórica) de um recurso FHIR.
fhir_patient_everything: recupera um recurso de paciente do FHIR e recursos relacionados a ele.
fhir_patient_search: pesquisa recursos de pacientes FHIR no armazenamento FHIR de acordo com os critérios especificados.
get_dicom_store: recebe a configuração do armazenamento DICOM especificado.
get_dicom_store_metrics: recebe métricas associadas ao armazenamento DICOM.
search_dicom_studies: retorna uma lista de estudos DICOM correspondentes.
search_dicom_series: retorna uma lista de séries DICOM correspondentes.
search_dicom_instances: retorna uma lista de instâncias DICOM correspondentes.
retrieve_dicom_instance_rendered: retorna uma codificação base64 de uma imagem renderizada no formato JPEG para uma instância DICOM associada ao estudo, série e UID da instância SOP especificados.

Usar a API Cloud Healthcare 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

Instalar a MCP Toolbox

linux/amd64

macOS darwin/arm64

macOS darwin/amd64

windows/amd64

Configurar clientes e conexões

Código do Claude

Claude para computador

Cline

Cursor

Visual Studio Code (Copilot)

Windsurf

Usar as ferramentas

Usar a API Cloud Healthcare com o MCP e outros agentes