Ligar Cursor

Use o Cursor com modelos, ferramentas MCP e competências através do Unity Gateway. Configurar o acesso ao modelo nas definições do IDE Cursor. Utilize a CLI do Unity Gateway (ug) para adicionar ferramentas e competências MCP ou para as configurar manualmente.

Prerequisites

Precisas do URL do teu espaço de trabalho do Azure Databricks e de acesso aos modelos, MCPs e competências que queres usar. Instala Cursor. Para usar a ug integração MCP, instale também o Cursor Agent, que fornece o cursor-agent comando.

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

Cursor IDE

1. Configurar a URL base e a chave API

Abra >Definições > Definições do Cursor > Modelos > Chaves de API.

Ative Override OpenAI Base URL e introduza:

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

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

2. Adicionar modelos personalizados

Clique + Adicionar Modelo Personalizado nas Definições do cursor. Introduza o nome completo de um modelo fundacional disponível no seu espaço de trabalho e, de seguida, ative o respetivo interruptor. Repita para cada modelo que queira usar.

Exemplos de nomes de modelos:

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. Esta ligação utiliza modelos fornecidos pelo Azure Databricks.

3. Testar a ligação

Abra o modo de Perguntas no macOS com Cmd+L ou no Windows/Linux com Ctrl+L. Selecione o seu modelo e envie uma mensagem. Os pedidos que usam esse modelo personalizado passam pelo Unity Gateway.

Agente de cursor no terminal

Utilize a CLI do Unity Gateway

Instale ug, depois execute este comando a partir do diretório do seu projeto:

ug cursor

Isto abre o Cursor Agent no teu terminal. Começa a trabalhar com os mesmos prompts e comandos que já usas. Os modelos são executados através da sua conta Cursor; ug não configura o encaminhamento 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 da consola da conta. Consulte Gerir pré-visualizações da conta.

Utilize a CLI do Unity Gateway

Com o Cursor Agent instalado, execute:

ug mcp add --agents cursor

Seleciona os MCPs que queres adicionar. ug regista-os em ~/.cursor/mcp.json, que o IDE e o agente terminal utilizam. Reinicia o Cursor ou a sessão do teu agente, depois pede-lhe para usar uma ferramenta ligada.

Configurar os MCPs manualmente

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

Utilizar OAuth

Esta configuração utiliza mcp-remote e requer Node.js com npx.

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

  2. Intercale 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 início de sessão no seu navegador.

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

Utilize um token de acesso pessoal

Crie um token de acesso pessoal e una esta entrada em ~/.cursor/mcp.json:

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

Substitui o nome do host e o token. Para outro serviço, use um nome de servidor único e substitua system.ai.dbsql pelo seu nome de três partes do Catálogo Unity. Mantenha entradas de servidor não relacionadas e mantenha os tokens fora do controlo de código fonte.

Reinicie o Cursor, verifique o servidor nas definições do MCP e peça ao agente para chamar uma ferramenta de apenas leitura. Para system.ai.dbsql, tente SELECT 1 AS result. Confirme que o agente faz uma chamada de ferramenta e devolve o resultado. Se o MCP pedir o consentimento do fornecedor, abra o link de login, complete o início de sessão e depois tente novamente a chamada. Consulte autenticação MCP e ligação em rede para permissões e erros de ligação.

Adicionar competências

Utilize a CLI do Unity Gateway

Execute o seletor para descarregar as competências publicadas:

ug skills add

O cursor lê as habilidades descarregadas de ~/.agents/skills/. Comece uma nova sessão para os usar. Os downloads são snapshots locais; reexecute o comando para obter atualizações.

Ligue manualmente o registo de competências

Para carregar as competências publicadas através do MCP, adicione esta entrada a ~/.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-lhe para usar uma habilidade, como Use <catalog>.<schema>.<skill-name> to review this query.

O registo expõe competências através do MCP. Para instalar ficheiros de skill que já tem, coloque a pasta completa, incluindo SKILL.md e os ficheiros incluídos, em ~/.agents/skills/ ou em .cursor/skills/ do seu projeto. Consulte a documentação de competências do Cursor.

As funcionalidades do Unity Gateway estão em versão beta. Consulte Competências de Governar para habilitação e permissões.

Troubleshooting

ug cursor Não consigo encontrar o Cursor Agent: Install Cursor Agent e verifica se cursor-agent está disponível no teu terminal.

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

Uma ligação MCP ou skill falha: Verifique o URL, as permissões MCP e o erro do conector. Para ligações manuais, verifique também a expiração do token. Para problemas de configuração de ug, execute ug doctor.

Falta uma habilidade descarregada: Verifique se a sua pasta contém SKILL.md e está num diretório de habilidades suportado. Os downloads ao nível do utilizador aplicam-se à sua máquina local; não estão automaticamente disponíveis para os Cloud Agents.

Passos seguintes

  • Última atualização a