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.
Antes de começar
Você precisa da URL do seu workspace do Databricks e de acesso aos modelos, serviços MCP e habilidades que deseja usar. Instale o Cursor. Para usar a integração MCP 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
Usar a CLI do Unity Gateway
Com o Cursor Agent instalado, execute:
ug mcp add --agents cursor
Selecione os serviços que você deseja adicionar. ug os registra em ~/.cursor/mcp.json, que a IDE e o agente de terminal usam. Reinicie o Cursor ou a sua sessão de agente e peça para ele usar uma ferramenta conectada.
Configurar serviços MCP manualmente
Fazer merge desta 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 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 do Unity Catalog. Mantenha entradas de servidor não relacionadas.
Reinicie o Cursor e peça ao agente para usar uma ferramenta. Para obter a configuração de OAuth, consulte a documentação do MCP do Cursor.
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 falha: 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 problemas de configuração de ug, execute 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.