Uzak Azure DevOps MCP Sunucusu'nu ayarlama (önizleme)

Azure DevOps Services

Önemli

Uzak Azure DevOps MCP Sunucusu şu anda genel önizleme aşamasındadır. Önizleme özellikleri sınırlı işlevlere sahip olabilir ve genel kullanıma sunulmadan önce değişebilir.

Destek

  • Destek şu anda yerel MCP Sunucusu deposu aracılığıyla gönderilen sorunlarla sınırlıdır.
  • Destek isteği göndermek için Uzak MCP Sunucusu sorun şablonunu kullanarak bir sorun oluşturun.

Uzak Azure DevOps MCP Sunucusu, yerel yükleme gerektirmeyen Azure DevOps MCP Server barındırılan bir sürümüdür. AI yardımcınızı makinenizde çalıştırmak yerine akışla aktarılabilir HTTP aktarımını kullanarak Azure DevOps barındırılan uç noktaya doğrudan bağlarsınız.

Uzak sunucu, yerel sunucuyla aynı özellikleri sağlar ve yerel kurulum karmaşıklığını ortadan kaldırırken iş öğelerine, çekme isteklerine, işlem hatlarına ve daha fazlasına erişim sağlar.

Uzak ve yerel MCP Sunucusu karşılaştırması

Özellik Uzak MCP Sunucusu (önizleme) Yerel MCP Sunucusu
Installation Yükleme gerekmez Node.js 20.0+ ve npx gerektirir
Taşıma Akışla aktarılabilir HTTP stdio
Kimlik Doğrulaması Microsoft Entra ID (OAuth) Azure DevOps PAT veya Microsoft Entra ID
Barındırma Azure DevOps barındırılan hizmet Makinenizde yerel olarak çalışır
Configuration Minimal mcp.json Ortama özgü kurulum
Statü Genel önizleme Genel kullanıma sunuldu

Önkoşullar

Kategori Gereksinimler
Azure DevOps Etkin bir Azure DevOps organizasyonu, Microsoft Entra ID'ye bağlı.
Permissions Proje üyeliği ve sorgulamak istediğiniz kaynaklara erişim
Çevre Desteklenen bir yapay zeka yardımcısı ortamı (bkz . Desteklenen ortamlar)

mcp.json yapılandırması

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http"
    }
  },
  "inputs": []
}

Url'den kuruluş adını da atlayabilirsiniz. Ancak kuruluş adını atlarsanız, her araç çağrısında bağlam olarak sağlamanız gerekir.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/",
      "type": "http"
    }
  },
  "inputs": []
}

Araç Setleri

MCP sunucusunda kullanılabilen araçları kısıtlamak için araç kümelerini belirtin. ile X-MCP-Toolsbirleştirilmemelidir.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}
Araç kümesi değeri Dahil edilen araçlar
all (varsayılan) Her araç takımından tüm araçlar
repos Depo ve çekme isteği araçları (repo_*)
wit İş öğesi araçları (wit_*) ve search_workitem
pipelines İşlem hattı ve derleme araçları (pipelines_*)
wiki Wiki araçları (wiki, wiki_upsert_page) ve search_wiki
work Yineleme ve kapasite araçları (work_*)
testplan Test planı araçları (testplan_*)

Salt okunur araçlar

X-MCP-Readonly üst bilgisini sunucuyu salt okunur işlemelere kısıtlamak için kullanın. Bu kısıtlama, Azure DevOps kaynaklarda değişiklik yapılmasını önlemek istediğinizde kullanışlıdır.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

Araç kümelerini ve salt okunur filtrelemeyi birleştirme

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit",
        "X-MCP-Readonly": "true"
      }
    }
  },
  "inputs": []
}

Tek tek araçlar

X-MCP-Tools Yalnızca belirli araçları etkinleştirmek için başlığı kullanın. ile X-MCP-Toolsetsbirleştirilmemelidir.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_my_work_items, wit_get_work_items_batch_by_ids"
      }
    }
  },
  "inputs": []
}

Içerdekiler

Mevcut araçlara deneyip yeni araçları ve güncellemeleri tanıttıkça, X-MCP-Insiders üst bilgisini kullanarak bu değişikliklere erken erişim elde edebilirsiniz.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Insiders": "true"
      }
    }
  },
  "inputs": []
}

Kullanılabilir araçlar

Uyarı

Bu liste her zaman en son araç güncelleştirmelerini yansıtmayabilir.

Temel araçlar

Temel araçlar her zaman kullanılabilir.

Araç Açıklama
core_list_orgs Kimliği doğrulanmış kullanıcının erişebildiği Azure DevOps kuruluşlarını listeleme
core_list_projects Kuruluştaki projeleri listeleme
core_list_project_teams Projedeki ekipleri listeleme

İş

Araç Açıklama Yalnızca okunabilir
work_list_team_iterations Bir takım için yinelemeleri listele. ✅
work_list_iterations Projedeki tüm yinelemeleri listeleme. ✅
work_get_team_capacity Bir yineleme için ekip kapasitesini al. ✅
work_create_iterations Yinelemeler oluşturun. ❌
work_assign_iterations Takıma iterasyonlar atayın. ❌
work_update_team_capacity Belirli bir yineleme için bir ekip üyesinin ekip kapasitesini güncelleştirin. ❌
work_get_team_settings Varsayılan yineleme, backlog yinelemesi ve varsayılan alan yolu dahil olmak üzere ekip ayarlarını alın. ✅
work_get_iteration_capacities Yineleme ve projedeki tüm ekipler için bir yineleme kapasitesi elde edin. ✅

Repos

Depo araçları, action parametresi kullanılarak gruplanmış dağıtıcılarda birleştirilmiştir.

Araç Action Açıklama Yalnızca okunabilir
repo_pull_request get Kimliğe göre pull request alma ✅
repo_pull_request list Depo veya projedeki çekme taleplerini listele. ✅
repo_pull_request list_by_commits Belirli işlem kimliklerini içeren çekme isteklerini bulun ✅
repo_pull_request_thread list Çekme isteğindeki yorum dizilerini listele ✅
repo_pull_request_thread list_comments Belirli bir yazışmadaki açıklamaları listeleme ✅
repo_repository get Ad veya kimliğe göre depo al ✅
repo_repository list Projedeki depoları listeleme ✅
repo_branch get İsme göre bir dal getir ✅
repo_branch list Depodaki dalları listele ✅
repo_branch list_mine Geçerli kullanıcının gönderdiği dalları listele ✅
repo_file get_content Belirli bir dalda, etikette veya işlemede dosyanın metin içeriğini alma ✅
repo_file list_directory Dizindeki dosya ve klasörleri isteğe bağlı özyinelemeli listeyle listeleme ✅
repo_search_commits Metne, yazara, tarih aralığına ve daha fazlasına göre filtreleme ile işlemeleri arama ✅
repo_pull_request_write create Çekme isteği oluştur ❌
repo_pull_request_write update Çekme isteğini güncelle, otomatik tamamlamayı ayarlama dâhil ❌
repo_pull_request_write update_reviewers İnceleme isteği inceleyicilerini ekle veya çıkar ❌
repo_pull_request_write vote Pull isteğine oy verin ❌
repo_pull_request_thread_write create Çekme isteğinde yeni bir yorum dizisi oluşturun ❌
repo_pull_request_thread_write reply Yazışmadaki açıklamayı yanıtlama ❌
repo_pull_request_thread_write update_status Açıklama yazışmasının durumunu güncelleştirme ❌
repo_create_branch Dal oluşturma ❌

Zekilik

İş öğesi araçları, bir action parametresi kullanılarak gruplandırılmış dağıtıcılar altında birleştirilir.

Araç Action Açıklama Yalnızca okunabilir
wit_work_item get Kimlikle iş öğesi al ✅
wit_work_item get_batch Kimlik ID'lerine göre birden çok iş öğesi alma ✅
wit_work_item list_comments İş öğesindeki açıklamaları listeleme ✅
wit_work_item my Kimliği doğrulanmış kullanıcıyla ilgili iş öğelerini alma ✅
wit_work_item list_revisions İş öğesinin düzeltmelerini listeleme ✅
wit_work_item list_for_iteration Ekip yinelemesi için iş öğelerini listeleme ✅
wit_work_item get_type İş öğesi türü için meta verileri alma ✅
wit_query get Kimlik veya yola göre sorgu alma ✅
wit_query get_results Kaydedilen sorguyu çalıştırma ✅
wit_backlog list Ekip için iş listesi düzeylerini listeleme ✅
wit_backlog list_work_items İş öğelerini belirli bir kapsam düzeyinde listeleme ✅
search_workitem Tam metin iş öğesi arama ✅
wit_work_item_write create Yeni iş öğesi oluşturma ❌
wit_work_item_write update İş öğesindeki alanları güncelleştirme ❌
wit_work_item_write update_batch Tek bir çağrıda birden çok iş öğesini güncelleştirme ❌
wit_work_item_write add_child Üst iş öğesinin altında alt iş öğeleri oluştur ❌
wit_work_item_comment_write add İş öğesine açıklama ekleme ❌
wit_work_item_comment_write update İş öğesinde var olan bir açıklamayı güncelleştirme ❌
wit_work_item_link_write link İki iş öğesini bağlama ❌
wit_work_item_link_write unlink İş öğesinden bağlantıları kaldırma ❌
wit_work_item_link_write link_to_pull_request Bir iş öğesini bir çekme isteğine bağlama ❌
wit_work_item_link_write add_artifact_link Bir iş öğesine depo, dal, commit veya yapıt bağlantısı ekleyin ❌
wit_work_item_attachment Kimliğe göre bir iş öğesi ekini indirin; dosya adı ve MIME türüyle birlikte base64 kodlu içeriği döndürür ✅

Uyarı

wit_query_by_wiql şu anda yalnızca MCP Insider'lar, X-MCP-Insiders başlığını kullanarak erişebilir.

Boru Hatları

İşlem hattı araçları, bir action parametresi kullanılarak gruplandırılmış dağıtıcılarda birleştirilir.

Araç Action Açıklama Yalnızca okunabilir
pipelines_build list İsteğe bağlı filtrelerle derlemeleri listeleme ✅
pipelines_build get_status Yapının durumunu, sorunlarını ve rapor metadata'sını al ✅
pipelines_build get_changes Bir yapı ile ilişkili commit ve iş öğelerini alma ✅
pipelines_build_log list Yapı için mevcut günlükleri listele ✅
pipelines_build_log get_content Belirli bir günlüğün metin içeriğini ID'sine göre alın ✅
pipelines_definition list İsteğe bağlı filtrelerle işlem hattı tanımlarını listeleme ✅
pipelines_definition list_revisions İşlem hattı tanımı için düzeltme geçmişini listeleme ✅
pipelines_run get Tek bir işlem hattı çalıştırması alma ✅
pipelines_run list İşlem hattı için çalıştırmaları listeleme ✅
pipelines_artifact list Derleme için artefaktları listele ✅
pipelines_artifact download Adlandırılmış kurulum bileşenini indir ✅
pipelines_write run_pipeline Yeni bir işlem hattı çalıştırması kuyruğa alın ❌
pipelines_write create_pipeline Yeni bir YAML işlem hattı tanımı oluşturma ❌
pipelines_write update_build_stage Uçuş içi derlemede bir aşamayı iptal etme, yeniden deneme veya çalıştırma ❌

Wiki

Wiki okuma işlemleri tek wiki bir araçta birleştirilir. action İşlemi seçmek için parametresini kullanın.

Araç Action Açıklama Yalnızca okunabilir
wiki list_wikis Proje veya kuruluştaki wiki'leri listeleme ✅
wiki get_wiki Tanımlayıcıya göre bir wiki alın ✅
wiki list_pages Wiki'de sayfaları listeleme ✅
wiki get_page Sayfa içeriğini ve meta verilerini alma ✅
search_wiki Tam metin wiki araması ✅
wiki_upsert_page Wiki sayfası oluşturma veya güncelleştirme ❌

Test planları

Test planı araçları, action parametresi kullanılarak gruplanmış dağıtıcılar altında birleştirilir.

Araç Action Açıklama Yalnızca okunabilir
testplan list_plans Projedeki test planlarını listeleme ✅
testplan list_suites Test planı altında test paketlerini listeleme ✅
testplan list_cases Test paketi altında test çalışmalarını listeleme ✅
testplan_show_test_results_from_build_id Bir derlemeden test sonuçlarını alma ✅
testplan_test_plan_write create Test planı oluşturma ❌
testplan_test_suite_write create Test paketi oluşturma ❌
testplan_test_suite_write add_test_cases Pakete test çalışmaları ekleme ❌
testplan_test_case_write create Test örneği oluşturma ❌
testplan_test_case_write update_steps Test çalışması adımlarını güncelleştirme ❌
Araç Açıklama Yalnızca okunabilir
search_code Tam metin kod araması. ✅
search_wiki Tam metin wiki araması. ✅
search_workitem Tam metin iş öğesi araması. ✅

Desteklenen ortamlar

Uzak Azure DevOps MCP Sunucusu, kullanıcı hesabınızın ve Azure DevOps kuruluşunuzun Microsoft Entra ID bağlanmasını gerektirir.

Tüm MCP istemcileri varsayılan olarak Microsoft Entra kimlik doğrulamayı desteklemez. Bazı ortamlar, istemci uygulamasını kaydetmek için ek adımlar gerektirir.

Şu anda desteklenen ortamlar şunlardır:

  • Visual Studio Code
  • Visual Studio

Visual Studio Code

uzak MCP Sunucusunu Visual Studio Code yapılandırmak için:

  1. Daha önce gösterilen .vscode/mcp.json deponuza bir dosya ekleyin.
  2. Dosyayı kaydedin.
  3. VS Code'da GitHub Copilot açın.
  4. İstendiğinde, Microsoft Entra hesabınızı kullanarak kimlik doğrulaması yapın ve hesabınızı seçin.

Kimlik doğrulaması tamamlandıktan sonra kullanılabilir araçların listesi görüntülenir.

Visual Studio (2022 ve üzeri)

Uzaktaki MCP Sunucusunu Visual Studio'da yapılandırmak için sunucu URL'sini MCP ayarlarına ekleyin. Daha fazla bilgi için bkz. mcp sunucularını Visual Studio kullanma.

Bağlantıyı doğrulama

Kurulumdan sonra, yapay zeka yardımcınıza Azure DevOps verileriniz hakkında bir soru sorarak uzak MCP Sunucusunun çalıştığını doğrulayın.

Examples:

  • "Azure DevOps kuruluşumdaki projeleri listele."
  • "Atanan iş öğelerimi göster."
  • "Hangi pull taleplerini incelemem gerekiyor?"

Yapay zeka yardımcısı Azure DevOps kuruluşunuzdan sonuçlar döndürürse uzak MCP Sunucusu doğru yapılandırılır.

Sorun giderme

Issue Çözünürlük
Kimlik doğrulaması başarısız oluyor Microsoft Entra kimlik bilgilerinizi doğrulayın ve Azure DevOps kuruluşuna erişiminiz olduğunu onaylayın.
Sunucu bulunamadı Sunucu URL biçimini denetleyin: https://mcp.dev.azure.com/{organization}.
Veri döndürülmedi Sorgulanan proje veya kaynaklar için uygun izinlere sahip olduğunuzu onaylayın.
Önizleme kullanılamıyor Önizleme aşamalı olarak dağıtılıyor. Daha sonra tekrar kontrol edin veya kuruluş yöneticinize başvurun.

Destek için yerel MCP Sunucusu deposunda bir sorun oluşturabilirsiniz. Uzak sorun şablonunu kullandığınızdan emin olun.

Sıkça Sorulan Sorular

GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX veya Cursor gibi diğer istemciler ne olacak?

CodeX, Claude Desktop, Claude Code ve ChatGPT gibi diğer istemci araçları, MCP sunucusuyla kullanılmadan önce Microsoft Entra'de bir OAuth İstemci Kimliğinin dinamik olarak kaydedilmesini gerektirir. Bu özelliği etkinleştirmek için Microsoft Entra ekibiyle yakın bir şekilde çalışıyoruz. Şimdilik yalnızca Visual Studio ve Visual Studio Code desteklenir.

Azure DevOps MCP Server hangi hizmetler tarafından kullanılabilir?

Azure Yapay Zeka Atölyesi, Microsoft 365 Copilot ve Copilot Studio gibi diğer hizmetler için destek henüz sağlanmaz ancak yakında eklenecektir.

Azure DevOps MCP Sunucusu AgentId'yi destekliyor mu?

AgentId desteği yakında sunulacaktır.

İlgili içerik

  • Last updated on