MCP doğrulama ve ağ

Adım adım kurulum için kodlama ajanınızın rehberini veya Python hızlı başlangıcını kullanın. Paylaşılan kimlik doğrulama gereksinimlerini ve ağ erişimini kontrol etmek için bu sayfayı kullanın.

Log in to Azure Databricks

Etkileşimli işler için Azure Databricks kullanıcı hesabınızı veya rehbersiz çalışan bir ajan için bir hizmet prensibi kullanın. Temsilciniz için kurulumu takip edin:

Kullanım örneği	Önerilen kurulum
Kodlama aracıları	Unity Gateway CLI'sını kullanın. Giriş işlemlerini ve kimlik bilgilerini yeniler.
Yerel Python geliştirme	Databricks CLI giriş girişini kullanın.
Diğer etkileşimli MCP istemcileri	OAuth'u kayıtlı bir istemci kimliğiyle yapılandırın.
Gözetimsiz ajanlar	OAuth makineden makineye (M2M) olan bir servis prensibi kullanın. Databricks Uygulamalarındaki ajanlar için bkz. Ajan kimlik doğrulama.

Kullanıcı veya hizmet yöneticisinin MCP'yi aramak için izni gerekir. Bir araç sizden harici bir sağlayıcıya giriş yapmanızı isterse, Dış hizmetler kurulumunu takip edin.

Yerel testler, Databricks tarafından sağlanan ve kayıtlı MCP'ler ile eski çalışma alanı uç noktaları için, başlıkta Authorization: Bearer <token>kişisel erişim belirteğini kabul edin. Tokenları kaynak kontrolünden uzak tutun. Databricks Uygulamalarında barındırılan sunucular OAuth gerektirir ve kişisel erişim tokenlarını kabul etmez.

Özel bir OAuth istemcisi yapılandırma

Müşteriniz kendi OAuth uygulamasına ihtiyaç duyduğunda bunu kullanın. Claude Code ve Codex rehberleri, istemci özel ayarlarını içerir.

1. İstemcinizden tam yönlendirme URL'sini, barındırıcı, port ve yol dahil olmak üzere alın.

2. Bir hesap yöneticisine hesap konsolundaAyarlar'ı aç, Uygulama bağlantılarını seç ve Bağlantı ekle seçeneğine tıkla.

3. Bir isim girin, yönlendirme URL'sini ekleyin ve sunucunuzun kapsamlarını seçin:

   Sunucu	URL	Scope
   Sağlanan veya kayıtlı MCP	https://<workspace-hostname>/ai-gateway/mcp-services/<catalog>.<schema>.<service>	ai-gateway
   Server on Databricks Apps	https://<app-url>/mcp	Uygulamanın kullanıcı yetkilendirme kapsamlarını da ekleyin. Ayrıca uygulamada KULLANABİLİRİLİRİN de gerekiyor.
   Workspace MCP endpoint (legacy)	Sunucunun sayfasındaki URL	O sunucu için listelenen kapsamları kullanın.

4. İstemci sırrı oluşturup oluşturmayacağınızı seçin:

   • Masaüstü veya CLI istemcisi (açık istemci):Temizle: İstemci sırrı oluştur.
   • Sırları güvenli şekilde depolayan sunucu tarafı istemcisi (gizli istemci): Seçilmiş bir istemci sırrı oluştur .

5. Bağlantıyı kaydedin ve İstemci Kimliği'ni kopyalayın. Eğer bir istemci sırrı oluşturduysanız, o değeri de kopyalayın.

6. MCP istemcinizde sunucu URL'sini ve istemci kimlik bilgilerini girin. Streamable HTTP kullanın, sunucunun kapsamını ve offline_access yenileme tokenlarını talep edin ve giriş yapın.

UI ve CLI seçenekleri için Create an OAuth uygulamasına bakınız. Değişikliklerin etkisi 30 dakikaya kadar sürebilir. Azure Databricks MCP uç noktaları dinamik istemci kaydını desteklemez, bu yüzden önceden yapılandırılmış istemci ID'sini kabul eden bir istemci kullanın.

Ağ erişimi

İstemciden çalışma alanına ve çalışma alanından harici sunucuya erişimi kontrol edin.

İstemden çalışma alanına

MCP talepleri, çalışma alanınızın gelen ağ kontrolleri tarafından izin verilmelidir. Workspace IP erişim listeleri etkinse, bir yöneticiye isteklerin geldiği genel IP adreslerine izin vermesini isteyin:

MCP istemcisi nerede çalışıyor	İzin verilen adresler
Bilgisayarınızda, örneğin Claude Code, Codex CLI veya Cursor	Ağınızın kamuya açık giden IP'si. Trafik kurumsal bir VPN veya proxy üzerinden geçerse, o ağın dış IP adresini kullanın. Ağ yöneticiniz bunu sağlayabilir.
Claude bağlantı veya ChatGPT gibi barındırılan bir hizmette	Sağlayıcının yayımladığı dış IP IP aralıkları. Claude'un giden IP'lerine ve ChatGPT'ye giden IP'lerine bakınız.

Barındırılan istemciler için, tarayıcı girişi sizin ağınızdan gelirken, MCP çağrıları sağlayıcının sunucularından gelir. İkisine de izin verilmeli. Örneğin, kurumsal VPN'den başarılı bir şekilde giriş yapmak, ChatGPT'nin MCP'nize ulaşabileceği anlamına gelmez.

Eğer kuruluşunuz ayrıca bağlam tabanlı giriş kontrolleri kullanıyorsa, talepler de bu politikaları karşılamalıdır. Hesap IP erişim listeleri , bir yöneticinin OAuth uygulaması oluşturması gibi hesap konsolu ve hesap API erişimi için geçerlidir.

Çalışma alanından harici MCP sunucusuna

Unity Gateway üzerinden harici MCP sağlayıcılarına yapılan çağrılar, çalışma alanının sunucusuz hesaplama düzlemini kullanır. Bu, kayıtlı harici sunucular ve Databricks tarafından sağlanan MCP'ler için geçerlidir.

Sunucusuz ağ politikanızKısıtlı erişim kullanıyorsa, sunucunun tam nitelikli alan adını (FQDN) İzin verilen alan adlarına ekleyin. MCP'nin Unity Kataloğu bağlantısındaki sunucudan başlayın. Ek bloklanmış varış noktalarını kontrol system.access.outbound_network edin. Ağ politikalarını Yönet ve Giden ağ günlüklerini kontrol et.

• Bir Unity Kataloğu bağlantısı otomatik olarak hedefine izin vermez.
• Tam erişim , sunucusuz ağ politikasının varsayılan olarak giden internet bağlantılarına izin verme modudur. Açıkça engellenen alan adları reddediliyor. Örneğin, o MCP sunucusuna yapılan çağrıları engelleyen bir politika mcp.example.com olabilir. Bir yöneticiden politikanın engellenmiş hedeflerini incelemesini iste.
• Kuru çalıştırma modunda MCP trafiğini test etmek için Tüm ürünler seçeneğini seçin. Databricks SQL ve AI model servis seçenekleri MCP trafiğini kuru çalıştırmaya sokmaz.

Özel bağlantı

Bulut ağınızda bir MCP sunucusuna ulaşmak için, Azure Databricks serverless compute'un ona nasıl bağlandığını seçin:

• Özel uç nokta: Trafiği özel bağlantıda tutmak için Özel Bağlantı kullanın. Bir hesap yöneticisi, sunucunun alan alanı için çalışma alanınıza bağlı ağ bağlantı yapılandırmasına (NCC) özel bir uç nokta kuralı ekler. Bulut yöneticisiniz uç nokta bağlantısını onaylar. Bkz. Özel bağlantıyı yapılandırma.
• Güvenlik duvarı ile genel uç noktası: Sunucunun güvenlik duvarını, çalışma alanınızın bulutu ve bölgesi için Azure Databricks'in sunucusuz çıkış IP'lerine izin verecek şekilde yapılandırın. Bu IP'ler Azure Databricks müşterileri arasında paylaşıldığı için sunucuda kimlik doğrulamayı etkin tutun. Giden IP'leri bul ve güvenlik duvarını yapılandır bölümünü bkz.

Özel uç noktası kurallarına eklenen alan adları ağ politikaları tarafından otomatik olarak izin verilir, bu yüzden onları İzin verilen alan adlarına ayrı eklemenize gerek yoktur. Açık uç nokta için yukarıdaki ağ politikası kurulumunu takip edin.