Połącz Claude na komputerze

Korzystaj z Claude Desktop w Code lub Cowork z modelami, narzędziami MCP i umiejętnościami przez Unity Gateway. Claude Desktop obsługuje także przekazywanie subskrypcji Anthropic.

Prerequisites

Potrzebujesz adresu URL do przestrzeni roboczej Azure Databricks, dostępu do modeli i narzędzi, których chcesz używać, oraz najnowszej wersji Claude desktop.

W systemie Windows otwórz aplikację Claude Desktop przynajmniej raz przed uruchomieniem ug configure, aby aplikacja zainicjowała swoje dane lokalne.

Jeśli planujesz korzystać z przekaźnika subskrypcji Anthropic, zainstaluj Claude Code CLI.

Połącz się z CLI Unity Gateway (zalecane)

Instalacja ug, a następnie wykonaj to polecenie w interaktywnym terminalu:

ug configure --agents claude

Wybierz swoją przestrzeń roboczą i zaloguj się. To polecenie konfiguruje zarówno Claude Code, jak i zainstalowanego agenta desktop work Claude dla tej samej przestrzeni roboczej. ug tworzy i wybiera profil aplikacji Claude na komputerze z modelami, serwerami MCP, umiejętnościami oraz ustawieniami odświeżania danych uwierzytelniających dostępnymi w Twojej przestrzeni roboczej.

Otwórz lub uruchom ponownie aplikację Claude na komputerze, a potem rozpocznij rozmowę w Code lub Cowork. Użyj selektora modeli, aby zmienić model.

Wdróż za pomocą MDM

Aby wdrożyć Claude Desktop w całej organizacji z zarządzaniem urządzeniami mobilnymi (MDM), zobacz przewodnik po wdrażaniu MDM Anthropic.

Obsługiwane funkcje i ograniczenia

Ta konfiguracja wykorzystuje tryb wnioskowania firm trzecich w Claude Desktop.

Ręczna konfiguracja

Używaj tej konfiguracji tylko wtedy, gdy nie możesz używać ug. Wymaga ID klienta OAuth oraz ręcznie skonfigurowanego profilu pulpitowego Claude.

1. Uzyskaj identyfikator klienta OAuth

Użyj domyślnego identyfikatora klienta Claude, https://claude.ai/oauth/mcp-oauth-client-metadata. Administrator konta nie musi tworzyć aplikacji OAuth. Zobacz Domyślne identyfikatory klientów OAuth.

2. Połącz z Unity Gateway

Na ekranie logowania na pulpicie Claude wybierz Pomoc > Rozwiązywanie problemów > Włącz Tryb Dewelopera, a następnie Deweloper > Konfiguruj wnioskowanie podmiotów trzecich.

Na stronie Połączenie wybierz Bramę i wpisz:

Zastąp <workspace-hostname> nazwą hosta obszaru roboczego Azure Databricks. Pozostałe ustawienia zostaw na domyślnych. Zobacz konfigurację bramy Anthropic, aby poznać szczegółowe informacje o polach.

Wybierz Test connection i zaloguj się do Azure Databricks. Wybierz Wproś zmiany, a następnie Zapisz i zrestartuj. Na ekranie logowania wybierz konfigurację firm trzecich i rozpocznij rozmowę w Code lub Cowork.

3. Dodaj narzędzia i umiejętności MCP

Open Developer > Konfiguruj zewnętrzne konektory inferencyjne>. W sekcji Zarządzane serwery MCP dodaj wpis dla każdego MCP lub rejestru umiejętności, którego chcesz używać.

Użyj następujących ustawień dla obu typów złączy:

W przypadku MCP znajdź jego trzyczęściową nazwę w Unity Gateway > MCPs w swoim obszarze roboczym. Nadaj łącznikowi opisową nazwę, ustaw port Callback na 53180, i użyj tego adresu URL:

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

Dla umiejętności nazwij złącze databricks-skill-registry, ustaw port wywołania zwrotnego na 53280, i używaj:

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

Zachowaj ukośnik końcowy przed ?schema. Aby uwzględnić wiele schematów, powtórz parametr ?schema=main.default&schema=ml.prod: . Te umiejętności są przez łącznik udostępniane Claude'owi jako narzędzia.

Dla każdego łącznika wybierz Zaloguj się i testuj oraz dokończ logowanie. Wybierz Wproś zmiany, a następnie Zapisz i zrestartuj. Poproś Claude'a, by użył powiązanego narzędzia lub umiejętności pod pełną nazwą. Zobacz Dodaj narzędzia i umiejętności, aby uzyskać informacje o wymaganiach dotyczących dostępu i więcej opcji.

Połącz narzędzia MCP ze swoim kontem Claude

Dla system.ai.dbsql, najpierw włącz betę Unity Gateway.

Użyj niestandardowego łącznika, aby dodać narzędzia MCP Azure Databricks do Claude w sieci lub na komputerze, korzystając z konta Claude.

1. W Claude otwórz Ustawienia > Konektory > Dodaj niestandardowy konektor.

2. Wpisz adres URL MCP:

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

3. W polu identyfikatora klienta OAuth wpisz domyślny identyfikator klienta Claude, https://claude.ai/oauth/mcp-oauth-client-metadata. Wybierz Dodaj i dokończ logowanie.

4. W rozmowie włącz łącznik i poproś Claude'a, by wywołał jedno ze swoich narzędzi. Aby użyć system.ai.dbsql, spróbuj SELECT 1 AS result.

Jeśli twoja przestrzeń robocza ogranicza przychodzące adresy IP, zezwól na wychodzące adresy IP Claude'a. Zobacz uwierzytelnianie MCP dla uprawnień, logowania dostawcy i rozwiązywania problemów.

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

• Nieudane logowanie: Aby skonfigurować ręcznie, sprawdź identyfikator klienta, /oidc wystawcę i ai-gateway zakres działania. Zarejestrowany adres URL przekierowania musi odpowiadać hostowi i portowi konektora: 53180 dla modeli i MCP lub 53280 dla umiejętności opisanych w tym przewodniku. Wprowadzenie zmian w aplikacji OAuth może potrwać nawet 30 minut.

• Brakuje modelu: Sprawdź uprawnienia modelu i ponownie uruchom ug configure --agents claude, aby odświeżyć listę modeli desktopowych. Aby skonfigurować ręcznie, dodaj pełną nazwę modelu z katalogu Unity w obszarze Connection > Models > Model list. Lista jawna zastępuje automatyczne odkrywanie, więc uwzględnij modele, których chcesz używać. Wprowadź zmiany i zrestartuj.

• Jeśli łącznik MCP lub łącznik umiejętności nie działa: Sprawdź jego adres URL i uprawnienia. Do ręcznej konfiguracji pole Authorization server musi zawierać tablicę JSON pokazaną powyżej. Wybierz Zaloguj się i przetestuj, aby sprawdzić błąd.

• Logowanie w Workspace działa, ale narzędzie prosi o zalogowanie: Otwórz link logowania zwrócony przez MCP, zaloguj się u zewnętrznego dostawcy, a następnie ponów wywołanie. Obszar roboczy i logowanie dostawcy to osobne etapy.

Następne kroki

• Połącz Claude Code
• Dodaj narzędzia i umiejętności
• Dokumentacja CLI ug