Connetti Claude Desktop

Usa Claude desktop in Code o Cowork con modelli, strumenti MCP e competenze tramite Unity Gateway. Claude Desktop supporta anche il relay in abbonamento di Anthropic.

Prerequisites

Hai bisogno dell'URL dello spazio di lavoro di Azure Databricks, dell'accesso ai modelli e agli strumenti che vuoi usare e dell'ultima versione del desktop Claude.

Su Windows, apri Claude desktop almeno una volta prima di eseguire ug configure, così l'app inizializza i dati locali.

Se prevedi di usare un relay di abbonamento Anthropic, installa la Claude Code CLI.

Connettiti a Unity Gateway CLI (consigliata)

Installa ug, poi esegui questo comando in un terminale interattivo:

ug configure --agents claude

Seleziona il tuo spazio di lavoro e accedi. Questo comando configura sia Claude Code che il work agent desktop Claude installato per lo stesso spazio di lavoro. ug crea e seleziona un profilo desktop Claude con i modelli, i server MCP, le abilità e le impostazioni di aggiornamento credenziali disponibili tramite il tuo workspace.

Apri o riavvia il desktop di Claude, poi avvia una conversazione su Code o Cowork. Usa il selettore di modelli per cambiare modello.

Distribuisci con MDM

Per distribuire Claude desktop in tutta la tua organizzazione con la gestione dei dispositivi mobili (MDM), consulta la guida al deployment MDM di Anthropic.

Funzionalità e limitazioni supportate

Questa configurazione utilizza la modalità di inferenza di terze parti di Claude Desktop.

Configurazione manuale

Usa questa configurazione solo se non puoi usare ug. Richiede un ID client OAuth e un profilo desktop Claude configurato manualmente.

1. Ottenere un ID client OAuth

Usa l'ID client Claude predefinito, https://claude.ai/oauth/mcp-oauth-client-metadata. Un amministratore account non deve creare un'app OAuth. Vedi ID client OAuth predefiniti.

2. Connettiti al Gateway Unity

Dalla schermata di accesso di Claude Desktop, seleziona Aiuto > Risoluzione dei problemi > Abilita modalità sviluppatore, poi Sviluppatore > Configura l'inferenza di terze parti.

Nella pagina Connessione , seleziona Gateway e inserisci:

Sostituisci <workspace-hostname> con il tuo nome host di Azure Databricks workspace. Lascia le altre impostazioni alle impostazioni predefinite. Vedi la configurazione del gateway di Anthropic per i dettagli sul campo.

Seleziona Test connessione e accedi ad Azure Databricks. Seleziona Applica modifiche, poi Salva e Riavvia. Nella schermata di accesso, scegli la configurazione di terze parti e avvia una conversazione in Code o Cowork.

3. Aggiungere strumenti e competenze MCP

Apri Developer > Configura i connettori di inferenza > di terze parti. In Managed MCP servers, aggiungi una voce per ogni MCP o registro di abilità che vuoi usare.

Usa queste impostazioni per entrambi i tipi di connettore:

Per un MCP, trova il suo nome in tre parti sotto Unity Gateway > MCPs nel tuo spazio di lavoro. Assegna al connettore un nome descrittivo, imposta la porta Callback su 53180, e usa questo URL:

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

Per le abilità, chiama il connettore databricks-skill-registry, imposta la porta Callback su 53280, e usa:

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

Mantieni la barra finale prima di ?schema. Per includere più schemi, ripeti il parametro: ?schema=main.default&schema=ml.prod. Queste competenze vengono esposte a Claude come strumenti tramite il connettore.

Per ogni connettore, seleziona Accedi e testa e completa l'accesso. Seleziona Applica modifiche, poi Salva e Riavvia. Chiedi a Claude di usare uno strumento connesso o un'abilità con il nome completo. Vedi Aggiungi strumenti e competenze per i requisiti di accesso e altre opzioni.

Connetti gli strumenti MCP con il tuo account Claude

Per system.ai.dbsql, prima abilita la beta di Unity Gateway.

Usa un connettore personalizzato per aggiungere gli strumenti Azure Databricks MCP a Claude sul web o desktop usando il tuo account Claude.

1. In Claude, apri Impostazioni > Connettori > Aggiungi connettore personalizzato.

2. Inserisci l'URL MCP:

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

3. Per l'ID client OAuth, inserisci l'ID client Claude predefinito, https://claude.ai/oauth/mcp-oauth-client-metadata. Seleziona Aggiungi e completa l'accesso.

4. Durante una conversazione, abilita il connettore e chiedi a Claude di chiamare uno dei suoi strumenti. Per system.ai.dbsql, prova con SELECT 1 AS result.

Se il tuo spazio di lavoro limita gli IP in arrivo, consenti gli IP in uscita di Claude. Vedi l'autenticazione MCP per permessi, login provider e risoluzione dei problemi.

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

Troubleshooting

• Fallimento dell'accesso: Per la configurazione manuale, controlla l'ID client, /oidc il provider di identità e ai-gateway l'ambito. L'URL di reindirizzamento registrato deve corrispondere all'host e alla porta del connettore: 53180 per modelli e MCP, oppure 53280 per le skill presenti in questa guida. Le modifiche all'applicazione di OAuth possono richiedere fino a 30 minuti per entrare in vigore.

• Manca un modello: Controlla i permessi del modello e riesegui ug configure --agents claude per aggiornare la lista dei modelli desktop. Per la configurazione manuale, aggiungi il nome completo di Unity Catalog del modello in Connection > Models > Model list. Una lista esplicita sostituisce la scoperta automatica, quindi includi i modelli che vuoi usare. Applica le modifiche e ricomincia da capo.

• Un MCP o un connettore di competenze non funziona: Verifica l'URL e le autorizzazioni. Per la configurazione manuale, il campo server di autorizzazione deve contenere l'array JSON mostrato sopra. Seleziona Accedi & testa per controllare l'errore.

• L'accesso Workspace funziona, ma uno strumento ti chiede di effettuare il login: Apri il link di accesso restituito dall'MCP, accedi al provider esterno, poi riprova la chiamata. L'accesso allo spazio di lavoro e il login del fornitore sono passaggi separati.

Passaggi successivi

• Collega Claude Code
• Aggiungi strumenti e competenze
• riferimento alla CLI UG