Připojit kurzor

Používejte Kurzor s modely, nástroji MCP a dovednostmi přes Unity Gateway. Nastavte přístup k modelu v nastavení Cursor IDE. Použijte Unity Gateway CLI (ug) k přidání MCP nástrojů a dovedností, nebo je nakonfigurujte ručně.

Než začnete

Potřebujete URL pracovního prostoru Azure Databricks a přístup k modelům, MCP službám a dovednostem, které chcete používat. Nainstalujte kurzor. Pro použití integrace ug MCP si také nainstalujte Cursor Agent, který poskytuje cursor-agent příkaz.

Pokud už váš administrátor vaše zařízení nakonfiguroval, postupujte podle pokynů vaší organizace.

IDE Cursor

1. Nastavte základní URL a API klíč

Otevřete Nastavení aplikace Cursor > Nastavení aplikace Cursor > Modely > Klíče API.

Povolte Override OpenAI Base URL a zadejte:

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

Nahraďte <workspace-hostname> názvem hostitele vašeho pracovního prostoru Azure Databricks. Vložte svůj osobní přístupový token Azure Databricks do API klíče OpenAI.

2. Přidat vlastní modely

V nastavení kurzoru klikněte na + Přidat vlastní model . Zadejte celý název základního modelu dostupného ve vašem pracovním prostoru a poté zapněte jeho přepínač. Opakujte to pro každý model, který chcete použít.

Příklady názvů modelů:

Provider Název modelu
OpenAI system.ai.gpt-5-5
Gemini system.ai.gemini-2-5-flash
Claude system.ai.claude-opus-4-6

Dostupné modely závisí na vašem pracovním prostoru a oprávněních. Toto spojení využívá modely poskytované Azure Databricks.

3. Otestujte spojení

Otevřete režim Ask na Cmd+L macOS nebo Ctrl+L na Windows/Linux. Vyberte si model a pošlete mu vzkaz. Požadavky používající tento vlastní model vedou přes Unity Gateway.

Agent kurzoru v terminálu

Použijte Unity Gateway CLI

Instalujte , poté spusťte ugtento příkaz z adresáře vašeho projektu:

ug cursor

Tím se ve vašem terminálu otevře Cursor Agent. Začněte pracovat se stejnými prompty a příkazy, které už používáte. Modely se spouštějí přes váš účet Cursor; ug ten nekonfiguruje směrování modelů pro agenta Cursor.

Přidat nástroje MCP

Použijte Unity Gateway CLI

S nainstalovaným Cursor Agentem běžte:

ug mcp add --agents cursor

Vyberte služby, které chcete přidat. ug je registruje v ~/.cursor/mcp.json, který používají IDE a agent terminálu. Restartujte Cursor nebo relaci agenta a pak jej požádejte, aby použil propojený nástroj.

Ručně konfigurujte MCP služby

Sločte tento záznam do :~/.cursor/mcp.json

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

Nahraďte název hostitele a token. Pro jinou službu použijte unikátní název serveru a nahraďte system.ai.dbsql ho jeho třídílným názvem Unity Catalog. Nesouvisející záznamy na serverech si ponechej.

Restartujte kurzor a požádejte agenta, aby použil nástroj. Pro konfiguraci OAuth viz dokumentaci MCP od Cursor.

Přidání dovedností

Použijte Unity Gateway CLI

Spusť picker pro stažení publikovaných dovedností:

ug skills add

Kurzor čte stažené dovednosti z ~/.agents/skills/. Začněte novou lekci a můžete je použít. Stažené soubory jsou lokální kopie; chcete-li získat aktualizace, spusťte příkaz znovu.

Registr dovedností připojit ručně

Pro načtení publikovaných dovedností přes MCP sločte tento záznam do ~/.cursor/mcp.json:

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

Nahraďte název hostitele a token, přičemž v URL zůstaňte závěrečná čára. Restartujte kurzor a požádejte ho, aby použil nějakou dovednost, například Use <catalog>.<schema>.<skill-name> to review this query.

Registr odhaluje dovednosti prostřednictvím MCP. Chcete-li nainstalovat soubory dovedností, které už máte, umístěte kompletní složku včetně SKILL.md a přibalených souborů do ~/.agents/skills/ nebo do .cursor/skills/ vašeho projektu. Viz dokumentaci dovedností Cursoru.

Dovednosti Unity Gateway jsou v beta verzi. Viz Govern skills pro zpřístupnění a oprávnění.

Troubleshooting

ug cursor Nemohu najít Cursor Agent: Nainstalovat Cursor Agent a zkontrolovat, zda je dostupný cursor-agent ve vašem terminálu.

Vlastní model selže v IDE: Zkontrolujte URL brány, expiraci tokenu, název modelu a oprávnění modelu. Vyberte v konverzaci vlastní model.

Selže připojení MCP nebo dovednosti: Zkontrolujte adresu URL, oprávnění služby a chybu konektoru. U ručních připojení také zkontrolujte expiraci tokenu. Pro ug problémy s nastavením spusťte ug doctor.

Chybí stažená dovednost: Zkontrolujte, že složka obsahuje SKILL.md a je v podporovaném adresáři dovedností. Stahování na uživatelské úrovni platí pro váš lokální počítač; nejsou automaticky dostupné pro Cloud Agents.

Další kroky

  • Last updated on