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.

Prerequisites

Você precisa da URL do seu workspace do Azure Databricks e acesso aos modelos, MCPs 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-3-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

Para usar system.ai.dbsql, system.ai.sandbox, ou system.ai.web_search, um administrador de conta deve ativar a versão beta do Unity Gateway a partir da página de Pré-visualizações do console da conta. Veja Gerenciar prévias da conta.

Use o CLI do Unity Gateway

Com o Cursor Agent instalado, execute:

ug mcp add --agents cursor

Selecione os MCPs que você quer 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 MCPs manualmente

Use o OAuth para uma conexão com atualização automática do token, ou um token de acesso pessoal para testes locais.

Usar OAuth

Essa configuração usa mcp-remote e requer Node.js com npx.

  1. Peça para um administrador de conta criar um cliente OAuth público com URL http://localhost:3334/oauth/callback de redirecionamento e escopo ai-gateway.

  2. Mescle esta entrada em ~/.cursor/mcp.json, mantendo os 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. Substitua o nome do host, nome MCP e ID do cliente. Reinicie o Cursor e complete o login no seu navegador.

Para conexões simultâneas adicionais, use uma porta de callback diferente para cada uma e registre sua URL de redirecionamento correspondente. Se sua organização exige um cliente confidencial, consulte as credenciais OAuth estáticas do mcp-remote.

Use um token de acesso pessoal

Crie um token de acesso pessoal e mescle 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 e mantenha tokens fora do controle de versão.

Reinicie o Cursor, verifique o servidor nas configurações do MCP e peça para o agente chamar uma ferramenta somente leitura. Para system.ai.dbsql, tente SELECT 1 AS result. Confirme que o agente faz uma chamada de ferramenta e retorna seu resultado. Se o MCP pedir consentimento do provedor, abra o link de login, conclua o login e tente a chamada novamente. Veja autenticação MCP e rede para permissões e erros de conexão.

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.

Se uma conexão MCP ou skill falhar: Verifique a URL, as permissões MCP 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 

  • Última atualização em