Připojit Claude Code

Používejte Claude Code nebo desktopovou aplikaci Claude s modely, MCP nástroji a dovednostmi přes Unity Gateway. Pro Claude Code použijte Unity Gateway CLI (ug) nebo nakonfigurujte připojení ručně. Pro desktopovou aplikaci nastavte připojení v nastavení aplikace.

Než začnete

Potřebujete URL svého Azure Databricks workspace a přístup k modelům, které chcete používat. Pro nastavení desktopu nainstalujte nejnovější desktopovou aplikaci Claude a požádejte správce účtu o ID klienta OAuth, jak je popsáno níže.

Pokud už váš administrátor vaše zařízení nakonfiguroval, postupujte podle pokynů pro přihlášení a spuštění organizace.

Kód Claude

Instalujte , poté spusťte ugtento příkaz z adresáře vašeho projektu:

ug claude

Postupujte podle pokynů k výběru pracovního prostoru a přihlášení. ug konfiguruje spojení a otevírá Claude Code ve vašem terminálu. Začněte pracovat se stejnými prompty a příkazy, které už používáte. Pro změnu modelu zadejte /model.

Chcete-li přidat nástroje nebo dovednosti MCP, spusťte tyto příkazy ve svém terminálu a poté restartujte Claude Code:

ug mcp add
ug skills add

Každý příkaz vám umožní vybrat, co chcete přidat. Podrobnosti najdete v článku Přidat nástroje a dovednosti .

Ručně konfigurujte Claude Code

Sloučete následující nastavení do ~/.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"
  }
}

Nahraďte <workspace-hostname> ho názvem hostitele vašeho pracovního prostoru, bez https://. Nastavte <model-api-name> na plný název Unity Catalog API modelu Claude, ke kterému máte přístup, a zadejte svůj osobní přístupový token Azure Databricks.

Spusť claude z adresáře projektu. Pro další nastavení viz nastavení Claude Code.

Přidejte nástroje MCP ručně

Najděte třídílné jméno MCP služby pod Unity Gateway > MCPs ve vašem pracovním prostoru a zaregistrujte jej pomocí Claude Code:

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>"

Nahraďte název hostitele a název služby. Otevřete Claude kód, zadejte /mcp, a ověřte server svým účtem Azure Databricks. Opakujte s jiným názvem serveru pro každou službu, kterou chcete přidat.

Spojte dovednosti ručně

Pro zpřístupnění publikovaných dovedností Unity Gateway jako nástrojů zaregistrujte registr dovedností jako HTTP MCP server:

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>"

Nahraďte zástupné symboly svým pracovním prostorem, tokenem a schématem dovedností. Ponechte koncové lomítko před ?schema. Pro zahrnutí více schémat opakujte parametr ?schema=main.default&schema=ml.prod: .

Restartujte Claude Code a zkontrolujte spojení pomocí /mcp. Požádejte Clauda, aby použil dovednost pod jejím plným názvem, například Use <catalog>.<schema>.<skill-name> to review this query. Toto spojení vystavuje dovednosti jako nástroje MCP; ug skills add místo toho stahuje dovednosti pro nativní objevování.

Claude desktopová aplikace

1. Získejte OAuth client ID

Požádejte správce účtu, aby vytvořil připojení k aplikaci OAuth. V konzoli účtu Azure Databricks otevřete Nastavení > připojení > k aplikaci Přidejte připojení a použijte:

Setting Value
Typ identityt Standardní aplikace
Název aplikace claude-desktop
Vygenerování tajného klíče klienta Nezaškrtnuto (veřejný klient)
Adresa URL pro přesměrování http://127.0.0.1:53180/callback
Přístupové rozsahy ai-gateway

Uložte spojení a zkopírujte ID klienta. Pokud plánujete propojit dovednosti, zaregistrujte také http://127.0.0.1:53280/callback.

2. Připojit se k Unity Gateway

Na přihlašovací obrazovce desktopové aplikace vyberte Nápověda > Řešení problémů > Povolit vývojářský režim a poté Vývojář > Konfigurovat inferenci třetích stran.

Na stránce Připojení vyberte Bránu a zadať:

Setting Value
Typ přihlašovacího údaje Interaktivní přihlášení
Základní adresa URL brány https://<workspace-hostname>/ai-gateway/anthropic
ID klienta Vaše OAuth klientské ID
URL vydavatele https://<workspace-hostname>/oidc
Nosný token Token přístupu
Rozsah působnosti ai-gateway
Připojit offline_access Enabled
Přesměrování portu 53180

Nahraďte <workspace-hostname> názvem hostitele vašeho pracovního prostoru Azure Databricks. Ostatní nastavení nechte na výchozích nastaveních. Podrobnosti o polích naleznete v části konfigurace brány Anthropic.

Klikněte na Test connection a přihlásit se do Azure Databricks. Vyberte Použít změny, poté Uložit a obnovit. Na přihlašovací obrazovce zvolte konfiguraci třetí strany a začněte konverzaci v Code nebo Coworku.

3. Přidat nástroje a dovednosti MCP

Open Developer > Konfigurujte konektory pro inferenci > třetích stran. V sekci Spravované MCP servery přidejte položku pro každou MCP službu nebo registr dovedností, který chcete použít.

Použijte tato nastavení pro oba typy konektorů:

Setting Value
Transport Streamovatelné HTTP
OAuth Přiveďte si vlastního klienta
ID klienta Vaše OAuth klientské ID
Tajemství klienta Ponechte prázdné.
Autorizační server ["https://<workspace-hostname>/oidc"]
Scope ai-gateway
Požadavek offline_access Enabled
Hostitel zpětného volání 127.0.0.1

Pro službu MCP najděte její třídílný název pod Unity Gateway > MCPs ve vašem pracovním prostoru. Pojmenujte konektor popisným názvem, nastavte port zpětného volání na 53180 a použijte tuto adresu URL:

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

Pro funkci Skills zadejte název konektoru databricks-skill-registry, nastavte Port zpětného volání na 53280 a použijte:

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

Ponechte koncové lomítko před ?schema. Pro zahrnutí více schémat opakujte parametr ?schema=main.default&schema=ml.prod: . Tyto dovednosti jsou Claudovi zpřístupněny jako nástroje prostřednictvím konektoru.

Pro každý konektor klikněte na Přihlásit se a otestovat a dokončit přihlášení. Vyberte Použít změny, poté Uložit a obnovit. Požádejte Clauda, aby použil nějaký propojený nástroj nebo dovednost pod celým názvem. Viz Přidat nástroje a dovednosti pro požadavky na přístup a další možnosti.

Troubleshooting

Claude Code se nepřipojí: Spusťte ug doctor pokud používáte ug. Pro ruční nastavení zkontrolujte název hostitele v pracovním prostoru, token, název modelu a oprávnění modelu.

Přihlášení v desktopové aplikaci se nezdaří: Zkontrolujte ID klienta, /oidc vydavatele, a ai-gateway rozsah oprávnění. Registrovaná URL přesměrování musí odpovídat hostiteli a portu konektoru: 53180 pro modely a MCP služby, nebo 53280 pro dovednosti uvedené v tomto průvodci. Změny v aplikaci OAuth mohou trvat až 30 minut, než se projeví.

Chybí desktopový model: Zkontrolujte oprávnění modelu. V části Connection > Models > Model list přidejte úplný název modelu z katalogu Unity Catalog. Explicitní seznam nahrazuje automatické objevování, takže zahrňte všechny modely, které chcete použít. Aplikujte změny a restartujte.

Pokud dojde k selhání konektoru MCP nebo konektoru dovedností: Zkontrolujte jeho adresu URL a oprávnění. Pole serveru autorizace musí obsahovat pole JSON uvedené výše. Klikněte na Přihlásit se a otestovat a zkontrolujte chybu.

Další kroky

  • Last updated on