İmleci Bağla

Unity Gateway üzerinden modeller, MCP araçları ve yeteneklerle Cursor'u kullanın. Cursor IDE'nin ayarlarında model erişimini yapılandırın. MCP araçları ve becerileri eklemek için Unity Gateway CLI'yı (ug) kullanın veya bunları manuel olarak yapılandırın.

Başlamadan önce

Azure Databricks çalışma alanı URL'nize ve kullanmak istediğiniz modellere, MCP hizmetlerine ve becerilere erişiminiz olmalıdır. Cursor'u kur. MCP entegrasyonunu ug kullanmak için, komutu cursor-agent sağlayan Cursor Agent'ı da yükleyin.

Yöneticiniz cihazınızı zaten yapılandırdıysa, kuruluşunuzun kurulum talimatlarını takip edin.

İmleç IDE

1. Temel URL ve API anahtarını yapılandırmak

İmleç > ayarlarını > açın, İmleç ayarları>, modeller>, API anahtarları.

OpenAI Temel URL'sini Geçersiz Bırakmayı etkinleştirin ve girin:

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

<workspace-hostname> öğesini Azure Databricks çalışma alanı ana bilgisayar adınız ile değiştirin. Azure Databricks kişisel erişim tokenınızı OpenAI API Anahtarı'na yapıştırın.

2. Özel modeller ekleyin

İmleç Ayarları'nda + Özel Model Ekle'ye tıklayın. Çalışma alanında mevcut olan bir temel modelin tam adını girin, ardından onu etkinleştirin. Kullanmak istediğiniz her model için bunu tekrarlayın.

Örnek model isimleri:

Provider Model adı
OpenAI system.ai.gpt-5-5
Gemini system.ai.gemini-2-5-flash
Claude system.ai.claude-opus-4-6

Mevcut modeller çalışma alanınıza ve izinlerinize bağlıdır. Bu bağlantı, Azure Databricks tarafından sağlanan modelleri kullanır.

3. Bağlantıyı test edin

Ctrl+L modunu macOS’te veya Windows/Linux’ta Cmd+L tuşuyla açın. Modelinizi seçin ve bir mesaj gönderin. Bu özel model kullanılarak yapılan istekler Unity Gateway üzerinden yönlendirilir.

Terminalde İmleç Ajanı

Unity Gateway CLI'sini kullanın

Install ug, sonra proje dizininizden şu komutu çalıştırın:

ug cursor

Bu, terminalinizde Cursor Agent'i açar. Zaten kullandığınız aynı istemleri ve komutları kullanmaya başlayın. Modeller Cursor hesabınız üzerinden çalışır; ug Cursor Agent için model yönlendirmesini yapılandırmaz.

MCP araçları ekleyin

Unity Gateway CLI'sini kullanın

Cursor Agent yüklüyündeyse, çalıştırın:

ug mcp add --agents cursor

Eklemek istediğiniz hizmetleri seçin. ug, bunları IDE’nin ve terminal aracısının kullandığı ~/.cursor/mcp.json içine kaydeder. Cursor'u veya ajanı oturumunu yeniden başlat, sonra bağlı bir araç kullanmasını iste.

MCP hizmetlerini manuel olarak yapılandırma

Bu girdiyi ~/.cursor/mcp.json ile birleştirin:

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

Ana bilgisayar adını ve token'ı değiştirin. Başka bir hizmet için benzersiz bir sunucu adı kullanın ve system.ai.dbsql yerine Unity Kataloğu'nun üç parçalı adını yazın. İlgisiz sunucu girişlerini sakla.

Cursor'u yeniden başlatın ve ajandan bir araç kullanmasını iste. OAuth yapılandırması için Cursor'un MCP dokümantasyonuna bakınız.

Beceri ekleme

Unity Gateway CLI'sini kullanın

Yayınlanmış becerileri indirmek için picker'ı çalıştırın:

ug skills add

Cursor, indirilen yetenekleri ~/.agents/skills/ konumundan okur. Onları kullanmak için yeni bir oturum başlatın. İndirmeler yerel anlık görüntülerdir; güncellemeleri almak için komutu tekrar çalıştırın.

Beceri kaydını manuel olarak bağlayın

MCP aracılığıyla yayımlanmış becerileri yüklemek için bu girdiyi ~/.cursor/mcp.json içine birleştirin:

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

Sunucu adını ve token’ı değiştirin, URL’deki sondaki eğik çizgiyi koruyun. İmleci yeniden başlatın ve bir yetenek kullanmasını isteyin, örneğin Use <catalog>.<schema>.<skill-name> to review this query.

Kayıt cihazı, MCP aracılığıyla becerileri ortaya çıkarır. Zaten sahip olduğunuz yetenek dosyalarını yüklemek için, SKILL.md ve paketlenmiş dosyalar dahil olmak üzere tüm klasörü ~/.agents/skills/ veya projenizin .cursor/skills/ içine yerleştirin. Cursor'un beceri dokümantasyonuna bakınız.

Unity Gateway yetenekleri Beta'da. Etkinleştirme ve izinler için Yönetim becerileri bölümünü inceleyebilirsiniz.

Troubleshooting

ug cursor Cursor Agent bulamıyorum: Cursor Agent'i kur ve terminalinizde mevcut olup cursor-agent olmadığını kontrol edin.

Özel bir model IDE'de başarısız oluyor: Gateway URL'sini, token son kullanma süresini, model adını ve model izinlerinizi kontrol edin. Konuşmada özel modeli seçin.

Bir MCP veya beceri bağlantısı başarısız olursa: URL, hizmet izinleri ve bağlayıcı hatasını kontrol edin. Manuel bağlantılar için token süresi dolmasını da kontrol edin. ug kurulum sorunları için ug doctor komutunu çalıştırın.

İndirilmiş bir yetenek eksiktir: Klasörünün desteklenen bir beceri dizininde olup SKILL.md olmadığını kontrol edin. Kullanıcı seviyesinde indirmeler yerel makinenize uygulanır; Bulut Ajanları için otomatik olarak erişilebilir değildir.

Sonraki Adımlar

  • Last updated on