Połącz z Cursor

Używaj kursora z modelami, narzędziami MCP i umiejętnościami przez Unity Gateway. Konfiguruj dostęp do modelu w ustawieniach IDE Cursor. Użyj Unity Gateway CLI (),ug aby dodać narzędzia i umiejętności MCP lub skonfigurować je ręcznie.

Prerequisites

Potrzebujesz adresu URL do swojego workspace Azure Databricks oraz dostępu do modeli, MCP i umiejętności, których chcesz używać. Zainstaluj kursor. Aby korzystać z integracji MCP ug, zainstaluj także Cursor Agent, który udostępnia polecenie cursor-agent.

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

IDE Cursor

1. Konfiguruj bazowy adres URL i klucz API

Otwórz Ustawienia > kursora > Ustawienia > kursora Modele > Klucze API.

Włącz Override OpenAI Base URL i wpisz:

https://<workspace-hostname>/ai-gateway/cursor/v1

Zastąp <workspace-hostname> nazwą hosta obszaru roboczego Azure Databricks. Wklej swój osobisty token dostępu Azure Databricks do klucza API OpenAI.

2. Dodaj niestandardowe modele

Kliknij + Dodaj model niestandardowy w ustawieniach kursora. Wpisz pełną nazwę modelu bazowego dostępnego w Twoim obszarze roboczym, a następnie włącz odpowiadający mu przełącznik. Powtarzaj dla każdego modelu, którego chcesz użyć.

Przykładowe nazwy modeli:

Provider Nazwa modelu
OpenAI system.ai.gpt-5-5
Gemini system.ai.gemini-3-5-flash
Claude system.ai.claude-opus-4-6

Dostępne modele zależą od twojej przestrzeni roboczej i uprawnień. To połączenie wykorzystuje modele dostarczone przez Azure Databricks.

3. Przetestować połączenie

Otwórz tryb Ask za pomocą Cmd+L w systemie macOS lub Ctrl+L w systemie Windows/Linux. Wybierz swój model i wyślij wiadomość. Żądania korzystające z tego niestandardowego modelu przechodzą przez Unity Gateway.

Agent kursora w terminalu

Użyj narzędzia Unity Gateway CLI

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

ug cursor

To otwiera Cursor Agent w terminalu. Zacznij pracować z tymi samymi promptami i komendami, których już używasz. Modele działają za pośrednictwem Twojego konta Cursor; ug nie konfiguruje trasowania modeli w agencie Cursor.

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 Podglądy w konsoli konta. Zobacz Podglądy konta.

Użyj narzędzia Unity Gateway CLI

Po zainstalowaniu agenta Cursor uruchom:

ug mcp add --agents cursor

Wybierz MCP, które chcesz dodać. ug rejestruje je w ~/.cursor/mcp.json, z którego korzystają IDE i agent terminalowy. Zrestartuj Kursor lub sesję agenta, a następnie poproś go o użycie połączonego narzędzia.

Konfiguruj MCP-y ręcznie

Użyj OAuth do połączenia z automatycznym odświeżaniem tokenów lub osobistego tokena dostępu do testów lokalnych.

Użyj OAuth

Ta konfiguracja wykorzystuje mcp-remote i wymaga Node.js z npx.

  1. Niech administrator konta utworzy publicznego klienta OAuth z adresem URL przekierowania http://localhost:3334/oauth/callback i zakresem ai-gateway.

  2. Połącz ten wpis z ~/.cursor/mcp.json, zachowując istniejące serwery:

    {
  "mcpServers": {
    "databricks-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>",
        "3334",
        "--static-oauth-client-info",
        "{\"client_id\":\"<client-id>\"}",
        "--static-oauth-client-metadata",
        "{\"scope\":\"ai-gateway offline_access\"}"
      ]
    }
  }
}

  3. Zamień nazwę hosta, nazwę MCP i identyfikator klienta. Uruchom ponownie Cursor i dokończ logowanie w przeglądarce.

W przypadku dodatkowych jednoczesnych połączeń użyj innego portu callback dla każdego i zarejestruj odpowiadający mu adres URL do przekierowania. Jeśli Twoja organizacja potrzebuje poufnego klienta, zobacz statyczne poświadczenia OAuth mcp-remote.

Użyj osobistego tokena dostępu

Stwórz osobisty token dostępu i scal ten wpis z ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dbsql": {
      "url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
      "headers": {
        "Authorization": "Bearer <databricks-pat>"
      }
    }
  }
}

Zamień nazwę hosta i token. W przypadku innej usługi użyj unikalnej nazwy serwera i zastąp system.ai.dbsql ją trzyczęściową nazwą Unity Catalog. Zachowaj niepowiązane wpisy serwerowe i nie umieszczaj tokenów w kontroli wersji.

Zrestartuj Cursor, sprawdź serwer w ustawieniach MCP i poproś agenta o wywołanie narzędzia tylko do odczytu. Aby system.ai.dbsql, spróbuj SELECT 1 AS result. Potwierdź, że agent wykonuje wywołanie narzędzia i zwraca wynik. Jeśli MCP poprosi o zgodę dostawcy, otwórz jego link logowania, dokończ logowanie, a następnie ponów wywołanie. Zobacz uwierzytelnianie MCP i sieci, aby uzyskać informacje o błędach uprawnień i połączeń.

Dodawanie umiejętności

Użyj narzędzia Unity Gateway CLI

Uruchom selektor, aby pobrać opublikowane umiejętności:

ug skills add

Kursor odczytuje pobrane umiejętności z ~/.agents/skills/. Zacznij nową sesję, żeby z nich korzystać. Pobrane dane są lokalnymi migawkami; uruchom polecenie ponownie, aby pobrać aktualizacje.

Podłącz rejestr umiejętności ręcznie

Aby załadować opublikowane umiejętności przez MCP, połącz ten wpis z:~/.cursor/mcp.json

{
  "mcpServers": {
    "databricks-skill-registry": {
      "url": "https://<workspace-hostname>/ai-gateway/skills/",
      "headers": {
        "Authorization": "Bearer <databricks-pat>"
      }
    }
  }
}

Zamień nazwę hosta i token, zachowując ukośnik na końcu adresu URL. Zrestartuj kursor i poproś go o użycie jakiejś umiejętności, takiej jak Use <catalog>.<schema>.<skill-name> to review this query.

Rejestr udostępnia funkcje za pośrednictwem MCP. Aby zainstalować pliki umiejętności, które już masz, umieść cały folder, w tym SKILL.md i dołączone pliki, w ~/.agents/skills/ lub w folderze .cursor/skills/ projektu. Zobacz dokumentację umiejętności Kursora.

Umiejętności Unity Gateway są w fazie beta. Zobacz Zarządzanie umiejętnościami dla umożliwień i uprawnień.

Troubleshooting

ug cursor nie można znaleźć Cursor Agent: Zainstaluj Cursor Agent i sprawdź, czy jest dostępny cursor-agent w twoim terminalu.

Model niestandardowy zawodzi w IDE: Sprawdź adres URL bramy, wygaśnięcie tokena, nazwę modelu oraz uprawnienia modelu. Wybierz niestandardowy model w rozmowie.

Połączenie MCP lub umiejętności nie działa: Sprawdź adres URL, uprawnienia MCP oraz błąd łącznika. W przypadku ręcznych podłączeń sprawdź też wygaśnięcie tokenów. W przypadku problemów z ug konfiguracją uruchom ug doctor.

Brakuje pobranej umiejętności: Sprawdź, czy jej folder zawiera SKILL.md i znajduje się w obsługiwanym katalogu umiejętności. Pobieranie na poziomie użytkownika dotyczy Twojego lokalnego komputera; nie są automatycznie dostępne dla agentów chmurowych.

Następne kroki

  • Ostatnia aktualizacja o