Conectar o desktop Claude
Use o desktop do Claude em Code ou Cowork com modelos, ferramentas MCP e habilidades por meio do Unity Gateway. O desktop do Claude também é compatível com o retransmissão de inscrição da Anthropic.
Pré-requisitos
Você precisa do URL do seu workspace do Databricks, acesso aos modelos e ferramentas que deseja usar e da versão mais recente do Claude desktop.
No Windows, abra o Claude desktop pelo menos uma vez antes de executar ug configure para que o aplicativo inicialize seus dados locais.
Se você planeja usar um relay de inscrição da Anthropic, instale a CLI do Claude Code.
Conectar com a CLI do Unity Gateway (recomendado)
Instale ug, depois faça a execução deste comando em um terminal interativo:
ug configure --agents claude
Selecione seu workspace e faça login. Este comando configura tanto o Claude Code quanto o agente de trabalho do desktop Claude instalado para o mesmo workspace. ug cria e seleciona um perfil de desktop Claude com os modelos, servidores MCP, habilidades e configurações de refresh de credenciais disponíveis em seu workspace.
Abra ou reinicie o desktop do Claude e, em seguida, comece uma conversa em Code ou Cowork . Use o seletor de modelos para alterar modelos.
Implantar com MDM
Para implantar o Claude para desktop em toda a sua organização com o gerenciamento de dispositivos móveis (MDM), consulte o guia de implantação de MDM da Anthropic.
Recursos compatíveis e limitações
Esta configuração usa o modo de inferência de terceiros do desktop Claude.
Recurso | Apoiar |
|---|---|
tab Code e Cowork | Compatível com inferência de modelo através do Unity Gateway. |
Servidores, ferramentas e habilidades de MCP | compatível com os servidores MCP, ferramentas e habilidades compartilhadas do Unity Gateway. |
Tarefas agendadas | Compatível. As tarefas agendadas funcionam da mesma forma que no Claude para desktop padrão. |
Relé de inscrição da Anthropic | Compatível. Instale a CLI do Claude Code antes de configurar o relay. |
Roteamento Inteligente | Não compatível. |
Configuração manual
Use esta configuração apenas se você não puder usar ug. Isso requer um ID de cliente OAuth e um perfil de desktop Claude configurado manualmente.
1. Obter um ID de cliente OAuth
Use o ID do cliente Claude default, https://claude.ai/oauth/mcp-oauth-client-metadata. Um administrador account não precisa criar um app OAuth. Consulte IDs de cliente OAuth default.
Use seu próprio aplicativo OAuth
Peça ao administrador do account para criar uma conexão de aplicativo OAuth. No console da account do Databricks, abra Configurações > Conexões de aplicativo > Adicionar conexão e use:
Contexto | Valor |
|---|---|
Tipo de identidade | Aplicativo padrão |
Nome do aplicativo |
|
Gerar um segredo de cliente | Não verificado (cliente público) |
URL de redirecionamento |
|
Escopos de acesso |
|
Salve a conexão e copie o ID do cliente . Se você planeja conectar habilidades, também registro http://127.0.0.1:53280/callback.
2. Conectar ao Unity Gateway
Na tela de login do desktop Claude, selecione Ajuda > Solução de problemas > Habilitar Mode de desenvolvedor e, em seguida, Desenvolvedor > Configurar inferência de terceiros .
Na página Conexão , selecione Gateway e insira:
Contexto | Valor |
|---|---|
Tipo de credencial | Login interativo |
URL base do gateway |
|
ID do cliente | Seu ID de cliente OAuth |
URL do emissor |
|
Token do portador | access token |
Escopos |
|
Acrescentar | Ativada |
Porta de redirecionamento |
|
Substitua <workspace-hostname> pelo hostname do seu workspace do Databricks. Deixe as outras configurações no seu default. Consulte a configuração do gateway da Anthropic para obter detalhes sobre o campo.
Selecione Testar conexão e faça login no Databricks. Selecione Aplicar alterações , depois Salvar & Reiniciar . Na tela de login, escolha a configuração de terceiros e comece uma conversa em Code ou Cowork .
3. Adicionar ferramentas e habilidades MCP
Abra Developer > Configure Third-Party Inference > Connectors . Em servidores MCP gerenciados , adicione uma entrada para cada MCP ou registro de habilidade que você deseja usar.
Use estas configurações para os dois tipos de conector:
Contexto | Valor |
|---|---|
Transporte | HTTP transmissível |
OAuth | Envie seu próprio cliente |
ID do cliente | Seu ID de cliente OAuth |
Segredo do cliente | Deixe em branco |
Servidor de autorização |
|
Escopo |
|
Solicitado | Ativada |
Host de callback |
|
Para um MCP, localize o nome de três partes em Unity Gateway > MCPs no seu workspace. Dê ao conector um nome descritivo, defina Porta de callback como 53180 e use esta URL:
https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service-name>?o=<workspace-id>
Para habilidades, nomeie o conector databricks-skill-registry, defina a Porta de callback como 53280 e use:
https://<workspace-hostname>/ai-gateway/skills/?schema=<catalog>.<schema>
Mantenha a barra final antes de ?schema. Para incluir vários esquemas, repita o parâmetro: ?schema=main.default&schema=ml.prod. Essas habilidades são expostas ao Claude como ferramentas por meio do conector.
Para cada conector, selecione Fazer login e testar e conclua o login. Selecione Aplicar alterações e, em seguida, Salvar e reiniciar . Peça ao Claude para usar uma ferramenta conectada ou uma habilidade pelo nome completo. Consulte Adicionar ferramentas e habilidades para ver os requisitos de acesso e mais opções.
Conecte ferramentas MCP com seu account Claude
Para system.ai.dbsql, primeiro habilite o beta do Unity Gateway.
Use um conector personalizado para adicionar ferramentas MCP do Databricks ao Claude na web ou no desktop usando sua account do Claude.
-
No Claude, abra Configurações > Conectores > Adicionar conector personalizado .
-
Insira a URL MCP:
Texthttps://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>?o=<workspace-id> -
Para o ID do cliente OAuth, insira o ID do cliente Claude default,
https://claude.ai/oauth/mcp-oauth-client-metadata. Selecione Adicionar e conclua o login. -
Em uma conversa, ative o conector e peça ao Claude para chamar uma de suas ferramentas. Para
system.ai.dbsql, tenteSELECT 1 AS result.
Use seu próprio aplicativo OAuth
Peça a um administrador do account para criar um cliente OAuth. Para um MCP, selecione o escopo ai-gateway e registre ambos os URLs de redirecionamento:
https://claude.ai/api/mcp/auth_callbackhttps://claude.com/api/mcp/auth_callback
No passo 3, insira esse ID de cliente e, para um cliente confidencial, seu segredo.
Se seu workspace restringe IPs de entrada, permita os IPs de saída do Claude. Consulte autenticação MCP para obter permissões, login do provedor e solução de problemas.
Use um access token pessoal para teste local
Esta opção requer Node.js com npx e um access token pessoal. Funciona para MCPs fornecidos e registrados pelo Databricks e Endpoint de MCP de Workspace. Servidores hospedados no Databricks Apps requerem OAuth.
Faça merge desta entrada para claude_desktop_config.json em ~/Library/Application Support/Claude/claude_desktop_config.json no macOS ou %APPDATA%\Claude\claude_desktop_config.json no Windows:
{
"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>"
]
}
}
}
Substitua os placeholders, mantenha os tokens fora do controle de fonte e reinicie o Claude Desktop. Peça ao Claude para chamar uma ferramenta somente leitura para verificar a conexão.
Solução de problemas
-
Falha no login: para configuração manual, verifique o ID do cliente, o emissor
/oidce o escopoai-gateway. A URL de redirecionamento registrada deve corresponder ao host e à porta do conector:53180para modelos e MCPs, ou53280para habilidades neste guia. As alterações no aplicativo OAuth podem levar até 30 minutos para entrar em vigor. -
Um modelo está ausente: Verifique suas permissões de modelo e execute
ug configure --agents claudenovamente para refresh a lista de modelos de desktop. Para configuração manual, adicione o nome completo do Unity Catalog do modelo em Conexão > Modelos > Lista de modelos . Uma lista explícita substitui a descoberta automática, portanto, inclua os modelos que você deseja usar. Aplique as alterações e reinicie. -
Um conector MCP ou de habilidade falha: Verifique sua URL e permissões. Para a configuração manual, o campo Authorization server deve conter a matriz JSON mostrada acima. Selecione Sign in & test para inspecionar o erro.
-
O log in no workspace funciona, mas uma ferramenta solicita que você faça log in: Abra o link de log in retornado pelo MCP, faça log in no provedor externo e tente novamente a chamada. O log in no Workspace e no provedor são os passos separados.