Hubungkan Claude Code

Gunakan Claude Code atau aplikasi desktop Claude dengan model, alat MCP, dan keterampilan melalui Unity Gateway. Untuk Claude Code, gunakan Unity Gateway CLI (ug) atau konfigurasikan koneksi secara manual. Untuk aplikasi desktop, konfigurasikan koneksi di pengaturan aplikasi.

Untuk menghubungkan alat ke pengaturan Claude Code yang sudah ada, kunjungi Tambah alat MCP. Untuk Claude di web atau sesi desktop menggunakan akun Claude Anda, gunakan konektor Claude.

Prerequisites

Anda membutuhkan URL workspace Azure Databricks Anda dan akses ke model yang ingin Anda gunakan. Untuk pengaturan desktop, instal aplikasi desktop Claude terbaru dan minta admin akun Anda untuk ID klien OAuth, seperti dijelaskan di bawah.

Jika admin Anda sudah mengonfigurasi perangkat Anda, ikuti instruksi masuk dan peluncuran organisasi Anda.

Kode Claude

Gunakan CLI Unity Gateway (disarankan)

Instal, uglalu jalankan perintah ini dari direktori proyek Anda:

ug claude

Ikuti petunjuk untuk memilih ruang kerja Anda dan masuk. ug mengonfigurasi koneksi dan membuka Claude Code di terminal Anda. Mulailah bekerja dengan prompt dan perintah yang sama yang sudah Anda gunakan. Untuk mengubah model, masukkan /model.

Lanjutkan untuk Menambahkan alat MCP untuk menghubungkan data dan layanan. Untuk mengunduh keterampilan bersama, jalankan ug skills add dan pilih keterampilan yang Anda inginkan. Lihat Menambahkan alat dan keterampilan untuk opsi lebih lanjut.

Konfigurasikan Claude Code secara manual

Gabungkan pengaturan berikut ke dalam ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_MODEL": "<model-api-name>",
    "ANTHROPIC_BASE_URL": "https://<workspace-hostname>/ai-gateway/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<databricks-personal-access-token>",
    "ANTHROPIC_CUSTOM_HEADERS": "x-databricks-use-coding-agent-mode: true",
    "CLAUDE_CODE_USE_GATEWAY": "1",
    "ENABLE_PROMPT_CACHING_1H": "1",
    "ENABLE_TOOL_SEARCH": "true"
  }
}

Ganti <workspace-hostname> dengan nama host workspace Anda, tanpa https://. Atur <model-api-name> ke nama lengkap Unity Catalog dari API model Claude yang dapat Anda akses, dan berikan token akses pribadi Azure Databricks Anda.

Jalankan claude dari direktori proyek Anda. Untuk pengaturan lain, lihat pengaturan Claude Code.

Tambahkan alat MCP

Untuk menggunakan system.ai.dbsql, system.ai.sandbox, atau system.ai.web_search, admin akun harus mengaktifkan beta Unity Gateway dari halaman Pratinjau konsol akun. Lihat Kelola pratinjau akun.

Buka MCP Unity Gateway > di ruang kerja Anda. Pilih MCP bawaan atau daftarkan server MCP eksternal Anda.
Salin nama lengkap MCP, seperti system.ai.github atau <catalog>.<schema>.<service>.
Pastikan Anda memiliki akses ke MCP.
Setelah menginstal ug, tambahkan MCP ke Claude Code:
```
ug mcp add --agents claude --names <catalog>.<schema>.<service>
```
Ganti placeholder dengan nama yang Anda salin. Misalnya, gunakan --names system.ai.github untuk GitHub. Untuk memilih layanan secara interaktif, hilangkan --names.

Saat penyiapan awal, ikuti petunjuk untuk memilih ruang kerja Anda, masuk, dan memilih model. ug mengonfigurasi akses model dan MCP keduanya serta memperbarui kredensial. Mulai ulang Claude Code dengan ug claude, lalu uji alat.

Tambahkan alat MCP secara manual

Gunakan klien OAuth bawaan di bawah ini, atau konfigurasikan aplikasi OAuth Anda sendiri. Untuk menambahkan MCP dengan klien bawaan, jalankan:

claude mcp add --transport http --scope user \
  --client-id claude-code --callback-port 3118 \
  databricks-tools \
  "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service-name>"

Ganti nama host dan nama MCP. Ini menggunakan klien OAuth bawaan claude-code . Buka Claude Code, masukkan /mcp, dan masuk ke server dengan akun Azure Databricks Anda. Ulangi dengan nama server yang berbeda untuk setiap MCP yang ingin Anda tambahkan, lalu uji alat.

Gunakan aplikasi OAuth Anda sendiri

Minta admin akun membuka Pengaturan > Koneksi aplikasi > Tambahkan koneksi di konsol akun.
Masukkan nama seperti claude-code-mcp, hapus centang Hasilkan secret klien untuk klien publik, atur URL pengalihan ke http://localhost:8080/callback, dan pilih cakupan ai-gateway. Simpan dan salin Client ID. Lihat Buat aplikasi OAuth.

Daftarkan MCP menggunakan client ID tersebut dan port callback yang sesuai:

claude mcp add --transport http --scope user \
  --client-id <client-id> --callback-port 8080 \
  databricks-tools \
  "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>"

Buka Claude Code, masukkan /mcp, dan login. Jika organisasi Anda memerlukan klien confidential, tambahkan --client-secret ke perintah tersebut dan masukkan client secret saat diminta.

Uji alat MCP

Di Claude Code, masukkan /mcp dan periksa apakah server terhubung.
Minta Claude untuk mencantumkan alat server tersebut, lalu minta Claude melakukan operasi baca. Untuk GitHub, mintalah untuk menemukan masalah di repositori yang bisa Anda akses. Untuk server kustom, gunakan alat dan input yang Anda uji saat registrasi.
Jika panggilan alat meminta Anda untuk masuk, buka tautan login yang dikembalikan oleh MCP, selesaikan persetujuan penyedia, lalu coba lagi panggilan.
Periksa bahwa Claude melakukan panggilan alat dan mengembalikan hasilnya. Jawaban lewat pesan teks saja tidak bisa memverifikasi koneksi.

Untuk menggunakan data Azure Databricks, sambungkan ke system.ai.genie_one_mcp untuk pertanyaan bisnis atau system.ai.dbsql untuk SQL. Misalnya, minta SQL MCP untuk menjalankan SELECT 1 AS result.

Untuk izin, kebijakan, dan penggunaan, lihat Tata kelola MCP.

Hubungkan keterampilan secara manual

Untuk mengekspos keterampilan Unity Gateway yang dipublikasikan sebagai alat, daftarkan registri keterampilan sebagai server HTTP MCP:

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer <databricks-personal-access-token>" \
  databricks-skill-registry \
  "https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>"

Ganti placeholder dengan workspace, token, dan skema skill Anda masing-masing. Pertahankan garis miring penutup sebelum ?schema. Untuk menyertakan beberapa skema, ulangi parameter: ?schema=main.default&schema=ml.prod.

Restart Claude Code dan periksa koneksi dengan /mcp. Minta Claude menggunakan keahlian dengan nama lengkapnya, seperti Use <catalog>.<schema>.<skill-name> to review this query.. Koneksi ini menyajikan keahlian sebagai alat MCP; ug skills add mengunduh keahlian untuk deteksi bawaan sebagai gantinya.

Aplikasi desktop Claude

1. Dapatkan ID klien OAuth

Minta admin akun Anda untuk membuat koneksi aplikasi OAuth. Di konsol akun Azure Databricks, buka Settings > App connections > Tambahkan koneksi dan gunakan:

Setting	Nilai
Jenis identitas	Aplikasi standar
Nama aplikasi	`claude-desktop`
Buat rahasia klien	Tidak dicentang (klien publik)
URL Pengalihan	`http://127.0.0.1:53180/callback`
Cakupan akses	`ai-gateway`

Simpan koneksi dan salin Client ID. Jika Anda berencana menghubungkan keterampilan, juga daftar.http://127.0.0.1:53280/callback

2. Terhubung ke Unity Gateway

Dari layar masuk aplikasi desktop, pilih Bantuan > Pemecahan Masalah > Aktifkan Mode Pengembang, lalu Konfigurasi Pengembang > Inferensi Pihak Ketiga.

Di halaman Koneksi , pilih Gateway dan masukkan:

Setting	Nilai
Jenis kredensial	Masuk interaktif
URL dasar gateway	`https://<workspace-hostname>/ai-gateway/anthropic`
ID Pelanggan	ID klien OAuth Anda
URL Pengeluar Sertifikat	`https://<workspace-hostname>/oidc`
Token pembawa	Token akses
Scopes	`ai-gateway`
Tambahkan `offline_access`	Diaktifkan
Mengalihkan port	`53180`

Ganti <workspace-hostname> dengan nama host workspace Azure Databricks Anda. Biarkan pengaturan lain tetap di default. Lihat konfigurasi gateway Anthropic untuk detail setiap kolom.

Klik Uji koneksi dan masuk ke Azure Databricks. Pilih Terapkan Perubahan, lalu Simpan & Mulai Ulang. Di layar masuk, pilih konfigurasi pihak ketiga dan mulai percakapan di Code atau Cowork.

3. Tambahkan alat dan keterampilan MCP

Buka Developer > Konfigurasikan Konektor Inferensi Pihak Ketiga >. Di bawah Server MCP yang dikelola, tambahkan entri untuk setiap MCP atau registry keterampilan yang ingin Anda gunakan.

Gunakan pengaturan berikut untuk kedua jenis konektor:

Setting	Nilai
Transport	HTTP yang mendukung streaming
OAuth	Bawa klien Anda sendiri
ID Pelanggan	ID klien OAuth Anda
Rahasia klien	Biarkan kosong
Server otorisasi	`["https://<workspace-hostname>/oidc"]`
Ruang lingkup	`ai-gateway`
Permintaan `offline_access`	Diaktifkan
Host panggilan balik	`127.0.0.1`

Untuk MCP, temukan nama tiga bagiannya di bagian Unity Gateway > MCPs di workspace Anda. Berikan konektor nama deskriptif, atur port Callback ke 53180, dan gunakan URL ini:

https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service-name>

Untuk keterampilan, beri nama konektor databricks-skill-registry, atur port Callback ke 53280, dan gunakan:

https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>

Pertahankan garis miring penutup sebelum ?schema. Untuk menyertakan beberapa skema, ulangi parameter: ?schema=main.default&schema=ml.prod. Keterampilan ini diekspos kepada Claude sebagai alat melalui konektor.

Untuk setiap konektor, klik Masuk & uji dan selesaikan masuk. Pilih Terapkan Perubahan, lalu Simpan & Mulai Ulang. Minta Claude menggunakan alat yang terhubung atau skill dengan nama lengkapnya. Lihat Tambahkan alat dan keterampilan untuk persyaratan akses dan opsi lainnya.

Konektor Claude

Untuk system.ai.dbsql, pertama-tama aktifkan Unity Gateway beta.

Gunakan konektor khusus untuk menambahkan alat MCP Azure Databricks ke Claude di web atau desktop menggunakan akun Claude Anda.

Minta admin akun membuat klien OAuth. Untuk MCP, pilih cakupan ai-gateway dan daftarkan kedua URL pengalihan tersebut:
- https://claude.ai/api/mcp/auth_callback
- https://claude.com/api/mcp/auth_callback
Di Claude, buka Pengaturan > Konektor > Tambahkan konektor kustom.

Masukkan URL MCP:

https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>

Masukkan ID klien OAuth dan, untuk klien konfidensial, rahasianya. Klik Tambah dan selesaikan proses masuk.
Dalam percakapan, aktifkan konektor dan minta Claude memanggil salah satu alatnya. Untuk system.ai.dbsql, coba SELECT 1 AS result.

Jika workspace Anda membatasi IP masuk, izinkan IP keluar Claude. Lihat autentikasi dan jaringan MCP untuk izin, login provider, dan pemecahan masalah.

Gunakan token akses pribadi di desktop Claude untuk pengujian lokal

Opsi ini membutuhkan Node.js dengan npx dan token akses pribadi. Ini bekerja untuk MCP yang disediakan dan terdaftar oleh Databricks, serta endpoint workspace lama. Server yang dihosting di Databricks Apps memerlukan OAuth.

Gabungkan entri ini ke claude_desktop_config.json di ~/Library/Application Support/Claude/claude_desktop_config.json di macOS atau %APPDATA%\Claude\claude_desktop_config.json di Windows:

{
  "mcpServers": {
    "databricks-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>",
        "--header",
        "Authorization: Bearer <databricks-pat>"
      ]
    }
  }
}

Ganti placeholder, jaga token agar tidak masuk ke kontrol sumber, dan restart desktop Claude. Minta Claude untuk memanggil alat hanya-baca guna memverifikasi koneksi.

Troubleshooting

Claude Code tidak terhubung: Jalankan ug doctor jika Anda menggunakan ug. Untuk pengaturan manual, periksa nama host workspace, token, nama model, dan izin model Anda.
Login desktop gagal: Periksa ID klien, /oidc penerbit, dan ai-gateway cakupan. URL pengalihan yang terdaftar harus sesuai dengan host dan port konektor: 53180 untuk model dan MCP, atau 53280 untuk keterampilan dalam panduan ini. Perubahan aplikasi OAuth dapat memakan waktu hingga 30 menit untuk berlaku.
Model desktop tidak ditemukan: Periksa izin model Anda. Di bawah daftar Model Koneksi >>, tambahkan nama lengkap Unity Catalog model. Daftar eksplisit menggantikan penemuan otomatis, jadi sertakan semua model yang ingin Anda gunakan. Terapkan perubahan dan mulai ulang.
MCP atau konektor keterampilan gagal: Periksa URL dan izinnya. Bidang server Otorisasi harus berisi array JSON yang ditunjukkan di atas. Klik Masuk & uji untuk memeriksa error.
Login ke workspace berfungsi, tetapi sebuah alat meminta Anda untuk masuk: Buka tautan login yang dikembalikan oleh MCP, masuk ke penyedia eksternal, lalu coba lagi permintaan. Proses masuk ke Workspace dan penyedia adalah langkah yang terpisah.
Claude Code OAuth melaporkan ketidakcocokan pengalihan atau koneksi mengalami time out: Untuk aplikasi OAuth kustom, cocokkan URL pengalihannya dengan host callback dan port, lalu periksa akses jaringan. Perubahan aplikasi OAuth dapat memakan waktu hingga 30 menit untuk berlaku.

Langkah berikutnya

Saran dan Komentar

Apakah halaman ini membantu?

Terakhir diperbarui pada 2026-10-08