Cursor de Conexão

Use o Cursor com modelos, ferramentas MCP e habilidades através do Unity Gateway. Configure o acesso ao modelo nas configurações do IDE do Cursor. Use a CLI do Gateway Unity (ug) para adicionar ferramentas e habilidades MCP, ou configurá-las manualmente.

Antes de começar

Você precisa da URL do seu espaço de trabalho do Azure Databricks e acesso aos modelos, serviços MCP e habilidades que deseja usar. Instale o Cursor. Para usar a ug integração do MCP, instale também Cursor Agent, que fornece o comando cursor-agent.

Se seu administrador já configurou seu dispositivo, siga as instruções de configuração da sua organização.

Cursor IDE

1. Configurar a URL base e a chave API

Abrir Configurações > de Cursor > Configurações de Cursor > Modelos > Chaves de API.

Ative Substituir URL base do OpenAI e insira:

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

Substitua <workspace-hostname> pelo seu nome de host do workspace do Azure Databricks. Cole seu token de acesso pessoal do Azure Databricks na OpenAI API Key.

2. Adicionar modelos personalizados

Clique em + Adicionar Modelo Personalizado nas Configurações do Cursor. Insira o nome completo de um modelo fundamental disponível em seu workspace e, em seguida, ative a opção correspondente. Repita para cada modelo que você quiser usar.

Nomes de modelos de exemplo:

Provider Nome do modelo
OpenAI system.ai.gpt-5-5
Gemini system.ai.gemini-2-5-flash
Claude system.ai.claude-opus-4-6

Os modelos disponíveis dependem do seu espaço de trabalho e das permissões. Essa conexão utiliza modelos fornecidos pelo Azure Databricks.

3. Teste a conexão

Abra o modo Ask com Cmd+L no macOS ou Ctrl+L no Windows/Linux. Selecione seu modelo e envie uma mensagem. As requisições que usam esse modelo personalizado passam pelo Unity Gateway.

Agente do Cursor no terminal

Use o CLI do Unity Gateway

Instale ug, então execute este comando a partir do diretório do seu projeto:

ug cursor

Isso abre o Cursor Agent no seu terminal. Comece a trabalhar com os mesmos prompts e comandos que você já usa. Os modelos são executados por meio da sua conta do Cursor; ug não define o roteamento de modelos para o Cursor Agent.

Adicionar ferramentas MCP

Use o CLI do Unity Gateway

Com o Cursor Agent instalado, execute:

ug mcp add --agents cursor

Selecione os serviços que deseja adicionar. ug os registra em ~/.cursor/mcp.json, que o IDE e o agente de terminal utilizam. Reinicie o Cursor ou a sessão do seu agente, depois peça para ele usar uma ferramenta conectada.

Configure os serviços MCP manualmente

Misture esta entrada em ~/.cursor/mcp.json:

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

Substitua o nome do host e o token. Para outro serviço, use um nome único de servidor e substitua system.ai.dbsql pelo nome de três partes do Catálogo Unity. Mantenha entradas de servidor não relacionadas.

Reinicie o Cursor e peça para o agente usar uma ferramenta. Para a configuração do OAuth, veja a documentação MCP do Cursor.

Adicionar habilidades

Use o CLI do Unity Gateway

Execute o seletor para baixar as habilidades publicadas:

ug skills add

O cursor lê as habilidades baixadas de ~/.agents/skills/. Comece uma nova sessão para usá-los. Os downloads são instantâneos locais; execute novamente o comando para obter atualizações.

Conecte manualmente o registro de habilidades

Para carregar as habilidades publicadas pelo MCP, mescle esta entrada em ~/.cursor/mcp.json:

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

Substitua o nome do host e o token, mantendo a barra final na URL. Reinicie o Cursor e peça para ele usar uma habilidade, como Use <catalog>.<schema>.<skill-name> to review this query.

O registro expõe habilidades por meio do MCP. Para instalar os arquivos de skill que você já tem, coloque a pasta completa, incluindo SKILL.md e os arquivos empacotados, em ~/.agents/skills/ ou em .cursor/skills/ do seu projeto. Veja a documentação de habilidades do Cursor.

As habilidades do Gateway Unity estão em Beta. Veja Habilidades de Governar para habilitação e permissões.

Solução de problemas

ug cursor Não consigo encontrar o Cursor Agent: Instale o Cursor Agent e verifique se cursor-agent está disponível no seu terminal.

Um modelo personalizado falha no IDE: Verifique a URL do gateway, expiração do token, nome do modelo e suas permissões de modelo. Selecione o modelo personalizado na conversa.

uma conexão com o MCP ou com uma habilidade falhou: verifique a URL, as permissões de serviço e o erro do conector. Para conexões manuais, verifique também a expiração do token. Para ug problemas de configuração, execute ug doctor.

Uma habilidade baixada está faltando: Verifique se a pasta dela contém SKILL.md e está em um diretório de habilidades suportado. Downloads em nível de usuário se aplicam à sua máquina local; eles não estão automaticamente disponíveis para os Cloud Agents.

Próximas Etapas 

  • Last updated on