Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan Cloud Healthcare API dengan MCP dan agen lainnya

Panduan ini menunjukkan cara menggunakan MCP Toolbox for Databases untuk menghubungkan Cloud Healthcare API ke berbagai Lingkungan Pengembangan Terintegrasi (IDE) dan alat developer. Fitur ini menggunakan Model Context Protocol (MCP), sebuah protokol terbuka untuk menghubungkan model bahasa besar (LLM) ke sumber data seperti set data kesehatan, sehingga Anda dapat menelusuri dan berinteraksi dengan data kesehatan langsung dari alat yang ada.

Panduan ini menunjukkan proses koneksi untuk IDE berikut:

Kursor
Windsurf (sebelumnya Codeium)
Visual Studio Code (Copilot)
Cline (ekstensi VS Code)
Claude desktop
Kode Claude

Sebelum memulai

Di konsol Google Cloud , pada halaman pemilih project, pilih atau buat project Google Cloud .
Pastikan penagihan diaktifkan untuk Google Cloud project Anda.
Aktifkan Cloud Healthcare API di Google Cloud project.
Konfigurasi peran dan izin yang diperlukan untuk menyelesaikan tugas ini. Anda memerlukan peran Healthcare FHIR Resource Reader (roles/healthcare.fhirResourceReader) dan peran Healthcare DICOM Viewer (roles/healthcare.dicomViewer), atau izin IAM yang setara untuk terhubung ke project.
Konfigurasi Kredensial Default Aplikasi (ADC) untuk lingkungan Anda.

Menginstal MCP Toolbox

Toolbox ini berfungsi sebagai server Model Context Protocol (MCP) open source yang berada di antara IDE dan Cloud Healthcare API, sehingga menyediakan bidang kontrol yang aman dan efisien untuk alat AI Anda.

Download MCP Toolbox versi terbaru sebagai program biner. Pilih biner yang sesuai dengan sistem operasi (OS) dan arsitektur CPU Anda. Anda harus menggunakan MCP Toolbox versi v0.19.1 atau yang lebih baru:
linux/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
Ganti VERSION dengan versi MCP Toolbox, misalnya v0.19.1.
macOS darwin/arm64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox
Ganti VERSION dengan versi MCP Toolbox, misalnya v0.19.1.
macOS darwin/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox
Ganti VERSION dengan versi MCP Toolbox, misalnya v0.19.1.
windows/amd64
curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox
Ganti VERSION dengan versi MCP Toolbox, misalnya v0.19.1.
Jadikan biner sebagai file yang dapat dieksekusi:
```
chmod +x toolbox
```
Verifikasi penginstalannya:
```
./toolbox --version
```

Menyiapkan klien dan koneksi

Bagian ini menjelaskan cara menghubungkan Cloud Healthcare API ke alat Anda.

Kode Claude

Instal Claude Code.
Buat file .mcp.json di root project Anda, jika file tersebut belum ada.

Tambahkan konfigurasi, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

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

Mulai ulang Claude Code untuk memuat setelan baru. Saat dibuka kembali, alat ini akan memberikan indikasi bahwa server MCP yang dikonfigurasi telah terdeteksi.

Claude desktop

Buka Claude Desktop, lalu buka Setelan.
Di tab Developer, klik Edit Config untuk membuka file konfigurasi.

Tambahkan konfigurasi, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

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

Mulai ulang Claude Desktop.
Layar chat baru menampilkan ikon palu (MCP) dengan server MCP baru.

Cline

Buka ekstensi Cline di VS Code, lalu ketuk ikon MCP Servers.
Ketuk Configure MCP Servers untuk membuka file konfigurasi.

Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

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

Status aktif berwarna hijau akan muncul setelah server berhasil terhubung.

Kursor

Buat direktori .cursor di root project Anda jika belum ada.
Buat file .cursor/mcp.json jika tidak ada dan buka file tersebut.

Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

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

Buka Kursor, lalu buka Setelan > Setelan Kursor > MCP. Status aktif berwarna hijau muncul saat server terhubung.

Visual Studio Code (Copilot)

Buka VS Code dan buat direktori .vscode di root project Anda jika direktori tersebut belum ada.
Buat file .vscode/mcp.json jika tidak ada, lalu buka.

Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

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

Muat ulang jendela VS Code. Ekstensi yang kompatibel dengan MCP akan otomatis mendeteksi konfigurasi dan memulai server.

Windsurf

Buka Windsurf dan buka asisten Cascade.
Klik ikon MCP, lalu klik Configure untuk membuka file konfigurasi.

Tambahkan konfigurasi berikut, ganti variabel lingkungan dengan nilai Anda, lalu simpan:

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

          }
        }

Catatan: Variabel lingkungan HEALTHCARE_PROJECT menentukan Project ID Google Cloud default yang akan digunakan MCP Toolbox. Semua operasi, seperti menelusuri pasien atau mencari instance DICOM, dijalankan dalam project ini.

Menggunakan alat

Alat AI Anda kini terhubung ke Cloud Healthcare API menggunakan MCP. Coba minta asisten AI Anda untuk menelusuri pasien FHIR, mengambil data untuk pasien tertentu, mencari studi DICOM, atau mencantumkan penyimpanan DICOM dalam set data.

Alat berikut tersedia untuk LLM:

get_dataset: Mengambil detail set data.
list_datasets: Mencantumkan set data kesehatan dalam project.
list_fhir_stores: Mencantumkan penyimpanan FHIR dalam set data tertentu.
list_dicom_stores: Mencantumkan penyimpanan DICOM dalam set data tertentu.
get_fhir_store: Mendapatkan konfigurasi penyimpanan FHIR yang ditentukan.
get_fhir_store_metrics: Mendapatkan metrik yang terkait dengan penyimpanan FHIR.
get_fhir_resource: Mendapatkan konten resource FHIR.
get_fhir_resource_version: Mendapatkan konten versi (saat ini atau historis) resource FHIR.
fhir_patient_everything: Mengambil resource FHIR Patient dan resource yang terkait dengan pasien tersebut.
fhir_patient_search: Menelusuri resource pasien FHIR di FHIR store sesuai dengan kriteria yang ditentukan.
get_dicom_store: Mendapatkan konfigurasi penyimpanan DICOM yang ditentukan.
get_dicom_store_metrics: Mendapatkan metrik yang terkait dengan penyimpanan DICOM.
search_dicom_studies: Menampilkan daftar studi DICOM yang cocok.
search_dicom_series: Menampilkan daftar seri DICOM yang cocok.
search_dicom_instances: Menampilkan daftar instance DICOM yang cocok.
retrieve_dicom_instance_rendered: Menampilkan encoding base64 dari gambar yang dirender dalam format JPEG untuk instance DICOM yang terkait dengan studi, seri, dan SOP Instance UID tertentu.

Menggunakan Cloud Healthcare API dengan MCP dan agen lainnya Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Menginstal MCP Toolbox

linux/amd64

macOS darwin/arm64

macOS darwin/amd64

windows/amd64

Menyiapkan klien dan koneksi

Kode Claude

Claude desktop

Cline

Kursor

Visual Studio Code (Copilot)

Windsurf

Menggunakan alat

Menggunakan Cloud Healthcare API dengan MCP dan agen lainnya