Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Layanan Azure DevOps
Server MCP Azure DevOps jarak jauh adalah versi yang dihosting dari Azure DevOps MCP Server yang tidak memerlukan penginstalan lokal. Alih-alih menjalankan server di komputer Anda, Anda menyambungkan asisten AI Anda langsung ke titik akhir yang dihosting Azure DevOps dengan menggunakan transportasi HTTP yang dapat dialirkan.
Pilih jarak jauh terlebih dahulu
Gunakan Server MCP jarak jauh saat lingkungan Anda mendukungnya. Server jarak jauh adalah opsi yang direkomendasikan karena Azure DevOps host dan memperbaruinya, dan Anda tidak perlu menginstal Node.js atau mengelola proses server lokal.
Gunakan Server MCP lokal saat klien Anda tidak dapat mengautentikasi ke server jarak jauh dengan Microsoft Entra ID. Batasan ini saat ini berlaku untuk klien seperti Claude Desktop, Claude Code, dan Codex. Cursor memerlukan pendaftaran aplikasi Microsoft Entra khusus untuk autentikasi. Untuk instruksi penyiapan lokal, lihat Mengaktifkan bantuan AI dengan Azure DevOps McP Server.
| Feature | Server MCP Jarak Jauh | Server MCP Lokal |
|---|---|---|
| Penginstalan | Tidak diperlukan penginstalan | Memerlukan Node.js 20.0+ dan npx |
| Transportasi | HTTP yang dapat di-streaming | stdio |
| Authentication | Microsoft Entra ID (OAuth) | Azure DevOps PAT atau Microsoft Entra ID |
| Hosting | layanan yang dihosting Azure DevOps | Berjalan secara lokal di komputer Anda |
| Configuration | Minimalis mcp.json |
Pengaturan Khusus Lingkungan |
Prasyarat
| Kategori | Persyaratan |
|---|---|
| Azure DevOps | Organisasi Azure DevOps aktif yang didukung oleh tenant Microsoft Entra. Organisasi dengan akun Microsoft (MSA) mandiri tidak didukung untuk penggunaan Server MCP secara jarak jauh. |
| Permissions | Keanggotaan dalam proyek dan akses ke sumber daya yang ingin Anda kueri |
| Lingkungan | Lingkungan asisten AI yang didukung (lihat Lingkungan yang didukung) |
konfigurasi mcp.json
{
"servers": {
"ado-remote-mcp": {
"url": "https://mcp.dev.azure.com/{organization}",
"type": "http"
}
},
"inputs": []
}
Anda juga dapat menghilangkan nama organisasi dari URL. Namun, jika Anda menghilangkan nama organisasi, Anda harus memberikannya sebagai konteks dalam setiap panggilan alat.
{
"servers": {
"ado-remote-mcp": {
"url": "https://mcp.dev.azure.com/",
"type": "http"
}
},
"inputs": []
}
Perangkat alat
Tentukan toolset untuk membatasi alat yang tersedia untuk server MCP. Tidak boleh digabungkan dengan X-MCP-Tools.
{
"servers": {
"ado-remote-mcp": {
"url": "https://mcp.dev.azure.com/{organization}",
"type": "http",
"headers": {
"X-MCP-Toolsets": "repos,wiki,wit"
}
}
},
"inputs": []
}
| Nilai set perkakas | Alat yang disertakan |
|---|---|
all
(default) |
Semua alat |
repos |
Alat permintaan repositori dan pull |
advsec |
Alat pemberitahuan Keamanan Tingkat Lanjut |
wit |
Alat item kerja dan search_workitem |
pipelines |
Alat alur dan pembuatan |
wiki |
Alat wiki dan search_wiki |
work |
Alat iterasi dan kapasitas |
testplan |
Alat rencana pengujian |
elm |
Alat Migrasi Langsung Perusahaan (pratinjau; diaktifkan secara default) |
Alat baca-saja
Gunakan header X-MCP-Readonly tersebut untuk membatasi server ke operasi baca-saja. Pembatasan ini berguna ketika Anda ingin mencegah modifikasi Azure DevOps sumber daya.
{
"servers": {
"ado-remote-mcp": {
"url": "https://mcp.dev.azure.com/{organization}",
"type": "http",
"headers": {
"X-MCP-Readonly": "true"
}
}
},
"inputs": []
}
Menggabungkan toolset dan pemfilteran baca-saja
{
"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": []
}
Alat mandiri
Gunakan header X-MCP-Tools untuk hanya mengaktifkan alat tertentu. Tidak boleh digabungkan dengan X-MCP-Toolsets.
Tentukan nama alat yang muncul di daftar alat yang tersedia . Untuk alat terkonsolidasi seperti wit_work_item, pilih operasi dengan menggunakan parameter alat action saat Anda memanggilnya.
{
"servers": {
"ado-remote-mcp": {
"url": "https://mcp.dev.azure.com/{organization}",
"type": "http",
"headers": {
"X-MCP-Tools": "core_list_projects, wit_work_item"
}
}
},
"inputs": []
}
Orang dalam
Saat kami bereksperimen dan memperkenalkan alat dan pembaruan baru untuk yang sudah ada, Anda bisa mendapatkan akses awal ke perubahan ini dengan menggunakan X-MCP-Insiders header .
{
"servers": {
"ado-remote-mcp": {
"url": "https://mcp.dev.azure.com/{organization}",
"type": "http",
"headers": {
"X-MCP-Insiders": "true"
}
}
},
"inputs": []
}
Alat yang tersedia
Nota
Daftar ini mungkin tidak selalu mencerminkan pembaruan alat terbaru.
Alat inti
Alat inti selalu tersedia kecuali dinyatakan sebaliknya.
| Alat | Deskripsi |
|---|---|
core_list_orgs |
Mencantumkan Azure DevOps organisasi yang dapat diakses pengguna terautentikasi |
core_list_projects |
Mencantumkan proyek dalam organisasi |
core_list_project_teams |
Mencantumkan tim dalam proyek |
core_list_group_members |
Mencantumkan anggota langsung dan grup turunan dari grup Azure DevOps |
Nota
Hanya MCP Insiders yang dapat menggunakan core_list_group_members dengan menggunakan header X-MCP-Insiders.
Kerja
Alat kerja dikonsolidasikan menjadi pengirim yang dikelompokkan menggunakan parameter action.
| Alat | Action | Deskripsi | Baca-saja |
|---|---|---|---|
work |
list_iterations |
Mencantumkan semua perulangan dalam proyek | ✅ |
work |
list_team_iterations |
Daftar iterasi yang ditetapkan untuk tim | ✅ |
work |
get_team_settings |
Dapatkan pengaturan tim termasuk iterasi default, iterasi backlog, dan jalur area bawaan | ✅ |
work |
get_team_capacity |
Dapatkan kapasitas tim untuk iterasi | ✅ |
work |
get_iteration_capacities |
Dapatkan kapasitas iterasi untuk semua tim dalam iterasi dan proyek | ✅ |
work_iteration_write |
create |
Membuat perulangan | ❌ |
work_iteration_write |
assign |
Tetapkan iterasi ke tim | ❌ |
work_capacity_write |
update |
Memperbarui kapasitas tim dari anggota tim untuk iterasi tertentu | ❌ |
Repositori
Alat repositori dikonsolidasikan ke dalam dispatcher yang dikelompokkan menggunakan parameter action.
| Alat | Action | Deskripsi | Baca-saja |
|---|---|---|---|
repo_pull_request |
get |
Mendapatkan permintaan pull berdasarkan ID | ✅ |
repo_pull_request |
list |
Mencantumkan permintaan pull di repositori atau proyek | ✅ |
repo_pull_request |
list_by_commits |
Temukan permintaan tarik yang berisi ID komit tertentu | ✅ |
repo_pull_request |
get_changes |
Dapatkan perubahan file dan diff baris demi baris opsional untuk iterasi pull request | ✅ |
repo_pull_request_thread |
list |
Mencantumkan utas komentar pada pull request | ✅ |
repo_pull_request_thread |
list_comments |
Menampilkan komentar dalam utas tertentu | ✅ |
repo_repository |
get |
Mendapatkan repositori berdasarkan nama atau ID | ✅ |
repo_repository |
list |
Mencantumkan repositori dalam proyek | ✅ |
repo_branch |
get |
Dapatkan cabang menurut nama | ✅ |
repo_branch |
list |
Menampilkan cabang dalam repositori | ✅ |
repo_branch |
list_mine |
Menampilkan cabang yang telah didorong oleh pengguna saat ini | ✅ |
repo_file |
get_content |
Dapatkan konten teks dari sebuah file pada cabang, tag, atau commit tertentu | ✅ |
repo_file |
list_directory |
Mencantumkan file dan folder dalam direktori, dengan daftar rekursif opsional | ✅ |
repo_search_commits |
Cari commit dengan memfilter menurut teks, penulis, rentang tanggal, dan lainnya. | ✅ | |
search_code |
Pencarian kode teks lengkap | ✅ | |
repo_pull_request_write |
create |
Membuat permintaan pull | ❌ |
repo_pull_request_write |
update |
Memperbarui permintaan pull, termasuk mengatur pelengkapan otomatis | ❌ |
repo_pull_request_write |
update_reviewers |
Menambahkan atau menghapus peninjau permintaan pull | ❌ |
repo_pull_request_write |
vote |
Memberikan suara pada permintaan pull | ❌ |
repo_pull_request_thread_write |
create |
Buat utas komentar baru pada pull request | ❌ |
repo_pull_request_thread_write |
reply |
Membalas komentar di utas | ❌ |
repo_pull_request_thread_write |
update_status |
Memperbarui status utas komentar | ❌ |
repo_create_branch |
Membuat cabang | ❌ |
Kecerdasan
Alat untuk item kerja dikonsolidasikan ke dalam dispatcher yang dikelompokkan menggunakan parameter action.
| Alat | Action | Deskripsi | Baca-saja |
|---|---|---|---|
wit_work_item |
get |
Mendapatkan item kerja dengan ID | ✅ |
wit_work_item |
get_batch |
Ambil beberapa item kerja berdasarkan ID-ID | ✅ |
wit_work_item |
list_comments |
Mencantumkan komentar pada item kerja | ✅ |
wit_work_item |
my |
Mendapatkan item kerja yang relevan dengan pengguna yang diautentikasi | ✅ |
wit_work_item |
list_revisions |
Mencantumkan revisi item kerja | ✅ |
wit_work_item |
list_for_iteration |
Mencantumkan item kerja untuk perulangan tim | ✅ |
wit_work_item |
get_type |
Mendapatkan metadata untuk jenis item kerja | ✅ |
wit_query |
get |
Mendapatkan kueri berdasarkan ID atau jalur | ✅ |
wit_query |
get_results |
Menjalankan kueri yang disimpan | ✅ |
wit_query |
search |
Cari kueri menurut nama | ✅ |
wit_query |
list |
Daftar folder kueri root dan folder turunannya | ✅ |
wit_query_by_wiql |
Menjalankan kueri WIQL dan mengembalikan item kerja yang cocok | ✅ | |
wit_backlog |
list |
Mencantumkan tingkat backlog untuk tim | ✅ |
wit_backlog |
list_work_items |
Mencantumkan item kerja di tingkat backlog tertentu | ✅ |
search_workitem |
Pencarian teks lengkap item kerja | ✅ | |
wit_work_item_write |
create |
Membuat item kerja baru | ❌ |
wit_work_item_write |
update |
Memperbarui bidang pada item kerja | ❌ |
wit_work_item_write |
update_batch |
Memperbarui beberapa item kerja dalam satu panggilan | ❌ |
wit_work_item_write |
add_child |
Membuat item kerja anak di bawah induk | ❌ |
wit_work_item_comment_write |
add |
Menambahkan komentar ke item kerja | ❌ |
wit_work_item_comment_write |
update |
Memperbarui komentar yang sudah ada pada item kerja | ❌ |
wit_work_item_link_write |
link |
Menautkan dua item kerja | ❌ |
wit_work_item_link_write |
unlink |
Menghapus tautan dari item kerja | ❌ |
wit_work_item_link_write |
link_to_pull_request |
Menautkan item kerja ke permintaan pull | ❌ |
wit_work_item_link_write |
add_artifact_link |
Menambahkan tautan repositori, cabang, penerapan, build, atau artefak wiki ke item kerja | ❌ |
wit_work_item_attachment |
Unduh lampiran item kerja berdasarkan ID; mengembalikan konten berkode base64 dengan nama file dan tipe MIME | ✅ |
Nota
wit_query_by_wiql saat ini hanya tersedia untuk MCP Insider dengan menggunakan X-MCP-Insiders header .
Rantai Pengolahan
Alat alur dikonsolidasikan ke dalam dispatcher yang dikelompokkan menggunakan action parameter .
| Alat | Action | Deskripsi | Baca-saja |
|---|---|---|---|
pipelines_build |
list |
Membuat daftar dengan filter opsional | ✅ |
pipelines_build |
get_status |
Dapatkan status, masalah, dan metadata laporan untuk build. | ✅ |
pipelines_build |
get_changes |
Mendapatkan commit dan item kerja yang terkait dengan build | ✅ |
pipelines_build_log |
list |
Daftar log yang tersedia untuk membangun | ✅ |
pipelines_build_log |
get_content |
Dapatkan konten teks log tertentu berdasarkan ID | ✅ |
pipelines_definition |
list |
Mencantumkan definisi alur dengan filter opsional | ✅ |
pipelines_definition |
list_revisions |
Mencantumkan riwayat revisi untuk definisi alur | ✅ |
pipelines_run |
get |
Mendapatkan satu proses pipeline | ✅ |
pipelines_run |
list |
Daftar run untuk pipeline | ✅ |
pipelines_artifact |
list |
Mencantumkan artefak untuk build | ✅ |
pipelines_artifact |
download |
Mengunduh artefak build bernama | ✅ |
pipelines_write |
run_pipeline |
Mengantrekan proses pipeline baru | ❌ |
pipelines_write |
create_pipeline |
Membuat definisi alur YAML baru | ❌ |
pipelines_write |
update_build_stage |
Membatalkan, mencoba kembali, atau menjalankan tahap pada proses build yang sedang berlangsung | ❌ |
Wiki
Operasi baca wiki dikonsolidasikan ke dalam satu wiki alat bantu. Gunakan parameter action untuk pilih operasi.
| Alat | Action | Deskripsi | Baca-saja |
|---|---|---|---|
wiki |
list_wikis |
Mencantumkan wiki dalam proyek atau organisasi | ✅ |
wiki |
get_wiki |
Mendapatkan wiki menurut pengidentifikasi | ✅ |
wiki |
list_pages |
Mencantumkan halaman di wiki | ✅ |
wiki |
get_page |
Mendapatkan konten halaman dan metadata | ✅ |
search_wiki |
Pencarian wiki teks lengkap | ✅ | |
wiki_upsert_page |
Membuat atau memperbarui halaman wiki | ❌ |
Rencana pengujian
Alat rencana pengujian dikonsolidasikan menjadi dispatcher yang dikelompokkan menggunakan parameter action.
| Alat | Action | Deskripsi | Baca-saja |
|---|---|---|---|
testplan |
list_plans |
Mencantumkan rencana pengujian dalam proyek | ✅ |
testplan |
list_suites |
Mencantumkan rangkaian pengujian di bawah rencana pengujian | ✅ |
testplan |
list_cases |
Mencantumkan kasus pengujian di bawah rangkaian pengujian | ✅ |
testplan_show_test_results_from_build_id |
Dapatkan hasil pengujian dari build | ✅ | |
testplan_test_run |
get_results |
Dapatkan hasil untuk pelaksanaan pengujian dengan filter detail dan hasil akhir opsional | ✅ |
testplan_test_plan_write |
create |
Membuat rencana pengujian | ❌ |
testplan_test_suite_write |
create |
Buat rangkaian pengujian | ❌ |
testplan_test_suite_write |
add_test_cases |
Menambahkan kasus pengujian ke suite | ❌ |
testplan_test_case_write |
create |
Buat kasus pengujian | ❌ |
testplan_test_case_write |
update_steps |
Perbarui langkah-langkah kasus pengujian | ❌ |
testplan_test_run_write |
create_run |
Membuat uji coba untuk eksekusi pengujian manual | ❌ |
testplan_test_run_write |
update_results |
Perbarui outcome dan detail hasil pengujian dalam sebuah run | ❌ |
testplan_test_run_write |
complete_run |
Menyelesaikan atau membatalkan uji coba berdasarkan hasilnya | ❌ |
testplan_test_run_write |
update_test_point_outcome |
Memperbarui atau mengatur ulang hasil untuk titik pengujian | ❌ |
Keamanan Tingkat Lanjut
Alat Keamanan Lanjutan dikonsolidasikan ke dispatcher terkelompok yang menggunakan parameter action.
| Alat | Action | Deskripsi | Baca-saja |
|---|---|---|---|
advsec_alerts |
list |
Mencantumkan pemberitahuan Keamanan Tingkat Lanjut untuk repositori dengan filter opsional | ✅ |
advsec_alerts |
get |
Mendapatkan pemberitahuan Keamanan Tingkat Lanjut berdasarkan ID | ✅ |
Migrasi Langsung Perusahaan (pratinjau)
Alat Migrasi Langsung Perusahaan menggunakan action parameter untuk mengelompokkan dan mengirimkan tugas.
Pelajari selengkapnya tentang pratinjau Migrasi Langsung Perusahaan.
Penting
Dukungan ELM di Server MCP Azure DevOps jarak jauh saat ini masih dalam pratinjau. Alat diaktifkan secara default.
| Alat | Action | Deskripsi | Baca-saja |
|---|---|---|---|
enterprise_live_migration |
list |
Mencantumkan migrasi untuk organisasi; filter proyek opsional dan menyertakan benderaAllMigrations | ✅ |
enterprise_live_migration |
get |
Dapatkan status migrasi untuk repositori | ✅ |
enterprise_live_migration |
get_cutover_review |
Dapatkan item yang gagal atau diblokir sebelum cutover | ✅ |
enterprise_live_migration |
get_device_flow_config |
Dapatkan konfigurasi alur perangkat Aplikasi GitHub | ✅ |
enterprise_live_migration |
list_pipelines |
Mencantumkan alur dan status rewiring | ✅ |
enterprise_live_migration_write |
create |
Membuat migrasi baru | ❌ |
enterprise_live_migration_write |
pause |
Menjeda migrasi aktif | ❌ |
enterprise_live_migration_write |
resume |
Melanjutkan migrasi yang dijeda | ❌ |
enterprise_live_migration_write |
cutover_set |
Jadwalkan tanggal cutover | ❌ |
enterprise_live_migration_write |
cutover_cancel |
Batalkan cutover yang dijadwalkan | ❌ |
enterprise_live_migration_write |
approve_cutover |
Terima kegagalan dan lanjutkan dengan pengalihan | ❌ |
enterprise_live_migration_write |
abandon |
Menghapus migrasi secara permanen | ❌ |
enterprise_live_migration_pipelines_write |
submit |
Mengirimkan alur untuk di-rewiring | ❌ |
enterprise_live_migration_pipelines_write |
update |
Perbarui konfigurasi penyambungan ulang pipeline | ❌ |
enterprise_live_migration_pipelines_write |
delete |
Menghapus semua klon alur untuk migrasi terminal | ❌ |
Agar hanya alat Enterprise Live Migration yang tersedia, gunakan header X-MCP-Toolsets dengan nilai elm:
{
"servers": {
"ado-remote-mcp": {
"url": "https://mcp.dev.azure.com/{organization}",
"type": "http",
"headers": {
"X-MCP-Toolsets": "elm"
}
}
},
"inputs": []
}
Lingkungan yang didukung
Server MCP Azure DevOps jarak jauh mengharuskan akun pengguna dan organisasi Azure DevOps Anda tersambung ke Microsoft Entra ID.
Tidak semua klien MCP mendukung autentikasi Microsoft Entra secara default. Beberapa lingkungan memerlukan langkah tambahan untuk mendaftarkan aplikasi klien.
Lingkungan yang didukung untuk titik akhir jarak jauh, saat autentikasi Microsoft Entra tersedia, meliputi:
- Visual Studio dengan GitHub Copilot
- Visual Studio
- Microsoft Foundry
- Microsoft Copilot Studio
- GitHub Copilot CLI
- GitHub aplikasi Copilot
- Kursor dengan registrasi aplikasi Microsoft Entra khusus
Penting
Claude Desktop, Claude Code, dan Codex saat ini tidak mendukung alur autentikasi Microsoft Entra yang diperlukan oleh server MCP Azure DevOps jarak jauh. Gunakan Server MCP lokal dengan klien ini.
Visual Studio Code
Untuk mengonfigurasi Server MCP jarak jauh di Visual Studio Code:
- Tambahkan file
.vscode/mcp.jsonke repositori Anda dengan konfigurasi mcp.json yang ditampilkan sebelumnya. - Simpan file tersebut.
- Buka GitHub Copilot di Visual Studio Code.
- Saat diminta, autentikasi dengan menggunakan akun Microsoft Entra Anda dan pilih akun Anda.
Setelah autentikasi selesai, daftar alat yang tersedia akan muncul.
Visual Studio (2022 dan yang lebih baru)
Konfigurasikan Server MCP jarak jauh di Visual Studio dengan menambahkan URL server ke pengaturan MCP Anda. Untuk informasi selengkapnya, lihat Menggunakan server MCP di Visual Studio.
Cursor
Kursor memerlukan pendaftaran aplikasi Microsoft Entra kustom untuk mengakses server MCP Azure DevOps jarak jauh.
Mendaftarkan aplikasi
- Konfirmasikan bahwa aplikasi perusahaan MCP Azure DevOps disediakan di penyewa Anda. Jika Anda tidak dapat menemukannya, lihat Tidak dapat menemukan aplikasi perusahaan Azure DevOps MCP di penyewa.
- Di pusat admin Microsoft Entra, buka Pendaftaran aplikasi, lalu buat pendaftaran aplikasi.
- Di pendaftaran aplikasi, pilih Autentikasi (Pratinjau)>Tambahkan URI pengalihan>Aplikasi seluler dan desktop.
- Masukkan
http://localhost:8787/callbacksebagai URI pengalihan, lalu simpan perubahan Anda. - Pada halaman Autentikasi (Pratinjau) , pilih tab Pengaturan , lalu aktifkan Izinkan alur klien publik.
- Pada halaman izin API, pilih Tambahkan API izin> yangdigunakan organisasi saya.
- Cari Azure DevOps MCP atau ID
2a72489c-aab2-4b65-b93a-a91edccf33b8aplikasi, lalu pilih aplikasi. - Pilih izin yang didelegasikan yang diperlukan aplikasi Anda, lalu pilih Tambahkan izin.
- Pilih Berikan perizinan admin. Bergantung pada peran Anda, administrator penyewa mungkin perlu menyelesaikan langkah ini.
Salin ID Aplikasi (klien) dari pendaftaran aplikasi. Anda memerlukan nilai ini untuk mengonfigurasi Kursor.
Konfigurasikan Kursor
Di Cursor, buka Pengaturan>Alat & MCP.
Pilih Server MCP Baru.
Tambahkan konfigurasi berikut, ganti
{client-id}dengan ID aplikasi (klien) yang Anda salin:{ "mcpServers": { "ado": { "url": "https://mcp.dev.azure.com", "type": "http", "auth": { "CLIENT_ID": "{client-id}" } } } }Simpan konfigurasi, lalu kembali ke Pengaturan>Alat & MCP.
Temukan server ado , lalu pilih Autentikasi.
Memverifikasi koneksi
Setelah penyiapan, verifikasi server MCP jarak jauh berfungsi dengan mengajukan pertanyaan kepada asisten AI Anda tentang data Azure DevOps Anda.
Examples:
- "Cantumkan proyek di organisasi Azure DevOps saya."
- "Perlihatkan item kerja yang saya tetapkan."
- "Permintaan pull apa yang memerlukan peninjauan saya?"
Jika asisten AI mengembalikan hasil dari organisasi Azure DevOps Anda, Server MCP jarak jauh dikonfigurasi dengan benar.
Menggunakan AI untuk memvalidasi dan memecahkan masalah penyiapan MCP jarak jauh
Contoh prompt berikut untuk Copilot Chat membantu Anda memilih pendekatan MCP yang tepat, mengonfigurasi dan memvalidasi penyiapan remote, meningkatkan prompt penggunaan sehari-hari, dan memecahkan masalah saat terjadi kegagalan bila diperlukan. Salin dan tempelkan prompt ini ke Copilot Chat, lalu ganti placeholder dengan organisasi, klien, dan detail kesalahan Anda yang sebenarnya.
| Tugas | Contoh tanggapan |
|---|---|
| Pilih jarak jauh vs lokal | 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. |
| Membuat konfigurasi hak istimewa terkecil | Generate a remote mcp.json configuration for organization <contoso> that uses only the needed toolsets and read-only mode. |
Memvalidasi mcp.json penyiapan |
Review this remote Azure DevOps MCP server configuration and tell me whether anything is missing or incorrect for Visual Studio Code. |
| Memverifikasi asumsi autentikasi | Help me verify whether this remote MCP setup can authenticate with Microsoft Entra ID for organization <contoso>. |
| Tingkatkan prompt kueri untuk pekerjaan sehari-hari | 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. |
| Diagnosis Koneksi Ditolak | 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. |
| Mendiagnosis data yang hilang | The remote MCP server connects, but queries return no data. Help me determine whether this is a permissions issue or missing project context. |
| Header pemfilteran alat debug | Check my X-MCP-Toolsets and X-MCP-Tools header configuration and explain why expected tools are not appearing. |
Copilot didukung oleh AI, sehingga kejutan dan kesalahan dimungkinkan. Untuk informasi selengkapnya, lihat FAQ penggunaan umum Copilot.
Troubleshooting
| Issue | Resolution |
|---|---|
| Autentikasi gagal | Verifikasi kredensial Microsoft Entra Anda dan konfirmasikan bahwa Anda memiliki akses ke organisasi Azure DevOps. |
| Server tidak ditemukan | Periksa format URL server: https://mcp.dev.azure.com/{organization}. |
| Koneksi Ditolak | Konfirmasikan jaringan Anda mengizinkan HTTPS keluar ke mcp.dev.azure.com. Jika Anda menggunakan proksi atau firewall perusahaan, minta administrator Anda untuk menambahkan endpoint ke daftar yang diizinkan, lalu coba lagi tanpa VPN untuk mengisolasi masalah pada jalur jaringan. |
| Tidak ada data yang dikembalikan | Konfirmasikan bahwa Anda memiliki izin yang sesuai untuk proyek atau sumber daya yang sedang dikueri. |
| Alat ELM tidak tersedia | Alat ELM diaktifkan secara default. Jika Anda membatasi toolset yang tersedia, pastikan header X-MCP-Toolsets menyertakan elm. Kemudian sambungkan kembali Server MCP dan verifikasi bahwa identitas Anda memiliki izin Azure DevOps yang diperlukan. Untuk prasyarat, lihat ringkasan Migrasi Langsung Perusahaan. |
Untuk dukungan, Anda dapat membuat masalah di repositori Server MCP lokal . Pastikan untuk menggunakan templat Masalah Remote.
FAQ
Bagaimana dengan klien lain seperti Claude Desktop, Claude Code, atau Codex?
Claude Desktop, Claude Code, dan Codex memerlukan pendaftaran dinamis ID klien OAuth di Microsoft Entra ID sebelum mereka dapat menggunakan Server MCP jarak jauh. Microsoft Entra ID saat ini tidak mendukung alur pendaftaran klien dinamis yang diperlukan klien ini. Gunakan Server MCP lokal dengan klien ini.