Anslut Claude Code

Använd Claude Code eller Claude desktop-appen med modeller, MCP-verktyg och färdigheter via Unity Gateway. För Claude Code, använd Unity Gateway CLI (ug) eller konfigurera anslutningen manuellt. För skrivbordsappen, konfigurera anslutningen i appens inställningar.

För att koppla verktyg till en befintlig Claude Code-konfiguration, gå till Add MCP tools. För Claude på webben eller en skrivbordssession med ditt Claude-konto, använd Claude connectors.

Prerequisites

Du behöver din URL till Azure Databricks workspace och tillgång till de modeller du vill använda. För skrivbordsinstallation, installera den senaste Claude-skrivbordsappen och be din kontoadministratör om ett OAuth-klient-ID, som beskrivs nedan.

Om din administratör redan har konfigurerat din enhet, följ organisationens inloggnings- och startinstruktioner.

Claude Code

Använd Unity Gateway CLI (rekommenderas)

Installera ug, kör sedan detta kommando från din projektkatalog:

ug claude

Följ instruktionerna för att välja din arbetsplats och logga in. ug konfigurerar anslutningen och öppnar Claude Code i din terminal. Börja arbeta med samma prompts och kommandon som du redan använder. För att byta modell, ange /model.

Fortsätt att lägga till MCP-verktyg för att koppla samman data och tjänster. Om du vill ladda ner delade kunskaper kör du ug skills add och väljer de kunskaper du vill ha. Se avsnittet Lägg till verktyg och färdigheter för fler alternativ.

Konfigurera Claude Code manuellt

Slå ihop följande inställningar i ~/.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"
  }
}

Ersätt <workspace-hostname> med ditt arbetsområdesvärdnamn, utan https://. Sätt <model-api-name> till det fullständiga Unity Catalog-namnet på ett Claude-modell-API du kan komma åt, och tillhandahåll din personliga åtkomsttoken för Azure Databricks.

Kör claude från din projektkatalog. För andra inställningar, se Claude Code-inställningar.

Lägg till MCP-verktyg

För att använda system.ai.dbsql, system.ai.sandbox eller system.ai.web_search måste en kontoadministratör aktivera Unity Gateway-betan på kontokonsolens Previews-sida. Se Hantera förhandsversioner av konto.

1. Öppna Unity Gateway > MCP:er i din arbetsyta. Välj en inbyggd MCP eller registrera din externa MCP-server.

2. Kopiera MCP:ns fullständiga namn, såsom system.ai.github eller <catalog>.<schema>.<service>.

3. Bekräfta att du har tillgång till MCP.

4. Efter att du har installerat ug, lägg till MCP i Claude Code:

   ug mcp add --agents claude --names <catalog>.<schema>.<service>
   

   Byt ut platshållaren mot namnet du kopierade. Till exempel, använd --names system.ai.github för GitHub. För att välja tjänster interaktivt, utelämna --names.

Vid första installationen, följ instruktionerna för att välja din arbetsyta, logga in och välja en modell. ug konfigurerar både modell- och MCP-åtkomst samt uppdaterar inloggningsuppgifter. Starta om Claude Code med ug claude, testa sedan ett verktyg.

Lägg till MCP-verktyg manuellt

Använd den inbyggda OAuth-klienten nedan, eller konfigurera din egen OAuth-app. För att lägga till en MCP med den inbyggda klienten, kör:

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

Byt ut värdnamnet och MCP-namnet. Detta använder den inbyggda OAuth-klienten claude-code . Öppna Claude Code, ange /mcp, och logga in på servern med ditt Azure Databricks-konto. Upprepa med ett annat servernamn för varje MCP du vill lägga till, och testa sedan ett verktyg.

Testa ett MCP-verktyg

1. I Claude Code, ange /mcp och kontrollera att servern är ansluten.
2. Be Claude att lista serverns verktyg och begär sedan en läsoperation. För GitHub, be den hitta ett problem i ett repository du kan komma åt. För en anpassad server, använd ett verktyg och de indata du testade under registreringen.
3. Om ett verktygsanrop ber dig logga in, öppna inloggningslänken som MCP:n returnerat, fullfölj leverantörens samtycke och försök sedan anropet igen.
4. Kontrollera att Claude gör ett verktygsanrop och returnerar resultatet. Ett sms-svar ensamt verifierar inte kopplingen.

För att använda Azure Databricks-data, koppla upp system.ai.genie_one_mcp för affärsfrågor eller system.ai.dbsql för SQL. Till exempel, be SQL MCP att köra SELECT 1 AS result.

För behörigheter, policyer och användning, se Hantera en MCP.

Koppla färdigheter manuellt

För att exponera publicerade Unity Gateway-färdigheter som verktyg, registrera färdighetsregistret som en 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>"

Byt ut platshållarna mot din arbetsyta, tokenet och färdighetsschemat. Behåll det avslutande snedstrecket före ?schema. För att inkludera flera scheman, upprepa parametern: ?schema=main.default&schema=ml.prod.

Starta om Claude Code och kontrollera anslutningen med /mcp. Be Claude använda en färdighet med dess fullständiga namn, såsom Use <catalog>.<schema>.<skill-name> to review this query. Denna koppling exponerar färdigheter som MCP-verktyg; ug skills add laddar ner färdigheter för inhemsk upptäckt istället.

Claude skrivbordsapp

1. Få ett OAuth-klient-ID

Be din kontoadministratör att skapa en OAuth-applikationsanslutning. I Azure Databricks kontokonsol, öppna Inställningar > App-anslutningar > Lägg till anslutning och använd:

Spara anslutningen och kopiera klient-ID:t. Om du planerar att koppla ihop färdigheter, registrera http://127.0.0.1:53280/callbackdig också.

2. Koppla till Unity Gateway

Från skrivbordsappens inloggningsskärm, välj Hjälp > Felsökning > Aktivera Utvecklarläge och sedan Utvecklare > Konfigurera tredjepartsinferens.

På anslutningssidan, välj Gateway och skriv in:

Ersätt <workspace-hostname> med ditt Azure Databricks workspace-värdnamn. Lämna andra inställningar på standardinställningarna. Se Anthropic gateway-konfiguration för fältdetaljer.

Klicka på Testanslutning och logga in på Azure Databricks. Välj Tillämpa ändringar, sedan Spara & Starta om. På inloggningsskärmen väljer du tredjepartskonfigurationen och startar en konversation i Code eller Cowork.

3. Lägg till MCP-verktyg och färdigheter

Öppna utvecklare > konfigurerar tredjeparts inferenskopplingar>. Under Managed MCP-servrar lägger du till en post för varje MCP eller färdighetsregister du vill använda.

Använd dessa inställningar för båda typerna av kontakter:

För en MCP, hitta dess tredelade namn under Unity Gateway > MCPs i din arbetsyta. Ge anslutningen ett beskrivande namn, ställ in återanropsport på 53180, och använd denna URL:

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

För kompetenser, namnge anslutningen databricks-skill-registry, ange Callback-port till 53280, och använd:

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

Behåll det avslutande snedstrecket före ?schema. För att inkludera flera scheman, upprepa parametern: ?schema=main.default&schema=ml.prod. Dessa färdigheter exponeras för Claude som verktyg genom kopplingen.

För varje kontakt, klicka på Logga in & test och slutför inloggningen. Välj Tillämpa ändringar, sedan Spara & Starta om. Be Claude använda ett anslutet verktyg eller en färdighet med dess fullständiga namn. Se Lägg till verktyg och färdigheter för åtkomstkrav och fler alternativ.

Claude-anslutningar

För system.ai.dbsql, aktivera först Unity Gateway beta.

Använd en anpassad connector för att lägga till Azure Databricks MCP-verktyg till Claude på webben eller skrivbordet med ditt Claude-konto.

1. Låt en kontoadministratör skapa en OAuth-klient. För en MCP, välj ai-gateway scope och registrera båda omdirigerings-URL:erna:

   • https://claude.ai/api/mcp/auth_callback
   • https://claude.com/api/mcp/auth_callback

2. I Claude-appen öppna Inställningar > Connectors > Lägg till en egen connector.

3. Ange MCP-URL:

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

4. Ange OAuth-klient-ID:t och, för en konfidentiell klient, klienthemligheten. Klicka på Lägg till och slutför inloggningen.

5. I en konversation, aktivera connectorn och be Claude anropa ett av dess verktyg. För system.ai.dbsql, försök SELECT 1 AS result.

Om din arbetsplats begränsar inkommande IP-adresser, tillåt Claude utgående IP-adresser. Se MCP-autentisering och nätverk för behörigheter, leverantörsinloggning och felsökning.

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

Troubleshooting

• Claude Code kopplar inte an: Kör ug doctor om du använder ug. För manuell installation, kontrollera ditt arbetsområdes värdnamn, token, modellnamn och modellbehörigheter.

• Skrivbordsinloggning misslyckas: Kontrollera klient-ID, /oidc utfärdaren och ai-gateway scope. Den registrerade omdirigerings-URL:en måste matcha connectorens värd och port: 53180 för modeller och MCP:er, eller 53280 för färdigheter i denna guide. OAuth-applikationsändringar kan ta upp till 30 minuter innan de träder i kraft.

• En skrivbordsmodell saknas: Kontrollera dina modellbehörigheter. Under listan Connection > Models > Model lägger du till modellens fullständiga Unity-katalognamn. En explicit lista ersätter automatisk upptäckt, så inkludera alla modeller du vill använda. Applicera ändringarna och starta om.

• En MCP eller skill connector misslyckas: Kontrollera dess URL och behörigheter. Fältet Authorization server måste innehålla JSON-arrayen som visas ovan. Klicka på Logga in och testa för att inspektera felet.

• Inloggning till arbetsområdet fungerar, men ett verktyg ber dig logga in: Öppna inloggningslänken som returneras av MCP, logga in hos den externa leverantören och försök sedan anropet igen. Arbetsyta och inloggning för leverantör är separata steg.

• Claude Code OAuth rapporterar en omdirigeringsmismatch eller att anslutningen går ut i timeout: För en anpassad OAuth-app, matcha dess omdirigerings-URL med callback-värden och port, och kontrollera nätverksåtkomst. OAuth-appändringar kan ta upp till 30 minuter innan de träder i kraft.

Nästa steg

• ug CLI-referens
• Lägg till verktyg och färdigheter