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.

Antes de empezar

Necesitas la URL de tu espacio de trabajo de Azure Databricks y el acceso a los modelos, servicios MCP 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-2-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

Utiliza la CLI de Unity Gateway

Con Cursor Agent instalado, ejecuta:

ug mcp add --agents cursor

Selecciona los servicios que quieres añadir. ug los registra en ~/.cursor/mcp.json, que usan 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 servicios MCP manualmente

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.

Reinicia el cursor y pide al agente que use una herramienta. Para la configuración de OAuth, consulta la documentación MCP de Cursor.

Adición de aptitudes

Utiliza la CLI de Unity Gateway

Ejecuta el selector para descargar 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 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.

Se produce un error en una conexión MCP o de habilidad: Comprueba la URL, los permisos del servicio 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

  • Last updated on