Verbind Cursor

Gebruik Cursor met modellen, MCP-tools en vaardigheden via Unity Gateway. Configureer modeltoegang in de instellingen van Cursor IDE. Gebruik de Unity Gateway CLI (ug) om MCP-tools en vaardigheden toe te voegen, of configureer ze handmatig.

Prerequisites

Je hebt je Azure Databricks workspace-URL nodig en toegang tot de modellen, MCP's en vaardigheden die je wilt gebruiken. Installeer Cursor. Om de ug MCP-integratie te gebruiken, installeer ook Cursor Agent, die het cursor-agent commando geeft.

Als je beheerder je apparaat al heeft geconfigureerd, volg dan de installatie-instructies van je organisatie.

Cursor IDE

1. Configureer de basis-URL en API-sleutel

Open Cursor-instellingen >> Cursor-instellingen > Modellen > API-sleutels.

Schakel Override OpenAI Base URL in en voer het volgende in:

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

Vervang <workspace-hostname> door je hostnaam van je Azure Databricks workspace. Plak je Azure Databricks persoonlijke toegangstoken in OpenAI API Key.

2. Voeg aangepaste modellen toe

Klik op + Aangepast model toevoegen in cursorinstellingen. Voer de volledige naam in van een basismodel dat beschikbaar is in je werkruimte en zet vervolgens de schakelaar aan. Herhaal dit voor elk model dat je wilt gebruiken.

Voorbeeldmodelnamen:

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

Beschikbare modellen hangen af van je werkruimte en permissies. Deze verbinding maakt gebruik van modellen die door Azure Databricks worden geleverd.

3. Test de verbinding

Open de Ask-modus met Cmd+L op macOS of met Ctrl+L op Windows/Linux. Selecteer je model en stuur een bericht. Verzoeken die dat aangepaste model gebruiken, worden via Unity Gateway geleid.

Cursor Agent in de terminal

Gebruik de Unity Gateway CLI

Installeer ugen voer vervolgens dit commando uit vanuit je projectmap:

ug cursor

Dit opent Cursor Agent in je terminal. Begin met dezelfde prompts en commando's die je al gebruikt. Modellen draaien via je Cursor-account; ug configureert geen modelrouting voor Cursor Agent.

Voeg MCP-tools toe

Om system.ai.sandbox, system.ai.web_search of system.ai.dbsql te gebruiken, moet een accountbeheerder de Unity Gateway beta inschakelen via de pagina Previews van de accountconsole. Zie Voorbeelden van accounts beheren.

Gebruik de Unity Gateway CLI

Met Cursor Agent geïnstalleerd, voer uit:

ug mcp add --agents cursor

Selecteer de MCP's die je wilt toevoegen. ug registreert ze in ~/.cursor/mcp.json, die de IDE en de terminalagent gebruiken. Herstart Cursor of je agent-sessie opnieuw en vraag hem dan om een verbonden tool te gebruiken.

Configureer MCPs handmatig

Gebruik OAuth voor een verbinding met automatische tokenverversing, of een persoonlijke toegangstoken voor lokaal testen.

Gebruik OAuth

Deze configuratie gebruikt mcp-remote en vereist Node.js met npx.

  1. Laat een accountbeheerder een publieke OAuth-client aanmaken met redirect-URL http://localhost:3334/oauth/callback en scope ai-gateway.

  2. Voeg deze invoer samen in ~/.cursor/mcp.json, waarbij bestaande servers behouden blijven:

    {
  "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. Vervang de hostnaam, MCP-naam en client-ID. Herstart Cursor en voltooi het aanmelden in je browser.

Voor extra gelijktijdige verbindingen gebruik je voor elke een andere callback-poort en registreer je de bijbehorende redirect-URL. Als je organisatie een vertrouwelijke client nodig heeft, bekijk dan de statische OAuth-credentials van mcp-remote.

Gebruik een persoonlijk toegangstoken

Maak een persoonlijk toegangstoken aan en voeg dit item samen in ~/.cursor/mcp.json:

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

Vervang de hostnaam en token. Voor een andere dienst gebruik je een unieke servernaam en vervang system.ai.dbsql deze door de driedelige Unity Catalog-naam ervan. Houd niet-gerelateerde serververmeldingen en houd tokens buiten versiebeheer.

Herstart Cursor, controleer de server in de MCP-instellingen en vraag de agent om een alleen-lezen tool aan te roepen. Voor system.ai.dbsql, probeer SELECT 1 AS result. Bevestig dat de agent een toolcall maakt en het resultaat teruggeeft. Als de MCP om toestemming van de provider vraagt, open dan de inloglink, voltooi de aanmelding en probeer de aanroep opnieuw. Zie MCP-authenticatie en netwerkverbindingen voor machtigingen en verbindingsfouten.

Vaardigheden toevoegen

Gebruik de Unity Gateway CLI

Gebruik de picker om gepubliceerde vaardigheden te downloaden:

ug skills add

De cursor leest de gedownloade vaardigheden uit ~/.agents/skills/. Begin een nieuwe sessie om ze te gebruiken. Downloads zijn lokale snapshots; voer het commando opnieuw uit om updates op te halen.

Verbind het vaardigheidsregister handmatig

Om gepubliceerde vaardigheden via MCP te laden, voeg deze vermelding samen met ~/.cursor/mcp.json:

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

Vervang de hostnaam en token, waarbij de achterliggende streep in de URL blijft. Herstart de cursor en vraag hem een vaardigheid te gebruiken, zoals Use <catalog>.<schema>.<skill-name> to review this query.

Het register onthult vaardigheden via MCP. Om skill-bestanden die je al hebt te installeren, plaats je de volledige map, inclusief SKILL.md en gebundelde bestanden, in ~/.agents/skills/ of in de .cursor/skills/map van je project. Zie de vaardigheidsdocumentatie van Cursor.

Unity Gateway-vaardigheden bevinden zich in de bètafase. Zie Vaardigheden beheren voor inschakelen en machtigingen.

Troubleshooting

ug cursor Kan Cursor Agent niet vinden: Installeer Cursor Agent en controleer of dat cursor-agent beschikbaar is in je terminal.

Een aangepast model faalt in de IDE: Controleer de gateway-URL, tokenvervaldatum, modelnaam en je modelrechten. Selecteer het aangepaste model in het gesprek.

Een MCP- of vaardigheidsverbinding faalt: Controleer de URL, MCP-permissies en connectorfout. Controleer voor handmatige verbindingen ook de vervaldatum van token. Voer ug doctor uit voor problemen met het instellen van ug.

Een gedownloade skill ontbreekt: Controleer of de map SKILL.md bevat en zich in een ondersteunde skillmap bevindt. Downloads op gebruikersniveau zijn van toepassing op je lokale machine; ze zijn niet automatisch beschikbaar voor Cloud Agents.

Volgende stappen 

  • Laatst bijgewerkt om