Uzak Azure DevOps MCP Sunucusunu kurun

Azure DevOps Hizmetleri

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.

Önce uzaktan olanı seçin

Ortamınız desteklediğinde uzak MCP Sunucusunu kullanın. Uzak sunucu önerilen seçenektir çünkü Azure DevOps konaklar ve güncelleştirir ve Node.js yüklemeniz veya yerel sunucu işlemini yönetmeniz gerekmez.

İstemciniz Microsoft Entra ID ile uzak sunucuda kimlik doğrulaması yapamazsa yerel MCP Sunucusunu kullanın. Bu sınırlama şu anda Claude Desktop ve Codex gibi istemciler için geçerlidir. İmleç ve Claude Code kimlik doğrulaması için özel bir Microsoft Entra uygulama kaydı gerektirir. Yerel kurulum yönergeleri için bkz. Azure DevOps MCP Sunucusu ile yapay zeka yardımını etkinleştirme.

Özellik	Uzak MCP Sunucusu	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	Minimum mcp.json	Ortama özgü kurulum

Önkoşullar

Kategori	Gereksinimler
Azure DevOps	Microsoft Entra kiracısı tarafından desteklenen etkin bir Azure DevOps kuruluşu. Yalnızca Microsoft hesabı (MSA) kullanan kuruluşlar, MCP Sunucusunun uzaktan kullanımı için desteklenmemektedir.
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)	Tüm araçlar
repos	Depo ve pull request araçları
advsec	Gelişmiş Güvenlik uyarı araçları
wit	İş öğesi araçları ve search_workitem
pipelines	İşlem hattı ve derleme araçları
wiki	Wiki araçları ve search_wiki
work	İterasyon ve kapasite araçları
testplan	Test planı araçları
elm	Kurumsal Dinamik Geçiş araçları (önizleme; varsayılan olarak etkin)

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.

Kullanılabilir araçlar listesinde görünen araç adlarını belirtin. gibi wit_work_itembirleştirilmiş araçlar için, çağırdığınızda aracın action parametresini kullanarak işlemi seçin.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_work_item"
      }
    }
  },
  "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

Aksi belirtilmediği sürece 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
core_list_group_members	Azure DevOps grubunun doğrudan üyelerini ve alt gruplarını listeleme

Uyarı

Yalnızca MCP Insider'ları, X-MCP-Insiders başlığını kullanarak core_list_group_members kullanabilir.

İş

İş araçları, bir action parametresi kullanılarak gruplanmış dağıtıcılarda birleştirilir.

Araç	Action	Açıklama	Yalnızca okunabilir
work	list_iterations	Projedeki tüm yinelemeleri listeleme	✅
work	list_team_iterations	Takıma atanan iterasyonları listeleyin	✅
work	get_team_settings	Varsayılan yineleme, iş listesi yinelemesi ve varsayılan alan yolu dahil olmak üzere ekip ayarlarını al	✅
work	get_team_capacity	Bir yineleme için ekip kapasitesini al	✅
work	get_iteration_capacities	Yineleme ve projedeki tüm ekipler için bir yinelemenin kapasitesini alma	✅
work_iteration_write	create	İterasyonlar oluşturun	❌
work_iteration_write	assign	Bir takıma yinelemeler atayın	❌
work_capacity_write	update	Belirli bir yineleme için ekip üyesinin ekip kapasitesini güncelleştirme	❌

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	get_changes	Bir çekme talebi yinelemesi için dosya değişikliklerini ve isteğe bağlı satır satır farkları alın	✅
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	✅
search_code		Tam metin kod araması	✅
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_query	search	Sorguları ada göre arayın	✅
wit_query	list	Kök sorgu klasörlerini ve alt öğelerini listeleme	✅
wit_query_by_wiql		WIQL sorgusu çalıştırma ve eşleşen iş öğelerini döndürme	✅
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, derleme veya wiki bağlantısı ekleme	❌
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_run	get_results	İsteğe bağlı ayrıntı ve sonuç filtreleriyle bir test çalıştırmasının 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	❌
testplan_test_run_write	create_run	Manuel test yürütmesi için test çalıştırması oluşturma	❌
testplan_test_run_write	update_results	Bir çalıştırmadaki test sonuçlarının durumunu ve ayrıntılarını güncelleştirme	❌
testplan_test_run_write	complete_run	Test çalıştırmasını sonuçlarına göre tamamlama veya durdurma	❌
testplan_test_run_write	update_test_point_outcome	Test noktaları için sonuçları güncelleştirme veya sıfırlama	❌

Gelişmiş Güvenlik

Gelişmiş Güvenlik araçları, action parametresini kullanan gruplu bir yönlendirici içinde bir araya getirilmiştir.

Araç	Action	Açıklama	Yalnızca okunabilir
advsec_alerts	list	İsteğe bağlı filtreler içeren bir depo için Gelişmiş Güvenlik uyarılarını listeleme	✅
advsec_alerts	get	Kimliğine göre Gelişmiş Güvenlik uyarısı alma	✅

Kurumsal Canlı Geçiş (önizleme)

Enterprise Live Migration araçları, görevleri gruplandırmak ve göndermek için bir action parametre kullanır. Enterprise Live Migration önizlemesi hakkında daha fazla bilgi edinin.

Önemli

UZAK Azure DevOps MCP Sunucusu'nda ELM desteği şu anda önizleme aşamasındadır. Araçlar varsayılan olarak etkindir.

Araç	Action	Açıklama	Yalnızca okunabilir
enterprise_live_migration	list	Kuruluş için geçişleri listeleme; isteğe bağlı proje filtresi ve includeAllMigrations bayrağı	✅
enterprise_live_migration	get	Depo için geçiş durumunu alma	✅
enterprise_live_migration	get_cutover_review	Tam geçişten önce başarısız olan veya engellenen öğeleri alın	✅
enterprise_live_migration	get_device_flow_config	GitHub Uygulaması cihaz akışı yapılandırmasını alma	✅
enterprise_live_migration	list_pipelines	İşlem hatlarını ve yeniden döndürme durumunu listeleme	✅
enterprise_live_migration_write	create	Yeni bir geçiş oluştur	❌
enterprise_live_migration_write	pause	Etkin geçişi duraklatma	❌
enterprise_live_migration_write	resume	Duraklatılmış geçişi sürdürme	❌
enterprise_live_migration_write	cutover_set	Tam geçiş tarihi planlayın	❌
enterprise_live_migration_write	cutover_cancel	Zamanlanmış geçişi iptal etme	❌
enterprise_live_migration_write	approve_cutover	Hataları kabul edin ve tam geçişe geçin	❌
enterprise_live_migration_write	abandon	Geçişi kalıcı olarak silme	❌
enterprise_live_migration_pipelines_write	submit	Yeniden yapılandırma için iş hatlarını gönderin	❌
enterprise_live_migration_pipelines_write	update	İşlem hattı yeniden döndürme yapılandırmasını güncelleştirme	❌
enterprise_live_migration_pipelines_write	delete	Terminal geçişi için tüm işlem hattı kopyalarını silin	❌

Yalnızca Enterprise Live Migration araçlarını kullanılabilir kılmak için, X-MCP-Toolsets değerine sahip elm üst bilgisini kullanın:

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

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.

Microsoft Entra kimlik doğrulaması kullanılabilir olduğunda uzak uç nokta için desteklenen ortamlar şunlardır:

• GitHub Copilot ile Visual Studio
• Visual Studio
• Microsoft Dökümhanesi
• Microsoft Copilot Studio
• GitHub Copilot CLI
• GitHub Copilot uygulaması
• Özel bir Microsoft Entra uygulama kaydıyla Cursor veya Claude Code

Önemli

Claude Desktop ve Codex şu anda uzak Azure DevOps MCP Sunucusu için gereken Microsoft Entra kimlik doğrulama akışını desteklememektedir. Bu istemcilerle yerel MCP Sunucusunu kullanın.

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.

Cursor

Cursor, uzak Azure DevOps MCP Sunucusuna erişmek için özel bir Microsoft Entra uygulama kaydı gerektirir.

Uygulamayı kaydetme

1. Azure DevOps MCP kurumsal uygulamasının kiracınızda sağlandığını onaylayın. Bulamıyorsanız bkz. Kiracıda Azure DevOps MCP kurumsal uygulaması bulunamıyor.
2. Microsoft Entra yönetim merkezi Uygulama kayıtları gidin ve bir uygulama kaydı oluşturun.
3. Uygulama kaydında Kimlik Doğrulaması (Önizleme)>Yeniden yönlendirme URI'sini> ekleMobil ve masaüstü uygulamaları'nı seçin.
4. Yeniden yönlendirme URI'sini girin http://localhost:8787/callback ve değişikliklerinizi kaydedin.
5. Kimlik Doğrulaması (Önizleme) sayfasında Ayarlar sekmesini seçin ve genel istemci akışlarına izin ver'i etkinleştirin.
6. API izinleri sayfasındaKuruluşumun kullandığı izin > API'leri ekle'yiseçin.
7. Azure DevOps MCP veya uygulama kimliğini 2a72489c-aab2-4b65-b93a-a91edccf33b8arayın ve uygulamayı seçin.
8. Uygulamanızın gerektirdiği temsilci izinlerini seçin ve ardından İzin ekle'yi seçin.
9. Yönetici onayı ver'i seçin. Rolünüze bağlı olarak, kiracı yöneticisinin bu adımı tamamlaması gerekebilir.

Uygulama kaydından Uygulama (istemci) kimliğini kopyalayın. İmleci yapılandırmak için bu değere ihtiyacınız vardır.

İmleci Yapılandır

1. İmleç'te Ayarlar>Araçları ve MCP'yi açın.

2. Yeni MCP Sunucusu'nu seçin.

3. Kopyaladığınız uygulama (istemci) kimliğiyle {client-id} öğesini değiştirerek aşağıdaki yapılandırmayı ekleyin:

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}"
         }
       }
     }
   }
   

4. Yapılandırmayı kaydedin ve ardından Ayarlar>Araçları ve MCP'ye dönün.

5. ado sunucusunu bulun ve kimlik doğrulaması'nı seçin.

Claude Code

Claude Code, uzak Azure DevOps MCP Sunucusuna erişmek için özel bir Microsoft Entra uygulama kaydı gerektirir.

Uygulamayı kaydetme

1. Azure DevOps MCP kurumsal uygulamasının kiracınızda sağlandığını onaylayın. Bulamıyorsanız bkz. Kiracıda Azure DevOps MCP kurumsal uygulaması bulunamıyor.
2. Microsoft Entra yönetim merkezi Uygulama kayıtları gidin ve bir uygulama kaydı oluşturun.
3. Uygulama kaydında Kimlik Doğrulaması (Önizleme)>Yeniden yönlendirme URI'sini> ekleMobil ve masaüstü uygulamaları'nı seçin.
4. Yeniden yönlendirme URI'sini girin http://localhost:3118/callback ve değişikliklerinizi kaydedin.
5. Kimlik Doğrulaması (Önizleme) sayfasında Ayarlar sekmesini seçin ve genel istemci akışlarına izin ver'i etkinleştirin.
6. API izinleri sayfasındaKuruluşumun kullandığı izin > API'leri ekle'yiseçin.
7. Azure DevOps MCP veya uygulama kimliğini 2a72489c-aab2-4b65-b93a-a91edccf33b8arayın ve uygulamayı seçin.
8. Uygulamanızın gerektirdiği temsilci izinlerini seçin ve ardından İzin ekle'yi seçin.
9. Yönetici onayı ver'i seçin. Rolünüze bağlı olarak, kiracı yöneticisinin bu adımı tamamlaması gerekebilir.

Uygulama kaydından Uygulama (istemci) kimliğini kopyalayın. Claude Code'un yapılandırılması için bu değere ihtiyacınız var.

Claude Code'ı yapılandırma

1. Aşağıdaki komutu, kopyaladığınız uygulama (istemci) kimliğiyle {organization} öğesini ve Azure DevOps kuruluşunuzun adıyla {client-id} öğesini değiştirerek çalıştırın:

   claude mcp add --transport http ado https://mcp.dev.azure.com/{organization} \
     --client-id {client-id} --callback-port 3118
   

   Alternatif olarak, aşağıdaki yapılandırmayla deponuzun kökünde bir .mcp.json dosya oluşturun:

   {
     "mcpServers": {
       "ado": {
         "type": "http",
         "url": "https://mcp.dev.azure.com/{organization}",
         "oauth": {
           "clientId": "{client-id}",
           "callbackPort": 3118
         }
       }
     }
   }
   

2. komutunu çalıştırarak claudeClaude Code'a başlayın.

3. komutunu çalıştırın /mcpve ardından tarayıcı oturum açma akışını izleyerek Microsoft Entra hesabınızla kimlik doğrulaması yapın.

Bu seçenekler hakkında daha fazla bilgi için bkz . Claude Code'u MCP aracılığıyla araçlara bağlama.

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.

Uzak MCP kurulumunu doğrulamak ve sorunlarını gidermek için yapay zekayı kullanma

Aşağıdaki örnek, Copilot Chat doğru MCP yaklaşımını seçmenize, uzaktan kurulumu yapılandırmanıza ve doğrulamanıza, günlük kullanım istemlerini iyileştirmenize ve gerektiğinde hataları gidermenize yardımcı olur. Bu istemleri kopyalayıp Copilot Chat yapıştırın ve yer tutucuları gerçek kuruluşunuz, istemciniz ve hata ayrıntılarınızla değiştirin.

Görev	Örnek talimat
Uzak ve yerel'i seçin	For my environment and client tools, help me decide whether to use the remote Azure DevOps MCP Server or the local server, and explain the tradeoffs.
En az ayrıcalıklı yapılandırma oluşturma	Generate a remote mcp.json configuration for organization <contoso> that uses only the needed toolsets and read-only mode.
Kurulumu doğrulama mcp.json	Review this remote Azure DevOps MCP server configuration and tell me whether anything is missing or incorrect for Visual Studio Code.
Kimlik doğrulama varsayımlarını doğrulama	Help me verify whether this remote MCP setup can authenticate with Microsoft Entra ID for organization <contoso>.
Günlük iş için sorgu istemlerini geliştirme	Give me better prompt wording to reliably fetch fresh Azure DevOps data from remote MCP for project <project-name>, including how to avoid stale results.
Bağlantıyı Tanılama Reddedildi	I'm getting Connection Refused when connecting to https://mcp.dev.azure.com/<organization>. Give me step-by-step network, proxy, and firewall checks to fix it.
Eksik verileri tanılama	The remote MCP server connects, but queries return no data. Help me determine whether this is a permissions issue or missing project context.
Hata ayıklama aracı filtre üst bilgileri	Check my X-MCP-Toolsets and X-MCP-Tools header configuration and explain why expected tools are not appearing.

Copilot yapay zeka ile desteklendiğinden sürprizler ve hatalar mümkündür. Daha fazla bilgi için Copilot genel kullanım hakkında sıkça sorulan sorular bölümüne bakın.

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}.
Bağlantı Reddedildi	Ağınızın mcp.dev.azure.com adresine giden HTTPS trafiğine izin verdiğini doğrulayın. Kurumsal bir proxy veya güvenlik duvarı kullanıyorsanız, yöneticinizden uç noktayı izin listesine almasını isteyin ve ağ yolu sorunlarını izole etmek için VPN olmadan tekrar deneyin.
Veri döndürülmedi	Sorgulanan proje veya kaynaklar için uygun izinlere sahip olduğunuzu onaylayın.
ELM araçları kullanılamıyor	ELM araçları varsayılan olarak etkindir. Kullanılabilir araç kümelerini kısıtlarsanız, X-MCP-Toolsets üst bilginin elm içerdiğini doğrulayın. Ardından MCP Sunucusu'nu yeniden bağlayın ve kimliğinizin gerekli Azure DevOps izinlerine sahip olduğunu doğrulayın. Önkoşullar için bkz . Enterprise Live Migrations'a genel bakış.

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

Sıkça Sorulan Sorular

Claude Desktop veya Codex gibi diğer istemciler ne olacak?

Claude Desktop ve Codex, uzak MCP Sunucusunu kullanabilmeleri için önce Microsoft Entra ID'da bir OAuth istemci kimliğinin dinamik olarak kaydedilmesini gerektirir. Microsoft Entra ID şu anda bu istemcilerin gerektirdiği dinamik istemci kayıt akışını desteklememektedir. Bu istemcilerle yerel MCP Sunucusunu kullanın.

İlgili içerik

• Azure DevOps MCP Sunucusuna genel bakış
• Azure DevOps MCP Server GitHub deposu