Conectar Cursor
Use o Cursor com modelos, ferramentas MCP e habilidades por meio do Unity Gateway. Configure o acesso ao modelo nas configurações do Cursor IDE. Use a CLI do Unity Gateway (ug) para adicionar ferramentas e habilidades MCP ou configurá-las manualmente.
Prerequisites
Você precisa da URL do seu workspace Databricks e de acesso aos modelos, MCPs e skills que deseja usar. Instale o Cursor. Para usar a integração MCP de ug, instale também o Cursor Agent, que fornece o comando cursor-agent.
Se o seu administrador já tiver configurado o seu dispositivo, siga as instruções de configuração da sua organização.
IDE Cursor
1. Configure a URL base e a API key
Abra Cursor > Settings > Cursor Settings > Models > API Keys .
Ative Substituir URL base da OpenAI e insira:
https://<workspace-hostname>/ai-gateway/cursor/v1
Substitua <workspace-hostname> pelo hostname do seu workspace do Databricks. Cole seu token de acesso pessoal do Databricks em OpenAI API Key .
2. Adicionar modelos personalizados
Clique em + Adicionar modelo personalizado nas configurações do Cursor. Insira o nome completo de um foundation model disponível no seu workspace e, em seguida, ative a opção dele. Repita para cada modelo que você deseja usar.
Exemplos de nomes de modelos:
Provedor | Nome do modelo |
|---|---|
OpenAI |
|
Gemini |
|
Claude |
|
Os modelos disponíveis dependem do seu workspace e das suas permissões. Essa conexão usa modelos fornecidos pela Databricks.
3. Testar a conexão
Open Ask mode with Cmd+L on macOS or Ctrl+L on Windows/Linux. Select your model and send a message. Requests using that custom model route through Unity Gateway.
Cursor Agent no terminal
Usar a CLI do Unity Gateway
Install ug, then run this comando from your project directory:
ug cursor
Isso abre o Cursor Agent no seu terminal. Começar a trabalhar com os mesmos prompts e comandos que você já usa. Os modelos são executados por meio da sua account do Cursor; o 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 account deve habilitar a versão beta do Unity Gateway na página Previews do console da account. Consulte Gerenciar prévias da account.
Usar a CLI do Unity Gateway
Com o Cursor Agent instalado, execute:
ug mcp add --agents cursor
Selecione os MCPs que deseja adicionar. O ug registra-os em ~/.cursor/mcp.json, que o IDE e o agente de terminal usam. Reinicie o Cursor ou sua sessão do agente e, em seguida, peça a ele que use uma ferramenta conectada.
Configurar MCPs manualmente
Use OAuth para uma conexão com refresh automático de tokens ou um access token pessoal para testes locais.
Usar OAuth
Esta configuração usa mcp-remote e requer o Node.js com npx.
-
Peça a um administrador de account que crie um cliente OAuth público com a URL de redirecionamento
http://localhost:3334/oauth/callbacke o escopoai-gateway. -
Fazer merge desta entrada em
~/.cursor/mcp.json, mantendo os servidores existentes:JSON{
"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\"}"
]
}
}
} -
Substitua o hostname, o nome do MCP e a ID do cliente. Reinicie o Cursor e conclua o login no seu navegador.
Para conexões simultâneas adicionais, use uma porta de retorno de chamada diferente para cada uma e registre o URL de redirecionamento correspondente. Se a sua organização exigir um cliente confidencial, consulte as credenciais OAuth estáticas do mcp-remote.
Usar um access token pessoal
Create a personal access token and merge this entry into ~/.cursor/mcp.json:
{
"mcpServers": {
"dbsql": {
"url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
"headers": {
"Authorization": "Bearer <databricks-pat>"
}
}
}
}
Substitua o hostname e o token. Para outro serviço, use um nome de servidor exclusivo e substitua system.ai.dbsql pelo nome de três partes no Unity Catalog. Mantenha as entradas de servidor não relacionadas e mantenha os tokens fora do controle de origem.
Reinicie o Cursor, verifique o servidor em suas configurações de MCP e peça ao agente para 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 solicitar o consentimento do provedor, abra o link de login, conclua o login e tente fazer a chamada novamente. Consulte Autenticação e rede do MCP para obter permissões e erros de conexão.
Adicionar habilidades
Usar a CLI do Unity Gateway
Execute o seletor para download das habilidades publicadas:
ug skills add
O Cursor lê as habilidades download de ~/.agents/skills/. Inicie uma nova sessão para usá-las. Os downloads são snapshots locais; execute o comando novamente para obter atualizações.
Conecte o registro de habilidades manualmente
Para carregar habilidades publicadas por meio do MCP, faça o merge desta entrada em ~/.cursor/mcp.json:
{
"mcpServers": {
"databricks-skill-registry": {
"url": "https://<workspace-hostname>/ai-gateway/skills/",
"headers": {
"Authorization": "Bearer <databricks-pat>"
}
}
}
}
Substitua o hostname e o token, mantendo a barra à direita 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 arquivos de habilidade que você já possui, coloque a pasta completa, incluindo SKILL.md e arquivos empacotados, em ~/.agents/skills/ ou em .cursor/skills/ do seu projeto. Consulte a documentação de habilidades do Cursor.
Unity Gateway skills are in Beta. See Govern skills for enablement and permissions.
Solução de problemas
ug cursor não pode 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, a expiração do token, o nome do modelo e as permissões do seu modelo. Selecione o modelo personalizado na conversa.
Uma conexão de MCP ou de habilidade (skill) falha: verifique o URL, as permissões de MCP e o erro do conector. Para conexões manuais, verifique também a expiração do token. Para problemas de configuração de ug, execução ug doctor.
Uma skill de download está ausente: verifique se a pasta dela contém SKILL.md e está em um diretório de skills compatível. Os downloads em nível de usuário se aplicam à sua máquina local; eles não estão disponíveis automaticamente para Cloud Agents.