Öğretici: Azure İşlevleri'da bir MCP sunucusu barındırma

Bu makalede, Azure İşlevleri'da uzak Model Bağlam Protokolü (MCP) sunucularını nasıl barındırabileceğiniz gösterilmektedir. Ayrıca, sunucu uç noktası yetkilendirmesini yapılandırmak ve yapay zeka araçlarınızın güvenliğini daha iyi sağlamak için yerleşik kimlik doğrulamasını kullanmayı da öğrenirsiniz.

Azure İşlevleri uzak bir MCP sunucusunu barındırmanın iki yolu vardır:

MCP sunucusu seçeneği	Description	En uygun...
MCP uzantı sunucusu	Uzantı tetikleyicisinin araç uç noktalarınızı tanımlamanıza olanak tanıyan özel MCP sunucuları oluşturmak için Azure İşlevleri MCP uzantısını kullanır. Bu sunucular, desteklenen bir dilde diğer herhangi bir fonksiyon uygulaması gibi geliştirilir, dağıtılır ve yönetilir.	İşlevler ve bağlama tabanlı programlama modeli hakkında bilgi sahibi olduğunuzda.
Kendi kendine barındırılan sunucu	İşlevler, standart MCP SDK'ları kullanılarak oluşturulan bir MCP sunucu projesini barındırabilir.	Sunucunuzu resmi MCP SDK'larını kullanarak zaten kurduysanız ve Azure'da olay odaklı, sunucusuz ve ölçeklenebilir bir barındırma arıyorsanız.

Uyarı

Azure İşlevleri'ın, resmi MCP SDK'larını kullanarak oluşturduğunuz MCP sunucularını barındırma yeteneği şu anda önizleme aşamasındadır.

Bu öğretici, İşlevler tarafından desteklenen her iki MCP sunucusu seçeneğini de kapsar. Senaryonuza en uygun sekmeyi seçin.

MCP uzantı sunucusu

Bu öğreticide, Visual Studio Code kullanarak şunları yapacaksınız:

• MCP uzantısını kullanarak bir MCP sunucu projesi oluşturun.
• MCP sunucunuzu yerel olarak çalıştırın ve doğrulayın.
• Azure'de bir işlev uygulaması oluşturun.
• MCP sunucu projenizi dağıtın.
• Yerleşik kimlik doğrulamasını etkinleştirin.

Kendi barındırılan sunucu

Bu öğreticide, Visual Studio Code kullanarak şunları yapacaksınız:

• Kendi kendine barındırılan bir MCP sunucu projesi oluşturun.
• MCP sunucunuzu yerel olarak çalıştırın ve doğrulayın.
• Azure'de bir işlev uygulaması oluşturun.
• MCP sunucu projenizi dağıtın.
• Yerleşik kimlik doğrulamasını etkinleştirin.

Önemli

Bu makale şu anda yalnızca C#, Python ve TypeScript'i destekler. Hızlı başlangıcı tamamlamak için makalenin üst kısmındaki desteklenen dillerden birini seçin.

Bu makale, Azure İşlevleri için Node.js programlama modelinin 4. sürümünü destekler.

Bu makale, Azure İşlevleri için Python programlama modelinin 2. sürümünü destekler.

Önkoşullar

• şu uzantılarla Visual Studio Code:

  • Azure İşlevleri uzantısı. Bu uzantı Azure İşlevleri Core Tools gerektirir ve kullanılabilir olmadığında yüklemeyi dener.

  • Azure Developer CLI uzantısı.

• Azurite depolama emülatörü

• Azure CLI. Azure CLI komutlarını Azure Cloud Shell içinde de çalıştırabilirsiniz.

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz bir hesap oluşturun.

• uv

MCP sunucu projenizi oluşturma

Tercih ettiğiniz dilde yerel olarak bir MCP sunucu projesi oluşturmak için Visual Studio Code kullanın.

1. Visual Studio Code F1 tuşlarına basarak komut paletini açın. Azure İşlevleri: Create New Project... komutunu arayın ve çalıştırın.

2. Proje çalışma alanınız için dizin konumunu seçin ve Seç'i seçin. Yeni bir klasör oluşturmanız veya proje çalışma alanı için boş bir klasör seçmeniz gerekir. Zaten bir çalışma alanının parçası olan bir proje klasörünü seçmeyin.

3. Aşağıdaki bilgileri istenen yerde sağlayın.

   MCP uzantı sunucusu

   Uyarı	Seleksiyon
   Proje türü seçme	C#'ı seçin.
   .NET çalışma zamanı seçin	.NET 8.0 LTS'ı seçin.
   Projenizin ilk işlevi için bir şablon seçin	MCP Tool trigger'ı seçin.
   İşlev adı belirtin	McpTrigger yazın.
   Ad alanı belirle	My.Functions yazın.
   Yetkilendirme düzeyi	Uzak MCP sunucusuna bağlanırken erişim anahtarı gerektiren öğesini seçin FUNCTION.
   Projenizi nasıl açmak istediğinizi seçin	Open in current window'ı seçin.

   Kendi barındırılan sunucu

   Uyarı	Seleksiyon
   Proje türü seçme	Self-hosted MCP server'ı seçin.
   MCP sunucusu için bir dil seçin	C#'ı seçin.
   Örnek sunucu kodu ekle	Yes'ı seçin.
   Projenizi nasıl açmak istediğinizi seçin	Open in current window'ı seçin.

3. Aşağıdaki bilgileri istenen yerde sağlayın.

   MCP uzantı sunucusu

   Uyarı	Seleksiyon
   Proje türü seçme	TypeScript'ı seçin.
   Projenizin ilk işlevi için bir şablon seçin	MCP Tool trigger'ı seçin.
   İşlev adı belirtin	mcpToolTrigger yazın.
   Yetkilendirme düzeyi	Uzak MCP sunucusuna bağlanırken erişim anahtarı gerektiren öğesini seçin FUNCTION.
   Projenizi nasıl açmak istediğinizi seçin	Open in current window'ı seçin.

   Kendi barındırılan sunucu

   Uyarı	Seleksiyon
   Proje türü seçme	Self-hosted MCP server'ı seçin.
   MCP sunucusu için bir dil seçin	TypeScript'ı seçin.
   Örnek sunucu kodu ekle	Yes'ı seçin.
   Projenizi nasıl açmak istediğinizi seçin	Open in current window'ı seçin.

3. Aşağıdaki bilgileri istenen yerde sağlayın.

   MCP uzantı sunucusu

   Uyarı	Seleksiyon
   Proje türü seçme	Python'ı seçin.
   Bir sanal ortam oluşturmak için Python yorumlayıcı seçin	Tercih ettiğiniz Python yorumlayıcıyı seçin. Bir seçenek gösterilmiyorsa, Python ikili dosyanızın tam yolunu yazın.
   Projenizin ilk işlevi için bir şablon seçin	MCP Tool trigger'ı seçin.
   Oluşturmak istediğiniz işlevin adı	mcp_trigger girin.
   Yetkilendirme düzeyi	Uzak MCP sunucusuna bağlanırken erişim anahtarı gerektiren öğesini seçin FUNCTION.
   Projenizi nasıl açmak istediğinizi seçin	Open in current window'ı seçin.

   Kendi barındırılan sunucu

   Uyarı	Seleksiyon
   Proje türü seçme	Self-hosted MCP server'ı seçin.
   MCP sunucusu için bir dil seçin	Python'ı seçin.
   Örnek sunucu kodu ekle	Yes'ı seçin.
   Projenizi nasıl açmak istediğinizi seçin	Open in current window'ı seçin.

MCP uzantı sunucusu

Visual Studio Code bu bilgileri kullanarak MCP sunucu tetikleyicisi için bir kod projesi oluşturur. Yerel proje dosyalarını Gezgin'de görüntüleyebilirsiniz.

Kendi barındırılan sunucu

Kendi bünyelerinde barındırılan MCP sunucuları, Azure İşlevleri custom handlerları olarak çalışır. Özel işleyicileri, Azure İşlevleri ana bilgisayarından etkinlikleri alan hafif web sunucuları olarak düşünebilirsiniz.

Visual Studio Code bu bilgileri kullanarak şu gerekli dosyaları içeren bir MCP sunucu projesi oluşturur:

Dosya	Description
host.json	Bu dosya, sunucuyu MCP özel işleyicisi olarak çalıştırmak için Azure İşlevleri konağı tarafından gereklidir.
local.settings.json	Bu dosya, sunucuyu yerel olarak çalıştırmak için Azure İşlevleri Core Tools tarafından gereklidir. Çekirdek Araçlar İşlevler çalışma zamanının yerel bir sürümünü sağlar ve gerekli ortam değişkenlerini belirtmek için bu dosyayı kullanır.

Proje ayrıca basit bir MCP sunucusunun dile özgü uygulamasını ve bu dilin gerektirdiği dosyaları da içerir.

MCP sunucusunu yerel olarak başlatma

MCP uzantı sunucusu

İşlev uygulamalarının çalışması için bir depolama bileşeni gerekir. Sunucuyu başlatmadan önce yerel depolama öykünücüsİnİ başlatın:

1. local.setting.jsoniçinde, sahip "AzureWebJobsStorage": "UseDevelopmentStorage=true"olduğunuzdan emin olun.

2. Visual Studio Code F1 tuşlarına basarak komut paletini açın. Komut paletinde arama yapın ve Azurite: Start öğesini seçin.

3. Alt çubuğu denetleyin ve Azurite öykünme hizmetlerinin çalıştığını doğrulayın. Öyleyse, artık sunucuyu yerel olarak çalıştırabilirsiniz.

4. Yerel olarak çalışmaya başlamak için F5 tuşuna basın.

Kendi barındırılan sunucu

Yeni bir terminal (Ctrl+Shift+` ) açın, aşağıdaki komutu çalıştırarak sunucuyu başlatın:

uv run func start

MCP uzantı sunucusu

İşlev uygulamalarının çalışması için bir depolama bileşeni gerekir. Sunucuyu başlatmadan önce yerel depolama öykünücüsİnİ başlatın:

1. local.setting.jsoniçinde, sahip "AzureWebJobsStorage": "UseDevelopmentStorage=true"olduğunuzdan emin olun.

2. Visual Studio Code F1 tuşlarına basarak komut paletini açın. Komut paletinde arama yapın ve Azurite: Start öğesini seçin.

3. Alt çubuğu denetleyin ve Azurite öykünme hizmetlerinin çalıştığını doğrulayın. Öyleyse, artık sunucuyu yerel olarak çalıştırabilirsiniz.

4. Yerel olarak çalışmaya başlamak için F5 tuşuna basın.

Kendi barındırılan sunucu

Yeni bir terminal (Ctrl+Shift+` ) açın, aşağıdaki komutu çalıştırarak sunucuyu başlatın:

func start

MCP uzantı sunucusu

İşlev uygulamalarının çalışması için bir depolama bileşeni gerekir. Sunucuyu başlatmadan önce yerel depolama öykünücüsİnİ başlatın:

1. local.setting.jsoniçinde, sahip "AzureWebJobsStorage": "UseDevelopmentStorage=true"olduğunuzdan emin olun.

2. Visual Studio Code F1 tuşlarına basarak komut paletini açın. Komut paletinde arama yapın ve Azurite: Start öğesini seçin.

3. Alt çubuğu denetleyin ve Azurite öykünme hizmetlerinin çalıştığını doğrulayın. Öyleyse, artık sunucuyu yerel olarak çalıştırabilirsiniz.

4. Yerel olarak çalışmaya başlamak için F5 tuşuna basın.

Kendi barındırılan sunucu

Yeni bir terminal (Ctrl+Shift+` ) açın, aşağıdaki komutu çalıştırarak sunucuyu başlatın:

npm install
npm run build
func start

Sunucuyu test edin

1. .vscode/mcp.json'ı açın. Düzenleyici sunucunun bağlantı bilgilerini eklemelidir.

2. Sunucu adının üstündeki Başlat düğmesini seçerek sunucuyu başlatın.

3. Sunucuya bağlandığınızda, sunucu adının üzerinde kullanılabilen araç sayısını görürsünüz.

4. Aracı modunda Visual Studio Code Copilot sohbeti açın ve bir soru sorun. Örneğin, "#your-local-server-name ile selamla". Bu soru, Copilot'un soruyu yanıtlamak için sunucudan yararlanmasını garanti eder.

5. Copilot, yerel MCP sunucusundan bir aracı çalıştırmayı istediğinde, Allow seçeneğini seçin.

6. Testi tamamladığınızda, Stop seçeneğini belirleyerek sunucuyla bağlantıyı kesin ve yerel olarak çalıştırmayı durdurmak için Ctrl+C düğmesine basın.

Tip

sohbet Copilot penceresinde, sohbet için kullanılabilir sunucuların ve araçların listesini görmek için alttaki araç simgesini seçin. Test sırasında yerel MCP sunucusunun denetlendiğinden emin olun.

Azure'de işlev uygulamasını oluşturma

MCP sunucunuzu barındıran Azure Flex Tüketim planında bir işlev uygulaması oluşturun.

1. Azure portalında menüden veya Home sayfasından Kaynak oluştur öğesini seçin.

2. Başlarken'i seçin ve ardından İşlev Uygulaması altında Oluştur'u seçin.

3. Barındırma seçeneği belirleyin'in altında Esnek Tüketim seçeneğini Seç.

4. Temel Bilgiler sayfasında, aşağıdaki tabloda belirtilen işlev uygulaması ayarlarını kullanın:

   Setting	Önerilen değer	Description
   Subscription	Aboneliğiniz	Yeni işlev uygulamanızı oluşturduğunuz abonelik.
   Kaynak Grubu	myResourceGroup	İşlev uygulamanızı oluşturduğunuz yeni kaynak grubunun adı.
   İşlev Uygulamasının adı	Genel olarak benzersiz bir ad	Yeni işlev uygulamanızı tanımlayan ad. Geçerli karakterler şunlardır: a-z (büyük/küçük harf duyarsız), 0-9 ve -.
   Region	Tercih edilen bölge	Size yakın veya işlevlerinizin erişebileceği diğer hizmetlere yakın bir bölge seçin. Desteklenmeyen bölgeler görüntülenmez. Daha fazla bilgi için bkz . Şu anda desteklenen bölgeleri görüntüleme.
   Çalışma zamanı yığını	Tercih edilen dil	Desteklenen dil çalışma zamanı yığınlarından birini seçin. Web için Visual Studio Code kullanılarak portal içi düzenleme şu anda yalnızca Node.js, PowerShell ve Python uygulamalarında kullanılabilir. C# sınıf kitaplığı ve Java işlevleri developed locally olmalıdır.
   Sürüm	Dil sürümü	Dil çalışma zamanı yığınınızın desteklenen bir sürümünü seçin.
   Örnek boyutu	Varsayılan	Uygulamanızın her örneği için ayrılan örnek belleği miktarını belirler. Daha fazla bilgi için Örnek boyutlarını inceleyin.

5. Depolama sayfasında, yeni bir varsayılan konak depolama hesabı oluşturmanın varsayılan davranışını kabul edin veya mevcut bir depolama hesabını kullanmayı seçin.

6. İzleme sayfasında Application Insights'ı Etkinleştir'in seçili olduğundan emin olun. Yeni bir Application Insights örneği oluşturmak için varsayılanı kabul edin veya var olan bir örneği kullanmayı seçin. Application Insights örneği oluşturduğunuzda, Log Analytics Workspace seçmeniz de istenir.

7. Kimlik Doğrulaması sayfasında, tüm kaynaklar için Kimlik doğrulama türünüYönetilen kimlik olarak değiştirin. Bu seçenekle, uygulamanızın Microsoft Entra ID kimlik doğrulaması kullanarak bu Azure kaynaklarına erişmek için kullandığı kullanıcı tarafından atanan yönetilen kimlik de oluşturulur. Microsoft Entra ID ile yönetilen kimlikler, Azure kaynaklarına bağlanmak için en yüksek güvenlik düzeyini sağlar.

8. Kalan sekmelerdeki varsayılan seçenekleri kabul edin ve ardından gözden geçir + oluştur'u seçerek seçtiğiniz uygulama yapılandırmasını gözden geçirin.

9. Memnun olduğunuzda oluştur'u seçerek işlev uygulamasını ve ilgili kaynakları sağlayın ve dağıtın.

10. Portalın sağ üst köşesindeki Bildirimler simgesini seçin ve Dağıtım başarılı iletisini izleyin.

11. Yeni işlev uygulamanızı görüntülemek için Kaynağa git’i seçin. Panoya sabitle'yi de seçebilirsiniz. Sabitleme, gösterge tablonuzdan bu işlev uygulaması kaynak bilgisine geri dönmeyi daha kolay hale getirir.

    

MCP sunucu projesini dağıtma

MCP uzantı sunucusu

Kendi barındırılan sunucu

Sunucuyu dağıtmadan önce gerekli uygulama ayarlarını ekleyin:

1. Hesabınızda oturum açın ve aboneliğinizi seçin:

   az login
   

2. ayarı AzureWebJobsFeatureFlags (çoğul) değerine EnableMcpCustomHandlerPreviewsahip uygulamaya ekleyin:

   az functionapp config appsettings set --name <function-app-name> --resource-group <resource-group-name> --settings "AzureWebJobsFeatureFlags=EnableMcpCustomHandlerPreview"
   

Sunucu projesini dağıtma:

Önemli

Mevcut bir işlev uygulamasına dağıtım yapıldığında Azure'da bu uygulamanın içeriğinin her zaman üzerine yazılacağını unutmayın.

1. Komut paletine Azure İşlevleri: İşlev Uygulamasına Dağıt yazın ve seçin.

2. Yeni oluşturduğunuz işlev uygulamasını seçin. Önceki dağıtımların üzerine yazmanız istendiğinde, işlev kodunuzu yeni işlev uygulaması kaynağına dağıtmak için Dağıt'ı seçin.

3. Dağıtım tamamlandığında, oluşturduğunuz Azure kaynakları da dahil olmak üzere oluşturma ve dağıtım sonuçlarını görüntülemek için View Output öğesini seçin. Bildirimi kaçırırsanız, yeniden görmek için sağ alt köşedeki zil simgesini seçin.

   

MCP uzantı sunucusu

Önemli

Mevcut bir işlev uygulamasına dağıtım yapıldığında Azure'da bu uygulamanın içeriğinin her zaman üzerine yazılacağını unutmayın.

1. Komut paletine Azure İşlevleri: İşlev Uygulamasına Dağıt yazın ve seçin.

2. Yeni oluşturduğunuz işlev uygulamasını seçin. Önceki dağıtımların üzerine yazmanız istendiğinde, işlev kodunuzu yeni işlev uygulaması kaynağına dağıtmak için Dağıt'ı seçin.

3. Dağıtım tamamlandığında, oluşturduğunuz Azure kaynakları da dahil olmak üzere oluşturma ve dağıtım sonuçlarını görüntülemek için View Output öğesini seçin. Bildirimi kaçırırsanız, yeniden görmek için sağ alt köşedeki zil simgesini seçin.

   

Kendi barındırılan sunucu

Sunucuyu dağıtmadan önce gerekli uygulama ayarlarını ekleyin:

1. Hesabınızda oturum açın ve aboneliğinizi seçin:

   az login
   

2. ayarı AzureWebJobsFeatureFlags (çoğul) değerine EnableMcpCustomHandlerPreviewsahip uygulamaya ekleyin:

   az functionapp config appsettings set --name <function-app-name> --resource-group <resource-group-name> --settings "AzureWebJobsFeatureFlags=EnableMcpCustomHandlerPreview"
   

3. Python uygulamalar için de bu uygulama ayarını eklemeniz gerekir:

   PYTHONPATH=/home/site/wwwroot/.python_packages/lib/site-packages.

Önemli

Mevcut bir işlev uygulamasına dağıtım yapıldığında Azure'da bu uygulamanın içeriğinin her zaman üzerine yazılacağını unutmayın.

1. Komut paletine Azure İşlevleri: İşlev Uygulamasına Dağıt yazın ve seçin.

2. Yeni oluşturduğunuz işlev uygulamasını seçin. Önceki dağıtımların üzerine yazmanız istendiğinde, işlev kodunuzu yeni işlev uygulaması kaynağına dağıtmak için Dağıt'ı seçin.

3. Dağıtım tamamlandığında, oluşturduğunuz Azure kaynakları da dahil olmak üzere oluşturma ve dağıtım sonuçlarını görüntülemek için View Output öğesini seçin. Bildirimi kaçırırsanız, yeniden görmek için sağ alt köşedeki zil simgesini seçin.

   

Dağıtım tamamlandığında, Visual Studio Code sunucuya bağlanma hakkında bir bildirim görmeniz gerekir. Düzenleyicinin içinde sunucu bağlantı bilgilerini ayarlamasını sağlamak için mcp.json düğmesini seçin.

Uzak MCP sunucusu yetkilendirmesi

Uzak MCP sunucu uç noktalarınızın yetkisiz kullanımını azaltmanın veya önlemenin iki yolu vardır:

Yöntem	Description
Yerleşik sunucu kimlik doğrulaması (önizleme)	İşlevler, MCP yetkilendirme belirtimi protokolünün OAuth gereksinimlerini uygulayan yerleşik App Service kimlik doğrulamasını ve yetkilendirmesini içerir. Sunucuya erişmeye çalışan istemciler, bağlanmaya izin verilmeden önce kimlik doğrulaması için Microsoft Entra ID gibi yapılandırılmış bir kimlik sağlayıcısına yönlendirilir. Bu yöntem, araç uç noktalarınız için en yüksek güvenlik düzeyini sağlar.
Anahtar tabanlı kimlik doğrulaması	Varsayılan olarak İşlevler, MCP sunucu araçlarını kullanmaya çalışan istemcilerin istek üst bilgisinde paylaşılan bir gizli anahtar değeri sunması için bir erişim anahtarı gereksinimi uygular. OAuth tabanlı kimlik doğrulamasıyla aynı güvenlik düzeyini sağlamasa da, erişim anahtarları ortak araçlara erişmeyi zorlaştırır. OAuth tabanlı kimlik doğrulaması kullanırken sunucunuzdaki erişim anahtarlarını devre dışı bırakmak için erişim Anonymous düzeyini kullanın.

Uyarı

Bu öğretici, diğer makalelerde App Service Kimlik Doğrulaması olarak da adlandırılan yerleşik sunucu yetkilendirme ve kimlik doğrulama özelliği için ayrıntılı yapılandırma yönergeleri içerir. Özelliğe genel bir bakış ve bazı kullanım kılavuzlarını Yerleşik sunucu yetkilendirmesini yapılandırma (önizleme) makalesinde bulabilirsiniz.

Azure portalında yerleşik MCP kimlik doğrulamasını etkinleştirme

Azure portalı, MCP sunucunuz için yerleşik kimlik doğrulaması ve yetkilendirmeyi yapılandırmak için tek tıklamayla bir deneyim sağlar. Bu preview özelliği, Microsoft Entra ID’yi kimlik sağlayıcısı olarak otomatik olarak oluşturur ve yapılandırır, gerekli istemci uygulamalarını kaydeder ve sizin için gerekli uygulama ayarlarını ekler. Bu özelliği kullanarak yerleşik MCP kimlik doğrulamasını açmak, sunucuya varsayılan anahtar tabanlı erişimi otomatik olarak kapatır.

Azure portalında yerleşik MCP kimlik doğrulamasını etkinleştirmek için:

1. Portalda sunucu uygulamanızı açın.

2. Soldaki menüde yapay zeka (önizleme) sekmesini bulun.

3. Kimlik Doğrulaması bölümünü bulun ve MCP kimlik doğrulamasını aç düğmesine tıklayın.

4. Açılan yan bölmeye benzersiz bir Entra uygulaması kayıt adı girin. Kimlik doğrulamasını ayarlamak için bu uygulama gereklidir.

5. Kaydet'e tıklayın ve yapılandırmanın tamamlanmasını bekleyin.

Uyarı

Kimlik doğrulamasını el ile ayarlamayı tercih ediyorsanız, bkz . Alternatif: Yerleşik kimlik doğrulamasını el ile yapılandırma.

Sunucuya bağlanma

Dağıtımdan sonra açılan pencerede Connect öğesini seçtiğinizde Visual Studio Code .vscode/mcp.json sunucu bağlantı bilgileriyle doldurur.

Bu adımı kaçırırsanız, dağıtım günlüklerinin sonunda satır içi bağlantı düğmesini bulmak için Çıkış 'ı (Ctrl/Cmd+Shift+U) da açabilirsiniz.

Ayrıca bağlantı bilgilerini el ile de ekleyebilirsiniz:

1. Aşağıdaki komutu çalıştırarak sunucu etki alanını alın:

   az functionapp show --name <FUNCTION_APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --query "defaultHostName" --output tsv
   

2. Visual Studio Code'da komut paletini açın, MCP: Sunucu Ekle... komutuna gidin ve şu istemleri izleyin:

   MCP uzantı sunucusu

   Uyarı	Öneri
   Eklenecek sunucu türü	HTTP
   MCP sunucunuzun URL'si	https://<FUNCTION_APP_NAME>.azurewebsites.net/runtime/webhooks/mcp
   Sunucu adı	remote-mcp-server
   Sunucunun yükleneceği yer	Workspace

   Kendi barındırılan sunucu

   Uyarı	Öneri
   Eklenecek sunucu türü	HTTP
   MCP sunucunuzun URL'si	https://<FUNCTION_APP_NAME>.azurewebsites.net/mcp
   Sunucu adı	remote-mcp-server
   Sunucunun yükleneceği yer	Workspace

3. Visual Studio Code sizin için mcp.json ayar dosyasını açar.

Kimlik doğrulamasını nasıl yapılandırdığınıza bağlı olarak sunucuya bağlanmak için sonraki bölümdeki yönergeleri izleyin.

Yerleşik MCP kimlik doğrulaması ile

1. Sunucu adının üstündeki Başlat düğmesini seçerek uzak sunucuyu başlatın.

2. Microsoft ile kimlik doğrulaması sorulduğunda Allow öğesini seçin, ardından e-postanızla (Azure portalında oturum açmak için kullanılan) oturum açın.

3. Sunucuya başarıyla bağlandığınızda, sunucu adının üzerinde kullanılabilir araç sayısını görürsünüz.

4. Aracı modunda Visual Studio Code Copilot sohbeti açın ve bir soru sorun. Örneğin, Greet with #your-remote-mcp-server-name.

5. Testi bitirdiğinizde sunucuyu durdurun.

Visual Studio Code uzak MCP sunucusuna bağlanmaya çalıştığında ne olacağını ayrıntılı olarak anlamak için bkz. Server yetkilendirme protokolü.

Erişim anahtarı ile

Yerleşik MCP kimlik doğrulamasını etkinleştirmezseniz, sunucunuz varsayılan olarak İşlevler erişim anahtarını kullanıyor olmalıdır. Erişim anahtarını sunucu kaydınızın istek üst bilgisine ekleyin.

MCP uzantı sunucusu

Dosya ./vscode/mcp.json aşağıdaki örnekteki gibi görünmelidir:

{
	"servers": {
		"remote-mcp-server": {
			"type": "http",
			"url": "https://${input:functionapp-domain}/runtime/webhooks/mcp",
			"headers": {
				"x-functions-key": "${input:functions-key}"
			}
		}
	},
	"inputs": [
		{
			"type": "promptString",
			"id": "functions-key",
			"description": "Functions App Key",
			"password": true
		},
		{
			"type": "promptString",
			"id": "functionapp-domain",
			"description": "The domain of the function app.",
			"password": false
		}
	]
}

Erişim anahtarını bulmak için Azure portalında İşlev uygulamasına gidin. Soldaki menüde İşlevler -> Uygulama anahtarları'nı bulun. Sistem anahtarları bölümünde mcp_extension adlı bir anahtar bulun.

Kendi barındırılan sunucu

Dosya ./vscode/mcp.json aşağıdaki örnekteki gibi görünmelidir:

{
	"servers": {
		"remote-mcp-server": {
			"type": "http",
			"url": "https://${input:functionapp-domain}/mcp",
			"headers": {
				"x-functions-key": "${input:functions-key}"
			}
		}
	},
	"inputs": [
		{
			"type": "promptString",
			"id": "functions-key",
			"description": "Functions App Key",
			"password": true
		},
		{
			"type": "promptString",
			"id": "functionapp-domain",
			"description": "The domain of the function app.",
			"password": false
		}
	]
}

Erişim anahtarını bulmak için Azure portalında İşlev uygulamasına gidin. Soldaki menüde İşlevler -> Uygulama anahtarları'nı bulun. Konak anahtarları (tüm işlevler) bölümünün altında default adlı anahtarı bulun.

Tip

Bağlantı günlüklerini görmek için sunucu adına gidin ve Ardından Diğer>Çıkışı Göster'i seçin. İstemci (Visual Studio Code) ile uzak MCP sunucusu arasındaki etkileşim hakkında daha fazla bilgi için dişli simgesini seçin ve Trace öğesini seçin.

Microsoft Foundry aracısını araçlarınızı kullanacak şekilde yapılandırma

Bir Foundry aracısını yalnızca VS Code'da Copilot değil sunucunuzdaki araçları kullanacak şekilde yapılandırabilirsiniz. Adım adım yönergeler için bkz. Azure İşlevleri MCP sunucularını Microsoft Foundry'da araç olarak kullanma.

sunucuyu Azure API Center'a kaydetme

Kuruluşunuz genelinde kolayca bulunabilen uzak MCP sunucularının özel envanterini korumak için MCP sunucunuzu Azure API Center'a kaydetmeyi göz önünde bulundurun. Adım adım yönergeler için bkz. Azure API Center Azure İşlevleri'da barındırılan MCP sunucularını kaydetme.

Alternatif: Yerleşik kimlik doğrulamayı el ile yapılandırma

Aşağıdaki yönergeler, sunucu uygulamasında yerleşik yetkilendirme ve kimlik doğrulama özelliğini el ile etkinleştirmeyi ve kimlik sağlayıcısı olarak Microsoft Entra ID yapılandırmayı gösterir. Tek tıklamayla portal deneyimini kullanmak istemiyorsanız bu adımları kullanın.

Anahtar tabanlı kimlik doğrulamasını devre dışı bırakma

Yerleşik kimlik doğrulamasını etkinleştirirken, anonim erişime izin vererek önce varsayılan anahtar tabanlı kimlik doğrulamasını devre dışı bırakın. Bunu yapmadıysanız ve uygulamanız zaten dağıtılmışsa aşağıdaki yönergeleri izleyin.

MCP uzantı sunucusu

MCP sunucunuzda konak tabanlı kimlik doğrulamasını devre dışı bırakmak için uygulama ayarlarınıza değerine AzureFunctionsJobHost__extensions__mcp__system__webhookAuthorizationLevel sahip adlı Anonymous bir ayar ekleyin. Bu ayarı portala ekleyebilir veya aşağıdaki Azure CLI komutunu kullanabilirsiniz:

az functionapp config appsettings set --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
  --settings "AzureFunctionsJobHost__extensions__mcp__system__webhookAuthorizationLevel=Anonymous"

Bu örnekte, <APP_NAME> ve <RESOURCE_GROUP> öğelerini işlev uygulamanızın ve kaynak grubunuzun adıyla değiştirin.

Tip

Bu ayar, system.webhookAuthorizationLevel dosyasının MCP Uzantısı bölümünde Anonymoushost.json ayarıyla eşdeğerdir. Ancak, bu yöntem sunucu projenizi yeniden yayımlamanızı gerektirir.

Kendi barındırılan sunucu

MCP sunucunuzda konak tabanlı kimlik doğrulamasını devre dışı bırakmak için uygulama ayarlarınıza değerine AzureFunctionsJobHost__customHandler__http__DefaultAuthorizationLevel sahip adlı anonymous bir ayar ekleyin. Bu ayarı portala ekleyebilir veya aşağıdaki Azure CLI komutunu kullanabilirsiniz:

az functionapp config appsettings set --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
  --settings "AzureFunctionsJobHost__customHandler__http__DefaultAuthorizationLevel=anonymous"

Bu örnekte, <APP_NAME> ve <RESOURCE_GROUP> öğelerini işlev uygulamanızın ve kaynak grubunuzun adıyla değiştirin.

Tip

Bu ayar, http.DefaultAuthorizationLevel dosyasının özel işleyici bölümünde anonymous ayarının host.json olarak belirlenmesi ile eşdeğerdir. Bu yaklaşım, sunucu projenizi yeniden yayımlamanızı gerektirir.

Sunucu uygulamasında kimlik doğrulamayı yapılandırma

1. Azure portalında sunucu uygulamasını açın ve sol menüden Settings>Authentication seçin.

2. Kimlik sağlayıcısı olarak>Microsoft'u ekle'yi seçin.

3. Uygulamanız ve kullanıcıları için bir kiracı seçin alanındaİş gücü yapılandırması (geçerli kiracı) seçeneğini belirleyin.

4. Uygulama kaydı: altında şu ayarları kullanın:

   Setting	Seleksiyon
   Uygulama kayıt türü	Yeni uygulama kaydı oluşturma
   İsim	Uygulamanız için açıklayıcı bir ad girin
   İstemci gizli anahtar süresi dolma	Önerilen: 180 gün
   Desteklenen hesap türleri	Geçerli kiracı - Tek kiracı

5. Ek denetimler: altında, Client uygulama gereksinimi için Belirli istemci uygulamalarından gelen istekleri izin ver öğesini seçin, kalem simgesini seçin, Visual Studio Code istemci kimliğini aebc6443-996d-45c2-90f0-388ff96faa56 ekleyin ve Tamam'ı seçin. Diğer bölümleri olduğu gibi bırakın.

6. App Service kimlik doğrulama ayarları altında şu ayarları kullanın:

   Setting	Seleksiyon
   Erişimi kısıtla	Kimlik doğrulaması gerektir
   Kimliği doğrulanmamış istekler	HTTP 401 Yetkisiz: API'ler için önerilir
   Belirteç deposu	Belirteç yenilemesine izin veren kutuyu işaretleyin

7. Add (Ekle) seçeneğini belirleyin. Ayarlar yayıldıktan sonra aşağıdaki sonucu görmeniz gerekir:

   

Visual Studio Code'u istemci olarak önceden yetkilendir

1. Microsoft'un yanındaki Entra uygulamasının adını seçin. Bu eylem sizi Entra uygulama kaynağına Genel Bakış'a götürür.

2. Soldaki menüde Yönet -> API'yi kullanıma sunma'yı bulun.

3. Yetkili istemci uygulamaları'nın altında +İstemci uygulaması ekle'yi seçin.

4. Visual Studio Code istemci kimliğini girin: aebc6443-996d-45c2-90f0-388ff96faa56.

5. Kapsamın önünde api://abcd123-efg456-hijk-7890123/user_impersonation gibi görünen kutuyu seçin.

6. Uygulama ekle'yi seçin.

Korumalı kaynak meta verilerini yapılandırma (önizleme)

1. Aynı API'yi kullanıma sunma görünümünde Kapsamlar bölümünü bulun ve yöneticilerin ve kullanıcıların Entra uygulamasını onaylamasına izin veren kapsamı kopyalayın. Bu değer şuna benzer: api://abcd123-efg456-hijk-7890123/user_impersonation.

2. ayarını WEBSITE_AUTH_PRM_DEFAULT_WITH_SCOPESeklemek için öncekiyle aynı komutu çalıştırın:

   az functionapp config appsettings set --name <function-app-name> --resource-group <resource-group-name> --settings "WEBSITE_AUTH_PRM_DEFAULT_WITH_SCOPES=<scope>"
   

3. Ayrıca API'yi kullanıma sunma görünümünde, en üstte Uygulama Kimliği URI'sini (gibi api://abcd123-efg456-hijk-7890123görünür) bulun ve sonraki adım için kaydedin.

Sunucu yetkilendirme protokolü

Visual Studio Code hata ayıklama çıkışında, MCP istemcisi ve sunucusu etkileşim kurarken bir dizi istek ve yanıt görürsünüz. Yerleşik MCP sunucu yetkilendirmesini kullandığınızda aşağıdaki olay dizisini görürsünüz:

1. Düzenleyici, MCP sunucusuna bir başlatma isteği gönderir.
2. MCP sunucusu yetkilendirme gerektiğini belirten bir hatayla yanıt verir. Yanıt, uygulama için korumalı kaynak meta verilerine (PRM) yönelik bir işaretçi içerir. Yerleşik yetkilendirme özelliği, sunucu uygulaması için PRM'yi oluşturur.
3. Düzenleyici PRM'yi getirir ve yetkilendirme sunucusunu tanımlamak için kullanır.
4. Düzenleyici, yetkilendirme sunucusundaki iyi bilinen bir uç noktadan yetkilendirme sunucusu meta verilerini (ASM) almayı dener.
5. Microsoft Entra ID iyi bilinen uç noktada ASM'yi desteklemediğinden düzenleyici, ASM'yi almak için OpenID Connect meta veri uç noktasını kullanmaya geri döner. Diğer yol bilgilerden önce iyi bilinen uç noktayı ekleyerek bunu keşfetmeye çalışır.
6. OpenID Connect belirtimleri aslında iyi bilinen uç noktayı yol bilgisinin ardından tanımlar ve Microsoft Entra ID de bunu burada barındırır. Böylece düzenleyici bu biçimle yeniden dener.
7. Düzenleyici ASM'yi başarıyla alır. Daha sonra oturum açmak için bu bilgileri kendi istemci kimliğiyle kullanır. Bu noktada düzenleyici sizden oturum açmanızı ve uygulamayı onaylamanızı ister.
8. Başarıyla oturum açıp onay verdiğinizi varsayarsak düzenleyici kimlik doğrulamasını tamamlar. Bu sefer başlatma isteğini MCP sunucusuna yetkilendirme belirteci içeren bir şekilde yeniden gönderir. Bu yeniden deneme hata ayıklama çıkış düzeyinde görünmez, ancak bunu İzleme çıktısı düzeyinde görebilirsiniz.
9. MCP sunucusu belirteci doğrular ve başlatma isteğine başarılı bir yanıt verir. Standart MCP akışı bu noktadan devam eder ve sonuçta bu örnekte tanımlanan MCP aracının bulunmasıyla sonuçlanır.

Sorun giderme

MCP uzantı sunucusu

Oluşan hatalar hakkında Copilot sohbetine sorun.

Kendi barındırılan sunucu

• C# sunucuları için, arguments özelliğinin değerinin derlenmiş DLL'nin yolu olduğundan emin olun, örneğin,["HelloWorld.dll"]
• Sunucunuz düzgün dağıtılmıyorsa veya dağıtılan sunucu çalışmıyorsa, gerekli uygulama ayarını eklediğinizden emin olun. Korumalı kaynak meta verileriyle ilgili ayarı eklemeyi de unutmayın.

Sonraki Adımlar

Azure API Center üzerinde Azure İşlevleri barındırılan MCP sunucularını kaydetmeyi öğrenin.