Collega il cursore

Usa Cursor con modelli, strumenti MCP e abilità tramite Unity Gateway. Configura l'accesso al modello nelle impostazioni dell'IDE Cursor. Usa la CLI Unity Gateway (ug) per aggiungere strumenti e competenze MCP, oppure configurarli manualmente.

Prerequisites

Hai bisogno dell'URL dello spazio di lavoro di Azure Databricks e dell'accesso ai modelli, agli MCP e alle skill che vuoi utilizzare. Installa Cursor. Per utilizzare l'integrazione ug MCP, installa anche Cursor Agent, che fornisce il comando cursor-agent.

Se il tuo amministratore ha già configurato il tuo dispositivo, segui le istruzioni di configurazione della tua organizzazione.

IDE cursore

1. Configurare l'URL base e la chiave API

Apri Cursor > Impostazioni > Impostazioni di Cursor > Modelli > Chiavi API.

Abilita Override OpenAI Base URL e inserisci:

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

Sostituisci <workspace-hostname> con il tuo nome host di Azure Databricks workspace. Incolla il tuo token di accesso personale Azure Databricks nella chiave API OpenAI.

2. Aggiungi modelli personalizzati

Fare clic su + Aggiungi modello personalizzato in Impostazioni cursore. Inserisci il nome completo di un modello fondazionale disponibile nel tuo spazio di lavoro, quindi attiva il relativo interruttore. Ripeti per ogni modello che vuoi usare.

Nomi di modelli di esempio:

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

I modelli disponibili dipendono dal tuo spazio di lavoro e dai permessi. Questa connessione utilizza modelli forniti da Azure Databricks.

3. Testare la connessione

Apri la modalità Ask su Cmd+L macOS o Ctrl+L su Windows/Linux. Seleziona il tuo modello e invia un messaggio. Le richieste che usano quel modello personalizzato passano attraverso Unity Gateway.

Cursor Agent nel terminale

Utilizzare l'interfaccia a riga di comando di Unity Gateway

Installa ug, poi esegui questo comando dalla cartella del progetto:

ug cursor

Questo apre l'Agente Cursor nel tuo terminale. Inizia a lavorare con gli stessi prompt e comandi che già usi. I modelli vengono eseguiti tramite il tuo account Cursor; ug non configura il routing dei modelli per l'Agente Cursor.

Aggiungi strumenti MCP

Per utilizzare system.ai.dbsql, system.ai.sandbox, o system.ai.web_search, un amministratore dell'account deve abilitare la versione beta di Unity Gateway dalla pagina delle anteprime della console account. Vedi Gestisci le anteprime dell'account.

Utilizzare l'interfaccia a riga di comando di Unity Gateway

Con Cursor Agent installato, esegui:

ug mcp add --agents cursor

Seleziona gli MCP che vuoi aggiungere. ug li registra in ~/.cursor/mcp.json, che l'IDE e l'agente terminale usano. Riavvia Cursor o la sessione del tuo agente, poi chiedigli di usare uno strumento connesso.

Configura gli MCP manualmente

Usa OAuth per una connessione con aggiornamento automatico del token, oppure un token di accesso personale per i test locali.

Usa OAuth

Questa configurazione utilizza mcp-remote e richiede Node.js con npx.

  1. Fai creare un client OAuth pubblico da un amministratore dell’account con URL di reindirizzamento http://localhost:3334/oauth/callback e scope ai-gateway.

  2. Unisci questa voce in ~/.cursor/mcp.json, mantenendo i server esistenti:

    {
  "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. Sostituisci il nome host, il nome MCP e l'ID client. Riavvia Cursor e completa l'accesso nel browser.

Per ulteriori connessioni simultanee, usa una porta di callback diversa per ciascuna e registra l'URL di reindirizzamento corrispondente. Se la tua organizzazione richiede un client confidenziale, consulta le credenziali OAuth statiche di mcp-remote.

Usa un token di accesso personale

Crea un token di accesso personale e unisci questa voce in ~/.cursor/mcp.json:

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

Sostituisci il nome host e il token. Per un altro servizio, usa un nome server unico e sostituisci system.ai.dbsql con il nome Unity Catalog in tre parti. Mantieni separate le voci del server non correlate e tieni i token fuori dal controllo sorgente.

Riavvia Cursor, controlla il server nelle impostazioni MCP e chiedi all'agente di chiamare uno strumento di sola lettura. Per system.ai.dbsql, prova SELECT 1 AS result. Conferma che l'agente effettui una chiamata allo strumento e restituisca il risultato. Se l'MCP chiede il consenso del fornitore, apri il link di accesso, completa il login e poi riprova la chiamata. Vedi Autenticazione MCP e rete per permessi ed errori di connessione.

Aggiungere competenze

Utilizzare l'interfaccia a riga di comando di Unity Gateway

Esegui il selettore per scaricare le competenze pubblicate:

ug skills add

Il cursore legge le abilità scaricate da ~/.agents/skills/. Inizia una nuova sessione per usarli. I file scaricati sono istantanee locali; riesegui il comando per ottenere gli aggiornamenti.

Collega manualmente il registro delle competenze

Per caricare le competenze pubblicate tramite MCP, unisci questa voce in ~/.cursor/mcp.json:

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

Sostituisci il nome host e il token, mantenendo la barra finale nell'URL. Riavvia il Cursore e chiedigli di usare un'abilità, come ad esempio Use <catalog>.<schema>.<skill-name> to review this query.

Il registro mette a disposizione competenze attraverso MCP. Per installare i file di skill che hai già, inserisci la cartella completa, inclusi SKILL.md e i file inclusi nel pacchetto, in ~/.agents/skills/ o nella cartella .cursor/skills/ del tuo progetto. Consulta la documentazione sulle competenze di Cursor.

Le abilità Unity Gateway sono in Beta. Vedi Competenze di Governo per abilitazione e permessi.

Troubleshooting

ug cursor Non riesco a trovare Cursor Agent: installa Cursor Agent e controlla che cursor-agent sia disponibile nel tuo terminale.

Un modello personalizzato fallisce nell'IDE: Controlla l'URL del gateway, la scadenza del token, il nome del modello e i permessi del modello. Seleziona il modello personalizzato nella conversazione.

Una connessione MCP o skill fallisce: Controlla URL, permessi MCP e errore del connettore. Per le connessioni manuali, controlla anche la scadenza del token. Per problemi ug di setup, esegui ug doctor.

Manca una skill scaricata: Controlla che la sua cartella contenga SKILL.md e sia in una directory di skill supportata. I download a livello utente si applicano alla tua macchina locale; non sono automaticamente disponibili per gli Cloud Agent.

Passaggi successivi

  • Ultimo aggiornamento: