MCP sunucularını kullanma

Model Bağlam Protokolü (MCP), yapay zeka modellerinin birleşik bir arabirim aracılığıyla dış araçlar ve hizmetlerle etkileşim kurmasını sağlayan açık bir standarttır. Visual Studio'da MCP desteği, MCP uyumlu herhangi bir sunucuyu aracılı kodlama iş akışınıza bağlamanıza olanak tanıyarak GitHub Copilot aracı modunu geliştirir.

Bu makale, MCP sunucularını ayarlama ve Visual Studio'da aracı moduyla araçları kullanma konusunda size yol gösterir.

Önkoşullar

Visual Studio 2026 veya Visual Studio 2022 sürüm 17.14 (en güncel MCP özellikleri için en son hizmet güncellemesi önerilir)

MCP ve Visual Studio GitHub Copilot aracısını nasıl genişletir?

Visual Studio'da MCP desteği aşağıdaki gibi çalışır:

• Visual Studio gibi MCP istemcileri, MCP sunucularına bağlanır ve yapay zeka modeli adına eylem isteğinde bulunur.
• MCP sunucuları, iyi tanımlanmış bir arabirim aracılığıyla belirli işlevleri kullanıma sunan bir veya daha fazla araç sağlar.
• Protokol, istemciler ve sunucular arasındaki iletişim için araç bulma, çağırma ve yanıt işleme dahil olmak üzere ileti biçimini tanımlar.

Örneğin, bir dosya sisteminin MCP sunucusu dosya ve dizinleri okumak, yazmak veya aramak için araçlar sağlayabilir. Resmi GitHub MCP sunucusu , depoları listelemek, çekme istekleri oluşturmak veya sorunları yönetmek için araçlar sunar. MCP sunucuları makinenizde yerel olarak çalışabilir veya uzaktan barındırılabilir. Visual Studio her iki yapılandırmayı da destekler.

MCP, bu etkileşimi standartlaştırarak her yapay zeka modeli ve her araç arasında özel tümleştirme gereksinimini ortadan kaldırır. Daha sonra çalışma alanınıza yeni MCP sunucuları ekleyerek yapay zeka yardımcınızın özelliklerini genişletebilirsiniz. MCP belirtimi hakkında daha fazla bilgi edinin.

Desteklenen MCP özellikleri

Visual Studio aşağıdaki MCP özelliklerini destekler:

• MCP sunucu aktarımı seçenekleri yerel standart giriş/çıkış (stdio), sunucu tarafından gönderilen olaylar (sse) ve akışla aktarılabilir HTTP (http).
• Özelliklerden ( araçlar, istemler, kaynaklar, örnekleme) Visual Studio artık şunları destekliyor:
  • Araçlar: Copilot aracı modu aracılığıyla eylemleri ve işlemleri yürütme
  • İstemler: Parametrelerle çağırabileceğiniz yeniden kullanılabilir istem şablonları
  • Kaynaklar: URI tabanlı kaynaklar aracılığıyla dış verilere ve bağlama erişme
  • Örnekleme: Araçlarınız ve hizmetlerinizle gelişmiş yapay zeka modeli etkileşimleri
• Visual Studio, (roots) kullanarak sunuculara geçerli çözüm klasörlerini sağlar.
• MCP yetkilendirmesi için, Visual Studio herhangi bir OAuth sağlayıcısıyla uzak sunucular için kimlik doğrulamasını destekler.

MCP sunucularını bulma

Resmi MCP sunucu deposu, MCP'nin çok yönlülüğünü gösteren referans, resmi ve topluluk tarafından katkıda bulunan sunucular için harika bir başlangıç noktasıdır. Sunucuları dosya sistemi işlemleri, veritabanı etkileşimleri ve web hizmetleri gibi çeşitli işlevler için inceleyebilirsiniz.

MCP görece yeni bir standarttır ve ekosistem hızla gelişmektedir. Daha fazla geliştirici MCP'yi benimsedikçe, projelerinizle tümleştirme için kullanılabilir sunucu ve araç sayısının arttığını görebilirsiniz.

Örnek MCP sunucuları

Visual Studio'daki diğer popüler MCP sunucularını tek tıklamayla deneyin:

• – GitHub Copilot için özel istemleri ve yönergeleri keşfedin ve yükleyin.
• – Çeşitli dosya biçimlerini (PDF, Word, Excel, resimler, ses) Markdown'a dönüştürün.
• – DuckDB veritabanlarındaki verileri yerel olarak ve bulutta sorgulayın ve analiz edin.
• – Veritabanı işlemleri ve yönetimi'ne yükleyin. Sorguları yürütme, koleksiyonları yönetme, işlem hatlarını toplama ve belge işlemlerini gerçekleştirme.
• 

MCP sunucusu ekleme seçenekleri

Visual Studio'da MCP sunucusu eklemek için birden çok seçeneğiniz vardır.

Web'den yükleme

Visual Studio, 17.14 sürümünün en son hizmet sürümünden itibaren MCP sunucularının doğrudan yüklenmesini destekler. Otomatik olarak Visual Studio örneğinize eklemek için MCP sunucusundaki Yükle düğmesini seçin.

Sohbetten MCP Sunucusu ekleme

Sohbet görünümünden BIR MCP sunucusu eklemek için:

1. Sohbet penceresindeki araç seçicide yeşil artı (+) düğmesini seçin.

   

2. HTTP sunucularının URL'si veya stdio sunucuları için komut ve bağımsız değişkenler gibi sunucu adını ve bağlantı ayrıntılarını belirtin.

   

GitHub MCP sunucu kayıt defterinden BIR MCP sunucusu ekleme

Visual Studio'daki Uzantılar aracılığıyla doğrudan GitHub MCP sunucu kayıt defterinden bir MCP sunucusu yükleyebilirsiniz.

1. Visual Studio menüsünde Uzantılar MCP Kayıt Defterleri > ... öğesini seçerek MCP Sunucu Yöneticisi'ni açın.

   

2. İstediğiniz sunucuyu seçin ve ardından Visual Studio örneğiniz için yükle'yi seçin.

   

Dosyaya .mcp.json MCP Sunucusu ekleme

Aşağıdaki adımlar, GitHub MCP sunucusuyla ilgili bir yapılandırma örneğinde size yol göstereceğiz:

1. Yeni bir dosya oluşturun: <SOLUTIONDIR>\.mcp.json veya %USERPROFILE%\.mcp.json. Visual Studio'yu kullanarak bu dosyayı JSON şemasının otomatik olarak uygulanması için düzenleyin.

2. Aşağıdaki içeriği dosyaya yapıştırın .mcp.json :

   {
     "servers": {
       "github": {
         "url": "https://api.githubcopilot.com/mcp/"
       }
     }
   }
   

3. Dosyayı kaydedin.

4. Dosyada, Bir GitHub hesabı aracılığıyla sunucuda kimlik doğrulaması yapmak için görünen CodeLens'ten Kimlik Doğrulaması Gerekli'yi seçin. GitHub hesabınızla kimlik doğrulaması yapmak için açılır iletişim kutusunda Kimlik Doğrulaması'nı seçin.

   

   CodeLens'i görmüyorsanız , Araç>Seçenekleri>Metin Düzenleyicisi>CodeLens'te etkinleştirildiğinden emin olun.

5. Sohbet panelinin alt kısmındaki mod açılan listesinde Agent'i seçin.

   

6. Kullanmak istediğiniz araçları (örneğin, Sorunları listele) seçin.

   

   Örnek bir istem deneyin: GitHub'da bana atanan sorunları listeleyin.

7. Copilot, MCP sunucusunun kullanıma sunulmuş olduğu bir aracı kullanmak için izin ister. İlerlemek istediğiniz kapsamla İzin Ver'i seçin.

   

MCP sunucularının yapılandırmasını yönetmek için dosya oluşturma

Henüz bir mcp.json dosyanız yoksa, deponuza, kullanıcınıza veya düzenleyici gereksinimlerinize göre desteklenen konumlardan birinde bir dosya oluşturun.

MCP sunucusu eklemek için sunucunun JSON yapılandırmasını çevrimiçi olarak bulun. Örneğin, MCP sunucuları için GitHub deposunda bulabilirsiniz. Ardından dosyanıza mcp.json yapıştırın.

MCP yapılandırmasının otomatik olarak bulunması için dosya konumları

Visual Studio, diğer geliştirme ortamlarının ayarlandığı MCP yapılandırmalarını da denetler. Aşağıdaki dizinlerden MCP sunucu yapılandırmalarını aşağıdaki sırayla okur:

1. %USERPROFILE%\.mcp.json
   Belirli bir kullanıcı için genel bir MCP sunucu yapılandırması görevi görür. Buraya bir MCP sunucusu eklemek, tüm Visual Studio çözümleri için yüklenmesini sağlar.
2. <SOLUTIONDIR>\.vs\mcp.json
   Visual Studio'ya özgü ve belirtilen MCP sunucularını yalnızca belirli bir kullanıcı için, belirtilen çözüm için yükler.
3. <SOLUTIONDIR>\.mcp.json
   Bir deponun kaynak denetiminde izleyebileceğiniz bir MCP yapılandırması arıyorsanız iyi çalışır.
4. <SOLUTIONDIR>\.vscode\mcp.json
   Kapsamı depo/çözüm olarak belirlenmiş ve genellikle kaynak denetiminde değildir.
5. <SOLUTIONDIR>\.cursor\mcp.json
   Kapsamı depo/çözüm olarak belirlenmiş ve genellikle kaynak denetiminde değildir.

Bazı konumlar .mcp.json gerektirirken, diğerleri mcp.json gerektirir.

MCP yapılandırma biçimi

Hem uzak (URL ve kimlik bilgileri) hem de yerel (komut satırı çağırma) sunucuları tanımlayabilirsiniz.

Paket yöneticileri aracılığıyla araçları çağırmak yaygın bir durum; örneğin, npx -y @azure/mcp@latest veya docker run ... mcp/github. Visual Studio, belirttiğiniz komutu dikkate alır, böylece sürümleri gerektiği gibi sabitleyebilir ya da bayrak geçirebilirsiniz.

Biçim, MCP belirtimine uygun olmalıdır. Örneğin, her biri , name veya commandve urlolan transportbir sunucu nesneleri dizisi içermelidir.

MCP yapılandırmasını düzenleme

Var olan mcp.json bir dosyanız varsa ve dosyayı sürüm denetim sisteminize denetliyorsanız, dosya konumunu Çözüm Gezgini'ndeki Çözüm Öğeleri'ne ekleyin.

Dosyayı geçerli söz dizimi ile kaydettiğinizde GitHub Copilot aracısı yeniden başlatılır ve yapılandırılan sunucuları yeniden yükler.

Araç yaşam döngüsü

Visual Studio bir sunucu bulduğunda veya eklediğinde hemen:

• El sıkışma gerçekleştirerek ve araç listesini sorgulayarak sunucuyu başlatır.
• MCP olayına notifications/tools/list_changedabone olur.
• Bu olay tetiklendiğinde, Visual Studio araçlardaki önceki kabulleri veya izinleri sıfırlar ( rug-pull saldırılarını önlemek için), araç listesini yeniden oluşturur ve sayıyı ve kullanıcı arabirimini canlı olarak güncelleştirir.
• Visual Studio sunucuyu başarıyla etkinleştirdiğinde aracı araçları kullanılabilir hale getirir. Araçlar varsayılan olarak devre dışıdır ve bunları el ile etkinleştirmeniz gerekir.
• Bir sunucuyu kaldırırsanız, Visual Studio hemen işlemini durdurur ve tüm araçlarını kullanıcı arabiriminden geri çeker.
• Bir sunucu tanımını düzenlerseniz, Visual Studio bunu sonlandırır ve yeniden başlatır ve sonra yeniden sorgular.

Araç onaylarının yönetimi

Bir aracı çağırdığınızda, Copilot aracı çalıştırmak için onay isteğinde bulunur. Bunun nedeni, araçların makinenizde yerel olarak çalışabilmesi ve dosyaları veya verileri değiştiren eylemler gerçekleştirmesidir.

Bir araç çağrısından sonra, sohbet bölmesinde İzin ver açılır seçenekler listesini kullanın. Geçerli oturum, geçerli çözüm veya gelecekteki tüm çağrılar için belirli aracı otomatik olarak onaylayabilirsiniz.

Araç onayı seçimlerini Araçlar>Seçenekleri bölmesinde, Tüm Ayarlar>GitHub>Copilot>Araçları bölümünün altında sıfırlayabilirsiniz.

Yetkilendirmeyi yönetme

Visual Studio artık MCP yetkilendirme belirtimine uygun olarak herhangi bir OAuth sağlayıcısını kullanarak uzak sunucular için kimlik doğrulamasını destekliyor. Bu destek, Visual Studio anahtar zinciriyle tümleştirmeye ek olarak sağlanır.

BIR MCP sunucusu için kimlik doğrulamasını yönetmek için:

1. .mcp.json Dosyasında CodeLens'ten bu sunucu için Kimlik Doğrulamasını Yönet'i seçin.

2. Tarayıcı açılır iletişim kutusunda bu sunucu için gerekli OAuth sağlayıcısı için kimlik bilgilerini sağlayın.

MCP istemleri ve istem şablonları

MCP sunucuları, dil modelleriyle daha etkili bir şekilde etkileşim kurmanıza yardımcı olan yeniden kullanılabilir istem şablonları sağlayabilir. Bu istemler belirli görevlere uyarlanır ve özelleştirilebilir argümanlar içerebilir.

MCP istemlerini kullanma

MCP sunucusundan gelen istemlere başvurmak için:

1. Sohbet ekranında + Referans Ekle'yi seçin.
2. İstemler>MCP istemleri'ni seçin.
3. Bir istem seçin ve ardından İstem Ekle'yi seçin.

Bazı istemler, sohbete eklemeden önce özelleştirebileceğiniz parametreler içerir. Bu istemlere istem şablonları adı verilir.

Örnek: GitHub MCP sunucusu çekme isteklerini analiz etmek, taahhüt mesajları oluşturmak ve kod değişikliklerini gözden geçirmek için istemler sağlar.

MCP kaynakları ve kaynak şablonları

MCP kaynakları dosyalar, veritabanı şemaları veya uygulamaya özgü veriler gibi dil modellerine bağlam sağlar. Her kaynağın sohbette başvurabileceğiniz benzersiz bir URI'leri vardır.

MCP kaynaklarını kullanma

Bir hashtag (#) ve ardından kaynak URI'sini kullanarak Copilot sohbetinde MCP kaynaklarına başvurun.

Parametre içeren kaynaklar için (Kaynak Şablonları):

1. Sohbette + Başvuru Ekle'yi seçin.
2. MCP kaynakları'nı seçin.
3. Kaynağınızı seçin, gerekli bağımsız değişkenleri doldurun ve Kaynak Ekle'yi seçin.

Örnek: Azure DevOps MCP sunucusu, proje planlama görevleri için iş öğeleri kaynaklarını, sprint bilgilerini ve ekip kapasitesi verilerini kullanıma sunar.

Örnek: Figma MCP sunucusu tasarım bileşeni kaynaklarına, stil kılavuzlarına ve tasarım belirtimlerine erişim sağlar.

MCP örneklemesi

MCP sunucuları örneklemeyi kullanarak sizin için LLM çağrıları yapabilir ve daha karmaşık, çok adımlı işlemlere olanak tanır. MCP sunucunuz sağlıyorsa Visual Studio örneklemeyi otomatik olarak destekler.

Copilot'ın örnekleme araması yapması gerektiğinde bir onay iletişim kutusu görürsünüz. Ayrıntıları gözden geçirin ve eylem devam etmeden önce onaylayın ve otomatik işlemler üzerinde denetiminizi korumanızı sağlayın.

Örnek: Playwright MCP sunucusu, uygulamanızın DOM yapısına ve kullanıcı akışlarına göre test senaryoları oluşturmak için örnekleme kullanır.

Sıkça sorulan sorular

Yönetici olarak, Visual Studio kullanıcıları için aracı modunda MCP sunucularının kullanımını nasıl denetleyebilirim?

Yöneticiler için GitHub Copilot panosundaki GitHub ilke ayarları, Visual Studio'da aracı modunu ve MCP kullanımını yönetir. Yönetici bu ayarı kapatırsa, söz konusu aboneliğin altındaki kullanıcılar aracı modunu kullanamaz veya Visual Studio'daki MCP sunucularına bağlanamaz.

Daha fazla bilgi için bkz. Kuruluşunuzda GitHub Copilot için ilkeleri ve özellikleri yönetme.

İlgili içerik

• GitHub Copilot aracı modu
• Visual Studio için GitHub Copilot Sohbet deneyimi
• GitHub Copilot Ücretsiz