Claude Code verbinden

Gebruik Claude Code of de Claude desktop-app met modellen, MCP-tools en vaardigheden via Unity Gateway. Voor Claude Code gebruik je de Unity Gateway CLI (ug) of configureer je de verbinding handmatig. Voor de desktop-app configureer je de verbinding in de instellingen van de app.

Om tools te koppelen aan een bestaande Claude Code-setup, ga naar Add MCP tools. Voor Claude online of een desktopsessie met je Claude-account, gebruik Claude connectors.

Prerequisites

Je hebt je Azure Databricks workspace-URL nodig en toegang tot de modellen die je wilt gebruiken. Voor desktopconfiguratie installeer je de nieuwste Claude desktop-app en vraag je accountbeheerder om een OAuth-client-ID, zoals hieronder beschreven.

Als je beheerder je apparaat al heeft geconfigureerd, volg dan de aanmeldings- en startinstructies van je organisatie.

Claude Code

Gebruik de Unity Gateway CLI (aanbevolen)

Installeer ugen voer vervolgens dit commando uit vanuit je projectmap:

ug claude

Volg de instructies om je werkruimte te selecteren en in te loggen. ug configureert de verbinding en opent Claude Code in je terminal. Begin met dezelfde prompts en commando's die je al gebruikt. Om van model te veranderen, voer /modelin .

Blijf MCP-tools toevoegen om data en diensten te verbinden. Om gedeelde vaardigheden te downloaden, start ug skills add en selecteer je de vaardigheden die je wilt. Zie Gereedschappen en vaardigheden toevoegen voor meer opties.

Configureer Claude Code handmatig

Voeg de volgende instellingen samen in ~/.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"
  }
}

Vervang <workspace-hostname> door je workspace-hostnaam, zonder https://. Stel <model-api-name> in op de volledige Unity Catalog-naam van een Claude model API die je kunt benaderen, en lever je Azure Databricks persoonlijke toegangstoken aan.

Voer claude uit vanuit je projectmap. Voor andere instellingen, zie Claude Code-instellingen.

Voeg MCP-tools toe

Om system.ai.sandbox, system.ai.web_search of system.ai.dbsql te gebruiken, moet een accountbeheerder de Unity Gateway-beta inschakelen via de pagina Previews van de accountconsole. Zie Voorbeelden van accounts beheren.

Open Unity Gateway > MCPs in je werkruimte. Kies een ingebouwde MCP of registreer je externe MCP-server.
Kopieer de volledige naam van de MCP, zoals system.ai.github of <catalog>.<schema>.<service>.
Bevestig dat je toegang hebt tot de MCP.
Voeg na het installeren van ug de MCP toe aan Claude Code:
```
ug mcp add --agents claude --names <catalog>.<schema>.<service>
```
Vervang de tijdelijke aanduiding door de naam die je hebt gekopieerd. Gebruik bijvoorbeeld --names system.ai.github voor GitHub. Om services interactief te selecteren, laat --names weg.

Volg bij de eerste installatie de instructies om je werkruimte te selecteren, log in en kies een model. ug configureert zowel model- als MCP-toegang en ververst de inloggegevens. Herstart Claude Code met ug claude, en test dan een tool.

Handmatig MCP-tools toevoegen

Gebruik de ingebouwde OAuth-client hieronder, of configureer je eigen OAuth-app. Om een MCP toe te voegen met de ingebouwde client, voer je uit:

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

Vervang de hostnaam en MCP-naam. Dit gebruikt de ingebouwde claude-code OAuth-client. Open Claude Code, voer /mcpin , en log in op de server met je Azure Databricks-account. Herhaal dit met een andere servernaam voor elke MCP die je wilt toevoegen, dan test een tool.

Gebruik je eigen OAuth-app

Laat een accountbeheerder Instellingen > App-verbindingen > Verbinding toevoegen openen in de accountconsole.
Voer een naam in zoals claude-code-mcp, schakel Genereer een clientgeheim uit voor een publieke client, stel de redirect-URL in op http://localhost:8080/callback, en selecteer de ai-gateway scope. Sla de Client ID op en kopieer deze. Zie Create an OAuth app.

Registreer de MCP met die client-ID en de bijbehorende callback-poort:

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

Open de Claude Code, voer /mcpin , en log in. Als je organisatie een vertrouwelijke client nodig heeft, voeg --client-secret dan toe aan het commando en voer het clientgeheim in wanneer daarom wordt gevraagd.

Test een MCP-tool

Voer in Claude Code in /mcp en controleer of de server verbonden is.
Vraag Claude om de tools van die server op te sommen, en vraag dan om een leesoperatie. Voor GitHub, vraag het om een issue te vinden in een repository waar je toegang toe hebt. Voor een aangepaste server gebruik je een tool en invoer die je tijdens de registratie hebt getest.
Als een tool-oproep je vraagt in te loggen, open dan de inloglink die door de MCP wordt teruggegeven, voltooi de toestemming van de provider en probeer de oproep daarna opnieuw.
Controleer of Claude een tool-oproep maakt en het resultaat teruggeeft. Een tekstantwoord alleen bevestigt de connectie niet.

Om Azure Databricks-data te gebruiken, maak verbinding via system.ai.genie_one_mcp voor zakelijke vragen of system.ai.dbsql voor SQL. Vraag bijvoorbeeld de SQL MCP om SELECT 1 AS result uit te voeren.

Voor permissies, beleidsregels en gebruik, zie Govern an MCP.

Verbind vaardigheden handmatig

Om gepubliceerde Unity Gateway-vaardigheden als tools bloot te stellen, registreer het vaardigheidsregister als een 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>"

Vervang de placeholders door je werkruimte, token en vaardigheidsschema. Houd de afsluitende slash vóór ?schema. Om meerdere schema's te bevatten, herhaal je de parameter: ?schema=main.default&schema=ml.prod.

Start Claude Code opnieuw en controleer de verbinding met /mcp. Vraag Claude om een vaardigheid met de volledige naam te gebruiken, zoals Use <catalog>.<schema>.<skill-name> to review this query.. Deze verbinding stelt vaardigheden beschikbaar als MCP-tools; ug skills add downloadt in plaats daarvan vaardigheden voor native detectie.

Claude-desktop-app

1. Krijg een OAuth-client ID

Vraag je accountbeheerder om een OAuth-applicatieverbinding aan te maken. In de Azure Databricks accountconsole opent u Instellingen > App-verbindingen > Voeg verbinding toe en gebruik:

Instelling	Value
Identiteitstype	Standaardtoepassing
Toepassingsnaam	`claude-desktop`
Een klantgeheim genereren	Niet ingeschakeld (openbare client)
Omleidings-URL	`http://127.0.0.1:53180/callback`
Toegangsbereiken	`ai-gateway`

Sla de verbinding op en kopieer de Client-ID. Als je van plan bent vaardigheden te verbinden, registreer http://127.0.0.1:53280/callbackdan ook eens.

2. Verbind met Unity Gateway

Selecteer vanaf het aanmeldscherm van de desktop-app Hulp > bij Probleemoplossing > Activeren Ontwikkelaarsmodus en vervolgens Ontwikkelaar > Configureer Derdepartij Inferentie.

Selecteer op de VerbindingspaginaGateway en voer in:

Instelling	Value
Type referentiegegeven	Interactief aanmelden
Gateway-basis-URL	`https://<workspace-hostname>/ai-gateway/anthropic`
Client-ID	Uw OAuth client ID
URL van uitgever	`https://<workspace-hostname>/oidc`
draagtoken	Toegangstoken
Scopes	`ai-gateway`
Toevoegen `offline_access`	Enabled
Omleidingspoort	`53180`

Vervang <workspace-hostname> door je hostnaam van je Azure Databricks workspace. Laat de andere instellingen op hun standaardinstellingen. Zie de gatewayconfiguratie van Anthropic voor velddetails.

Klik op Test verbinding en log in bij Azure Databricks. Selecteer Wijzigingen Toepassen en vervolgens Opslaan & Herstarten. Kies op het aanmeldscherm de configuratie van derden en start een gesprek in Code of Cowork.

3. Voeg MCP-tools en vaardigheden toe

Open ontwikkelaar > configureert inferentieconnectoren > van derden. Voeg onder Managed MCP-servers een vermelding toe voor elke MCP of skill registry die je wilt gebruiken.

Gebruik deze instellingen voor beide typen connectoren:

Instelling	Value
Transport	HTTP geschikt voor streaming
OAuth	Breng je eigen klant mee
Client-ID	Uw OAuth client ID
Clientgeheim	Leeg laten
Autorisatieserver	`["https://<workspace-hostname>/oidc"]`
Scope	`ai-gateway`
Aanvraag `offline_access`	Enabled
Callbackhost	`127.0.0.1`

Voor een MCP vindt u de driedelige naam onder Unity Gateway > MCP's in uw werkruimte. Geef de connector een beschrijvende naam, stel Callback-poort in op 53180, en gebruik deze URL:

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

Voor vaardigheden, geef de connector databricks-skill-registryeen naam, stel de Callback-poort in op 53280, en gebruik:

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

Houd de afsluitende slash vóór ?schema. Om meerdere schema's te bevatten, herhaal je de parameter: ?schema=main.default&schema=ml.prod. Deze vaardigheden worden aan Claude blootgesteld als hulpmiddelen via de connector.

Voor elke connector klik je op Inloggen & testen en voltooi je het inloggen. Selecteer Wijzigingen Toepassen en vervolgens Opslaan & Herstarten. Vraag Claude om een verbonden hulpmiddel of vaardigheid te gebruiken met de volledige naam. Zie Voeg tools en vaardigheden toe voor toegangsvereisten en meer opties.

Claude-connectoren

Voor system.ai.dbsql, schakel eerst de Unity Gateway bèta in.

Gebruik een aangepaste connector om Azure Databricks MCP-tools toe te voegen aan Claude op het web of desktop met je Claude-account.

Laat een accountbeheerder een OAuth-client aanmaken. Selecteer voor een MCP de ai-gateway scope en registreer beide redirect-URL's:
- https://claude.ai/api/mcp/auth_callback
- https://claude.com/api/mcp/auth_callback
Open in Claude de optie Instellingen > Connectoren > Voeg aangepaste connector toe.

Voer de MCP-URL in:

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

Voer de OAuth client ID in en, voor een vertrouwelijke client, het geheim ervan. Klik op Add en voltooi het aanmelden.
Activeer in een gesprek de connector en vraag Claude om een van zijn tools aan te roepen. Voor system.ai.dbsql, probeer SELECT 1 AS result.

Als je werkruimte binnenkomende IP's beperkt, sta dan de uitgaande IP's van Claude toe. Zie MCP-authenticatie en netwerken voor permissies, provider-login en probleemoplossing.

Gebruik een persoonlijk toegangstoken in Claude desktop voor lokaal testen

Deze optie vereist Node.js met npx en een persoonlijk toegangstoken. Het werkt voor door Databricks geleverde en geregistreerde MCP's, en voor legacy workspace-endpoints. Servers die worden gehost op Databricks Apps, vereisen OAuth.

Voeg deze vermelding in claude_desktop_config.json in ~/Library/Application Support/Claude/claude_desktop_config.json op macOS of %APPDATA%\Claude\claude_desktop_config.json op 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>"
      ]
    }
  }
}

Vervang de placeholders, houd tokens buiten versiebeheer en start Claude desktop opnieuw. Vraag Claude om een alleen-lezen-tool aan te roepen om de verbinding te verifiëren.

Troubleshooting

Claude Code maakt geen verbinding: Voer uit ug doctor als je gebruikt ug. Controleer voor handmatige installatie de hostnaam, token, modelnaam en modelrechten van je werkruimte.
Desktop-aanmelden faalt: Controleer de client ID, /oidc de uitgever en ai-gateway de scope. De geregistreerde redirect-URL moet overeenkomen met de host en poort van de connector: 53180 voor modellen en MCP's, of 53280 voor vaardigheden in deze gids. OAuth-aanvraagwijzigingen kunnen tot 30 minuten duren voordat ze van kracht worden.
Er ontbreekt een desktopmodel: Controleer de rechten van je model. Voeg onder Connection > Models > Model list de volledige Unity Catalog-naam van het model toe. Een expliciete lijst vervangt automatische ontdekking, dus neem alle modellen op die je wilt gebruiken. Pas de wijzigingen toe en start opnieuw.
Een MCP of skillconnector mislukt: Controleer de URL en de machtigingen. Het Authorization-serverveld moet de hierboven getoonde JSON-array bevatten. Klik op Aanmelden & testen om de fout te inspecteren.
Workspace-aanmelden werkt, maar een tool vraagt je in te loggen: Open de inloglink die door de MCP wordt teruggegeven, log in bij de externe provider en probeer de aanroep daarna opnieuw. Werkruimte en aanmelden bij de provider zijn aparte stappen.
Claude Code OAuth meldt een redirect-mismatch of de verbinding loopt in time-out: Voor een aangepaste OAuth-app, koppel de redirect-URL aan de callbackhost en poort, en controleer de netwerktoegang. Wijzigingen in de OAuth-app kunnen tot 30 minuten duren voordat ze van kracht worden.

Volgende stappen

Feedback

Is deze pagina nuttig?

Laatst bijgewerkt om 2026-10-08