Połącz Claude Code

Korzystaj z Claude Code lub aplikacji desktopowej Claude z modelami, narzędziami MCP i umiejętnościami przez Unity Gateway. Do kodu Claude użyj Unity Gateway CLI (ug) lub konfiguruj połączenie ręcznie. W aplikacji desktopowej skonfiguruj połączenie w ustawieniach aplikacji.

Aby połączyć narzędzia z istniejącym zestawem Claude Code, przejdź do opcji Dodaj narzędzia MCP. W Claude w wersji przeglądarkowej lub w sesji desktopowej z twoim kontem Claude użyj konektorów Claude.

Prerequisites

Potrzebujesz adresu URL swojego workspace Azure Databricks oraz dostępu do modeli, których chcesz używać. Do konfiguracji desktopowej zainstaluj najnowszą aplikację Claude i poproś administratora konta o identyfikator klienta OAuth, jak opisano poniżej.

Jeśli administrator już skonfigurował Twoje urządzenie, postępuj zgodnie z instrukcjami logowania i uruchomienia organizacji.

Kod Claude'a

Użyj CLI Unity Gateway (zalecane)

Instaluj ug, a następnie uruchom to polecenie z katalogu projektu:

ug claude

Postępuj zgodnie z instrukcjami, aby wybrać swoją przestrzeń pracy i zalogować się. ug konfiguruje połączenie i otwiera kod Claude'a w terminalu. Zacznij pracować z tymi samymi promptami i komendami, których już używasz. Aby zmienić model, wpisz /model.

Kontynuuj dodawanie narzędzi MCP do łączenia danych i usług. Aby pobrać udostępnione umiejętności, uruchom ug skills add i wybierz te, które chcesz. Zobacz Dodaj narzędzia i umiejętności , aby uzyskać więcej opcji.

Konfiguruj kod Claude ręcznie

Połącz następujące ustawienia do ~/.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"
  }
}

Zastąp <workspace-hostname> nazwą hosta swojego obszaru roboczego, bez https://. Ustaw w polu <model-api-name> pełną nazwę w Unity Catalog interfejsu API modelu Claude, do którego masz dostęp, i podaj swój osobisty token dostępu do usługi Azure Databricks.

Uruchamiaj claude z katalogu projektu. Inne ustawienia znajdziesz w Claude Code settings.

Dodaj narzędzia MCP

Aby używać system.ai.dbsql, system.ai.sandbox lub system.ai.web_search, administrator konta musi włączyć wersję beta Unity Gateway na stronie Wersje zapoznawcze w konsoli konta. Zobacz Podglądy konta.

Otwórz Unity Gateway MCPs > w swoim workspace. Wybierz wbudowany MCP lub zarejestruj swój zewnętrzny serwer MCP.
Skopiuj pełne imię i nazwisko MCP, takie jak system.ai.github lub <catalog>.<schema>.<service>.
Potwierdź, że masz dostęp do MCP.
Po instalacji ug, dodaj MCP do Claude Code:
```
ug mcp add --agents claude --names <catalog>.<schema>.<service>
```
Zastąp symbol zastępczy nazwą, którą skopiowałeś. Na przykład w przypadku GitHub użyj --names system.ai.github. Aby wybierać usługi interaktywnie, pomiń --names.

Przy pierwszej konfiguracji postępuj zgodnie z instrukcjami, aby wybrać obszar roboczy, zalogować się i wybrać model. ug konfiguruje zarówno dostęp do modelu, jak i MCP oraz odświeża poświadczenia uwierzytelniające. Zrestartuj Claude Code za pomocą ug claude, a potem przetestuj narzędzie.

Dodaj narzędzia MCP ręcznie

Użyj wbudowanego klienta OAuth poniżej lub skonfiguruj własną aplikację OAuth. Aby dodać MCP z wbudowanym klientem, wykonaj:

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

Zamień nazwę hosta i nazwę MCP. To korzysta z wbudowanego claude-code klienta OAuth. Otwórz Claude Code, wpisz /mcp, i zaloguj się na serwer za pomocą konta Azure Databricks. Powtórz te kroki dla każdej innej nazwy serwera dla każdego MCP, który chcesz dodać, a następnie przetestuj narzędzie.

Użyj własnej aplikacji OAuth

Niech administrator konta otworzy Ustawienia > Połączenia aplikacji > Dodaj połączenie w konsoli konta.
Wprowadź nazwę taką jak claude-code-mcp, odznacz Wygeneruj sekret klienta dla klienta publicznego, ustaw adres URL przekierowania na http://localhost:8080/callback i wybierz zakres ai-gateway. Zapisz i skopiuj identyfikator klienta. Zobacz Stwórz aplikację OAuth.

Zarejestruj MCP używając tego identyfikatora klienta oraz odpowiadającego portu callback:

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

Otwórz Claude Code, wpisz /mcp i zaloguj się. Jeśli Twoja organizacja potrzebuje klienta poufnego, dodaj --client-secret do polecenia i wprowadź sekret na żądanie.

Przetestuj narzędzie MCP

W kodzie Claude wpisz /mcp i sprawdź, czy serwer jest połączony.
Poproś Claude'a o podanie listy narzędzi tego serwera, a następnie poproś o operację odczytu. W GitHubie poproś go, żeby znalazł zgłoszenie w repozytorium, do którego masz dostęp. Do serwera niestandardowego użyj narzędzia i danych wejściowych, które przetestowano podczas rejestracji.
Jeśli wywołanie narzędzia wymaga zalogowania, otwórz link logowania zwrócony przez MCP, dokończ wyrażenie zgody u dostawcy, a następnie ponów wywołanie.
Sprawdź, czy Claude wykonuje wywołanie narzędzia i zwraca jego wynik. Sama odpowiedź tekstowa nie potwierdza połączenia.

Aby korzystać z danych Azure Databricks, połącz się z system.ai.genie_one_mcp w przypadku pytań biznesowych lub z system.ai.dbsql w przypadku SQL. Na przykład, poproś SQL MCP o uruchomienie SELECT 1 AS result.

Informacje o uprawnieniach, politykach i użytkowaniu znajdziesz w Zarządzanie MCP.

Połącz umiejętności ręcznie

Aby udostępnić opublikowane umiejętności Unity Gateway jako narzędzia, zarejestruj rejestr umiejętności jako serwer HTTP MCP:

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

Zastąp symbole zastępcze nazwą obszaru roboczego, tokenem i schematem umiejętności. Zachowaj ukośnik końcowy przed ?schema. Aby uwzględnić wiele schematów, powtórz parametr ?schema=main.default&schema=ml.prod: .

Zrestartuj kod Claude'a i sprawdź połączenie za pomocą /mcp. Poproś Claude'a o użycie umiejętności, używając jej pełnej nazwy, na przykład Use <catalog>.<schema>.<skill-name> to review this query.. To połączenie udostępnia umiejętności jako narzędzia MCP; ug skills add zamiast tego pobiera umiejętności na potrzeby natywnego wykrywania.

Aplikacja desktopowa Claude

1. Uzyskaj identyfikator klienta OAuth

Poproś administratora konta o utworzenie połączenia z aplikacją OAuth. W konsoli kont Azure Databricks otwórz Ustawienia > połączenia > aplikacji Dodaj połączenie i użyj:

Setting	Value
Typ tożsamości	Standardowe zastosowanie
Nazwa aplikacji	`claude-desktop`
Wygeneruj tajny klucz klienta	Nieodznaczone (klient publiczny)
Adres przekierowania URL	`http://127.0.0.1:53180/callback`
Zakres dostępu	`ai-gateway`

Zapisz połączenie i skopiuj identyfikator klienta. Jeśli planujesz łączyć umiejętności, również się zarejestruj http://127.0.0.1:53280/callback.

2. Połącz z Unity Gateway

Na ekranie logowania aplikacji komputerowej wybierz Pomoc > Rozwiązywanie problemów > Włącz tryb dewelopera, a następnie Deweloper > Konfiguruj wnioskowanie zewnętrzne.

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

Setting	Value
Rodzaj poświadczenia	Interaktywne logowanie
Bazowy adres URL bramy	`https://<workspace-hostname>/ai-gateway/anthropic`
identyfikator klienta	Twój identyfikator klienta OAuth
Adres URL wystawcy	`https://<workspace-hostname>/oidc`
Token elementu nośnego	Token dostępu
Scopes	`ai-gateway`
Dołącz `offline_access`	Enabled
Przekierowywanie portu	`53180`

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.

Kliknij 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:

Setting	Value
Transport	HTTP z obsługą strumieniowania
OAuth	Przyprowadź własnego klienta
identyfikator klienta	Twój identyfikator klienta OAuth
Tajemnica klienta	Pozostaw puste.
Serwer autoryzacji	`["https://<workspace-hostname>/oidc"]`
Scope	`ai-gateway`
Żądanie `offline_access`	Enabled
Host wywołania zwrotnego	`127.0.0.1`

W przypadku MCP znajdź jego trzyczęściową nazwę w Unity Gateway > MCPs w swoim workspace. 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>

Aby uzyskać umiejętności, nazwij złącze databricks-skill-registry, ustaw port odwzajemnienia 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 kliknij Zaloguj się i testuj oraz zakoń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.

Łączniki 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.

Niech administrator konta utworzy klienta OAuth. Dla MCP wybierz ai-gateway zakres i zarejestruj oba adresy URL przekierowania:
- https://claude.ai/api/mcp/auth_callback
- https://claude.com/api/mcp/auth_callback
W Claude otwórz Ustawienia > Konektory > Dodaj niestandardowy konektor.

Wpisz adres URL MCP:

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

Wprowadź identyfikator klienta OAuth oraz, w przypadku klienta poufnego, jego sekret. Kliknij Dodaj i dokończ logowanie.
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 i obsługa sieci, aby uzyskać informacje o uprawnieniach, logowaniu do dostawcy oraz rozwiązywaniu problemów.

Użyj osobistego tokena dostępu w Claude Desktop do testów lokalnych

Ta opcja wymaga Node.js z npx i osobistym tokenem dostępu. Działa w przypadku MCP dostarczanych i zarejestrowanych przez Databricks oraz starszych punktów końcowych obszaru roboczego. Serwery hostowane w Databricks Apps wymagają OAuth.

Połącz ten wpis z claude_desktop_config.json w ~/Library/Application Support/Claude/claude_desktop_config.json na macOS lub %APPDATA%\Claude\claude_desktop_config.json w systemie 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>"
      ]
    }
  }
}

Zastąp symbole zastępcze, przechowuj tokeny poza kontrolą wersji i uruchom ponownie aplikację Claude Desktop. Poproś Claude'a o wywołanie narzędzia tylko do odczytu, aby zweryfikować połączenie.

Troubleshooting

Claude Code nie łączy się: Uruchom ug doctor, jeśli używasz ug. Do ręcznej konfiguracji sprawdź nazwę hosta, token, nazwę modelu i uprawnienia do pracy w przestrzeni roboczej.
Logowanie na pulpicie nie powiodło: Sprawdź identyfikator klienta, /oidc wydawcę 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 desktopowego: Sprawdź uprawnienia modelu. W sekcji Połączenie > Modele > Lista modeli dodaj pełną nazwę modelu w Unity Catalog. Lista jawna zastępuje automatyczne odkrywanie, więc uwzględnij wszystkie 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. Pole serwera autoryzacji musi zawierać tablicę JSON pokazaną powyżej. Kliknij 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. Workspace i logowanie dostawcy to osobne etapy.
Claude Code OAuth zgłasza niedopasowanie przekierowania lub wygaśnięcie limitu czasu połączenia: W przypadku niestandardowej aplikacji OAuth dopasuj jej adres URL przekierowania do hosta i portu wywołania zwrotnego oraz sprawdź dostęp do sieci. Zmiany w aplikacji OAuth mogą wejść w życie do 30 minut.

Następne kroki

Opinia

Czy ta strona była pomocna?

Ostatnia aktualizacja o 2026-10-08