İ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.

Prerequisites

Azure Databricks çalışma alanı URL'nize ve kullanmak istediğiniz modellere, MCP'lere 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-3-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

system.ai.sandbox, system.ai.web_search veya system.ai.dbsql kullanmak için, bir hesap yöneticisinin hesap konsolundaki Previews sayfasından Unity Gateway beta sürümünü etkinleştirmesi gerekir. Hesap önizlemelerini yönet bölümüne bakınız.

Unity Gateway CLI'sini kullanın

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

ug mcp add --agents cursor

Eklemek istediğiniz MCP'leri 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'leri manuel olarak yapılandırın

Otomatik token yenileme ile bağlantı için OAuth, yerel test için ise kişisel erişim tokenı kullanın.

Yönetici tarafından oluşturulan bir OAuth uygulaması olmadan oturum açmak için varsayılan Cursor istemci kimliğini kullanın, https://cursor.com/oauth/mcp-client.jsonburada. Aşağıdaki OAuth talimatları, mcp-remote içeren özel bir uygulama için bir alternatiftir.

Özel bir OAuth uygulaması kullanın

Bu yapılandırma mcp-remote kullanır ve npx ile Node.js gerektirir.

  1. Bir hesap yöneticisinin yönlendirme URL'si ai-gateway ve kapsamı olan halka açık bir OAuth istemcisi http://localhost:3334/oauth/callback sağla.

  2. Mevcut sunucuları koruyarak bu girdiyi ~/.cursor/mcp.json içine birleştirin:

    {
  "mcpServers": {
    "databricks-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>?o=<workspace-id>",
        "3334",
        "--static-oauth-client-info",
        "{\"client_id\":\"<client-id>\"}",
        "--static-oauth-client-metadata",
        "{\"scope\":\"ai-gateway offline_access\"}"
      ]
    }
  }
}

  3. Host adı, çalışma alanı kimliği, MCP adı ve istemci kimliğini değiştirin. Cursor’ı yeniden başlatın ve tarayıcınızda oturum açma işlemini tamamlayın.

Ek eşzamanlı bağlantılar için, her biri için farklı bir geri çağrı portu kullanın ve eşleşen yönlendirme URL'sini kaydedin. Kuruluşunuz gizli istemci gerektiriyorsa, mcp-remote'un statik OAuth kimlik bilgilerine bakın.

Kişisel erişim tokeni kullanın

Bir kişisel erişim belirteci oluşturun ve bu girişi şu şekilde ~/.cursor/mcp.jsonbirleştirin:

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

Ana bilgisayar adını, çalışma alanı kimliğini 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. İlgili olmayan sunucu girdilerini sakla ve tokenları kaynak kontrolünden uzak tut.

Cursor'u yeniden başlatın, sunucuyu MCP ayarlarında kontrol edin ve ajana salt okunur bir araç çağırmasını isteyin. system.ai.dbsql için, SELECT 1 AS result deneyin. Temsilcinin bir araç çağrısı yapıp sonucunu geri verdiğini doğrulayın. MCP sağlayıcı onayı isterse, giriş bağlantısını açın, girişi tamamlayın, ardından çağrıyı yeniden deneyin. İzinler ve bağlantı hataları için MCP doğrulamasına 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'yi, MCP izinlerini ve bağlantı 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

  • Son güncelleştirme: