Cursor de conexión

Usa Cursor con modelos, herramientas MCP y habilidades a través de Unity Gateway. Configura el acceso al modelo en la configuración del IDE de Cursor. Usa la CLI de Unity Gateway (ug) para añadir herramientas y habilidades MCP, o configúralas manualmente.

Prerequisites

Necesitas la URL de tu espacio de trabajo de Azure Databricks y acceso a los modelos, MCPs y habilidades que quieres usar. Instala Cursor. Para usar la integración ug MCP, instala también Cursor Agent, que incluye el comando cursor-agent.

Si tu administrador ya ha configurado tu dispositivo, sigue las instrucciones de configuración de tu organización.

Cursor IDE

1. Configurar la URL base y la clave API

Abre Cursor > Ajustes > Ajustes de Cursor > Modelos > Claves de API.

Activa Anular la URL base de OpenAI e introduce:

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

Sustituye <workspace-hostname> por el nombre de host de tu espacio de trabajo de Azure Databricks. Pega tu token de acceso personal de Azure Databricks en OpenAI API Key.

2. Añadir modelos personalizados

Haga clic en + Agregar modelo personalizado en Configuración del cursor. Escribe el nombre completo de un modelo fundacional disponible en tu espacio de trabajo y luego activa su interruptor. Repite para cada modelo que quieras usar.

Nombres de modelos de ejemplo:

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

Los modelos disponibles dependen de tu espacio de trabajo y de los permisos. Esta conexión utiliza modelos proporcionados por Azure Databricks.

3. Prueba la conexión

Abre el modo Pregunta en Cmd+L macOS o Ctrl+L en Windows/Linux. Selecciona tu modelo y envía un mensaje. Las peticiones que usan ese modelo personalizado pasan por Unity Gateway.

Agente de cursor en el terminal

Utiliza la CLI de Unity Gateway

Instala ug, y luego ejecuta este comando desde el directorio de tu proyecto:

ug cursor

Esto abre el Agente Cursor en tu terminal. Empieza a usar las mismas indicaciones y comandos que ya usas. Los modelos se ejecutan a través de tu cuenta Cursor; ug no configura el enrutamiento de modelos para el Cursor Agent.

Añadir herramientas MCP

Para utilizar system.ai.dbsql, system.ai.sandbox o system.ai.web_search, un administrador de cuenta debe habilitar la beta de Unity Gateway desde la página Vistas previas de la consola de la cuenta. Consulte Administrar vistas previas de la cuenta.

Utiliza la CLI de Unity Gateway

Con Cursor Agent instalado, ejecuta:

ug mcp add --agents cursor

Selecciona los MCP que quieres añadir. ug las registra en ~/.cursor/mcp.json, que utilizan el IDE y el agente de terminal. Reinicia Cursor o la sesión de tu agente, y luego pídele que use una herramienta conectada.

Configurar los MCP manualmente

Usa OAuth para una conexión con actualización automática de token, o un token de acceso personal para pruebas locales.

Usa OAuth

Esta configuración utiliza mcp-remote y requiere Node.js con npx.

  1. Haz que un administrador de cuentas cree un cliente público OAuth con URL http://localhost:3334/oauth/callback de redirección y ámbito ai-gateway.

  2. Combine esta entrada en ~/.cursor/mcp.json, conservando los servidores existentes:

    {
  "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. Sustituye el nombre de host, el nombre MCP y el ID del cliente. Reinicia Cursor y completa el inicio de sesión en tu navegador.

Para conexiones simultáneas adicionales, utiliza un puerto de callback diferente para cada una y registra su URL de redirección correspondiente. Si tu organización requiere un cliente confidencial, consulta las credenciales estáticas de OAuth de mcp-remote.

Utiliza un token de acceso personal

Crea un token de acceso personal y fusiona esta entrada en ~/.cursor/mcp.json:

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

Cambia el nombre de host y el token. Para otro servicio, utiliza un nombre de servidor único y sustituye system.ai.dbsql por su nombre de Unity Catalog de tres partes. Mantén entradas de servidor no relacionadas y mantén los tokens fuera del control de versiones.

Reinicia Cursor, revisa el servidor en la configuración de MCP y pide al agente que llame a una herramienta de solo lectura. Para system.ai.dbsql, prueba SELECT 1 AS result. Confirma que el agente realiza una llamada a la herramienta y devuelve su resultado. Si el MCP pide el consentimiento del proveedor, abre su enlace de acceso, completa el inicio de sesión y luego vuelve a intentar la llamada. Consulte Autenticación y redes de MCP para los permisos y los errores de conexión.

Adición de aptitudes

Utiliza la CLI de Unity Gateway

Ejecuta el selector para descargar las habilidades publicadas:

ug skills add

El cursor lee las habilidades descargadas de ~/.agents/skills/. Empieza una nueva sesión para usarlos. Las descargas son instantáneas locales; vuelve a ejecutar el comando para obtener actualizaciones.

Conecta el registro de habilidades manualmente

Para cargar las habilidades publicadas a través de MCP, fusiona esta entrada en:~/.cursor/mcp.json

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

Sustituye el nombre de host y el token, manteniendo la barra final en la URL. Reinicia el cursor y pídele que use una habilidad, como Use <catalog>.<schema>.<skill-name> to review this query.

El registro expone las habilidades a través de MCP. Para instalar los archivos de habilidades que ya tengas, coloca la carpeta completa, incluidos SKILL.md y los archivos incluidos, en ~/.agents/skills/ o en el .cursor/skills/ de tu proyecto. Consulta la documentación sobre las habilidades de Cursor.

Las habilidades de Unity Gateway están en Beta. Consulta Habilidades de Gobierno para habilitación y permisos.

Troubleshooting

ug cursor No puedo encontrar el Agente del Cursor: Instala el Agente del Cursor y comprueba que cursor-agent está disponible en tu terminal.

Un modelo personalizado falla en el IDE: Comprueba la URL de la puerta de enlace, la expiración del token, el nombre del modelo y los permisos de tu modelo. Selecciona el modelo personalizado en la conversación.

Falla una conexión MCP o de habilidad: Comprueba la URL, los permisos MCP y el error del conector. Para conexiones manuales, también comprueba la expiración del token. Para problemas ug de configuración, ejecuta ug doctor.

Falta una habilidad descargada: Comprueba que su carpeta contiene SKILL.md y está en un directorio de habilidades soportado. Las descargas a nivel de usuario se aplican a tu máquina local; no están disponibles automáticamente para Cloud Agents.

Pasos siguientes

  • Última actualización el