Konfigurowanie zdalnego serwera Azure DevOps MCP

usługi Azure DevOps

Zdalny serwer mcp Azure DevOps jest hostowaną wersją Azure DevOps MCP Server która nie wymaga instalacji lokalnej. Zamiast uruchamiać serwer na maszynie, możesz połączyć asystenta sztucznej inteligencji bezpośrednio z punktem końcowym hostowanym Azure DevOps przy użyciu transportu HTTP z możliwością przesyłania strumieniowego.

Najpierw wybierz tryb zdalny

Użyj zdalnego serwera MCP , gdy środowisko go obsługuje. Serwer zdalny jest zalecaną opcją, ponieważ Azure DevOps hosty i aktualizuje go i nie trzeba instalować Node.js ani zarządzać procesem serwera lokalnego.

Użyj lokalnego serwera MCP, gdy klient nie może uwierzytelnić się na serwerze zdalnym przy użyciu Microsoft Entra ID. To ograniczenie dotyczy obecnie klientów, takich jak Claude Desktop i Codex. Cursor i Claude Code wymagają niestandardowej rejestracji aplikacji Microsoft Entra na potrzeby uwierzytelniania. Aby uzyskać instrukcje dotyczące konfiguracji lokalnej, zobacz Włączanie asysty SI za pomocą serwera Azure DevOps MCP.

Wymagania wstępne

konfiguracja mcp.json

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

Możesz również pominąć nazwę organizacji z adresu URL. Jeśli jednak pominięto nazwę organizacji, musisz podać ją jako kontekst w każdym wywołaniu narzędzia.

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

Zestawy narzędzi

Określ zestawy narzędzi, aby ograniczyć narzędzia dostępne dla serwera MCP. Nie należy łączyć z X-MCP-Tools.

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

Narzędzia tylko do odczytu

Użyj nagłówka X-MCP-Readonly do ograniczenia serwera do operacji tylko odczytu. To ograniczenie jest przydatne, gdy chcesz zapobiec modyfikacjom Azure DevOps zasobów.

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

Łączenie zestawów narzędzi i filtrowanie w trybie tylko do odczytu

{
  "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": []
}

Poszczególne narzędzia

Użyj nagłówka X-MCP-Tools , aby włączyć tylko określone narzędzia. Nie należy łączyć z X-MCP-Toolsets.

Określ nazwy narzędzi wyświetlane na liście dostępnych narzędzi . W przypadku skonsolidowanych narzędzi, takich jak wit_work_item, wybierz operację przy użyciu parametru action narzędzia podczas jego wywoływania.

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

Wewnętrznych

Podczas eksperymentowania i wprowadzania nowych narzędzi i aktualizacji istniejących można uzyskać wczesny dostęp do tych zmian przy użyciu nagłówka X-MCP-Insiders .

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

Dostępne narzędzia

Podstawowe narzędzia

Podstawowe narzędzia są zawsze dostępne, chyba że określono inaczej.

Praca

Narzędzia robocze są scalane w zgrupowane dyspozytory przy użyciu parametru action.

Repos

Narzędzia repozytorium są konsolidowane do pogrupowanych dyspozytorów za pomocą parametru action.

Wit

Narzędzia elementów pracy są scalane w zgrupowane dyspozytory za pomocą parametru action.

Pipelines

Narzędzia potoku są konsolidowane w grupy dyspozytorów za pomocą parametru action.

Wiki

Operacje odczytu typu wiki są konsolidowane w jednym wiki narzędziu. Użyj parametru action , aby wybrać operację.

Plany testów

Narzędzia planu testów są konsolidowane w zgrupowanych dyspozytorach za pomocą parametru action.

Zaawansowane zabezpieczenia

Narzędzia Advanced Security są konsolidowane w grupowanym dyspozytorze, który używa parametru action .

Migracja na żywo w przedsiębiorstwie (wersja zapoznawcza)

Narzędzia do migracji na żywo w przedsiębiorstwie używają parametru action do grupowania i wysyłania zadań. Dowiedz się więcej o wersji zapoznawczej migracji na żywo w przedsiębiorstwie.

Aby udostępnić wyłącznie narzędzia Enterprise Live Migration, użyj nagłówka X-MCP-Toolsets z wartością elm:

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

Obsługiwane środowiska

Zdalny serwer Azure DevOps MCP wymaga konta użytkownika oraz organizacji Azure DevOps, aby połączyć się z Microsoft Entra ID.

Nie wszyscy klienci MCP domyślnie obsługują uwierzytelnianie Microsoft Entra. Niektóre środowiska wymagają wykonania dodatkowych kroków w celu zarejestrowania aplikacji klienckiej.

Obsługiwane środowiska dla zdalnego punktu końcowego, gdy jest dostępne uwierzytelnianie Microsoft Entra, obejmują:

• Visual Studio z GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• interfejs wiersza polecenia GitHub Copilot
• Aplikacja GitHub Copilot
• Cursor lub Claude Code z niestandardową rejestracją aplikacji w Microsoft Entra

Visual Studio Code

Aby skonfigurować zdalny serwer MCP w Visual Studio Code:

1. .vscode/mcp.json Dodaj plik do repozytorium przy użyciu przedstawionej wcześniej konfiguracjimcp.json.
2. Zapisz plik.
3. Otwórz GitHub Copilot w programie VS Code.
4. Po wyświetleniu monitu uwierzytelnij się przy użyciu konta Microsoft Entra i wybierz swoje konto.

Po zakończeniu uwierzytelniania zostanie wyświetlona lista dostępnych narzędzi.

Visual Studio (2022 i nowsze)

Skonfiguruj zdalny serwer MCP w Visual Studio przez dodanie adresu URL serwera do ustawień MCP. Aby uzyskać więcej informacji, zobacz Użyj serwery MCP w Visual Studio.

Cursor

Cursor wymaga własnej rejestracji aplikacji Microsoft Entra, aby uzyskać dostęp do zdalnego serwera MCP usługi Azure DevOps.

Rejestrowanie aplikacji

1. Upewnij się, że aplikacja dla przedsiębiorstw Azure DevOps MCP została wdrożona w Twojej dzierżawie. Jeśli nie możesz jej znaleźć, zobacz Nie możesz znaleźć aplikacji korporacyjnej Azure DevOps MCP w dzierżawie.
2. W centrum administracyjne Microsoft Entra przejdź do Rejestracje aplikacji, a następnie utwórz rejestrację aplikacji.
3. W obszarze rejestracji aplikacji wybierz pozycje Uwierzytelnianie (wersja zapoznawcza)>Dodaj identyfikator URI przekierowania>Aplikacje mobilne i klasyczne.
4. Wprowadź http://localhost:8787/callback jako identyfikator URI przekierowania, a następnie zapisz zmiany.
5. Na stronie Uwierzytelnianie (wersja zapoznawcza) wybierz kartę Ustawienia , a następnie włącz opcję Zezwalaj na przepływy klientów publicznych.
6. Na stronie Uprawnienia interfejsu API wybierz pozycję Dodaj uprawnienie>Interfejsy API używane przez moją organizację.
7. Wyszukaj Azure DevOps MCP lub identyfikator 2a72489c-aab2-4b65-b93a-a91edccf33b8aplikacji , a następnie wybierz aplikację.
8. Wybierz delegowane uprawnienia wymagane przez aplikację, a następnie wybierz pozycję Dodaj uprawnienia.
9. Wybierz Udzielanie zgody administratora. W zależności od roli administrator dzierżawy może wymagać wykonania tego kroku.

Skopiuj identyfikator aplikacji (klienta) z rejestracji aplikacji. Ta wartość jest potrzebna do skonfigurowania kursora.

Konfigurowanie kursora

1. W Cursor otwórz Ustawienia>.

2. Wybierz pozycję Nowy serwer MCP.

3. Dodaj następującą konfigurację, zastępując {client-id} skopiowanym identyfikatorem aplikacji (klienta):

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

4. Zapisz konfigurację, a następnie wróć do Ustawień>Narzędzia i MCP.

5. Znajdź serwer ado , a następnie wybierz pozycję Uwierzytelnij.

Kod Claude'a

Claude Code wymaga niestandardowej rejestracji aplikacji Microsoft Entra, aby uzyskać dostęp do zdalnego serwera MCP Azure DevOps.

Rejestrowanie aplikacji

1. Upewnij się, że aplikacja dla przedsiębiorstw Azure DevOps MCP została wdrożona w Twojej dzierżawie. Jeśli nie możesz jej znaleźć, zobacz Nie możesz znaleźć aplikacji korporacyjnej Azure DevOps MCP w dzierżawie.
2. W centrum administracyjne Microsoft Entra przejdź do Rejestracje aplikacji, a następnie utwórz rejestrację aplikacji.
3. W obszarze rejestracji aplikacji wybierz pozycje Uwierzytelnianie (wersja zapoznawcza)>Dodaj identyfikator URI przekierowania>Aplikacje mobilne i klasyczne.
4. Wprowadź http://localhost:3118/callback jako identyfikator URI przekierowania, a następnie zapisz zmiany.
5. Na stronie Uwierzytelnianie (wersja zapoznawcza) wybierz kartę Ustawienia , a następnie włącz opcję Zezwalaj na przepływy klientów publicznych.
6. Na stronie Uprawnienia interfejsu API wybierz pozycję Dodaj uprawnienie>Interfejsy API używane przez moją organizację.
7. Wyszukaj Azure DevOps MCP lub identyfikator 2a72489c-aab2-4b65-b93a-a91edccf33b8aplikacji , a następnie wybierz aplikację.
8. Wybierz delegowane uprawnienia wymagane przez aplikację, a następnie wybierz pozycję Dodaj uprawnienia.
9. Wybierz Udzielanie zgody administratora. W zależności od roli administrator dzierżawy może wymagać wykonania tego kroku.

Skopiuj identyfikator aplikacji (klienta) z rejestracji aplikacji. Ta wartość jest potrzebna do skonfigurowania programu Claude Code.

Konfigurowanie kodu Claude'a

1. Uruchom następujące polecenie, zastępując {client-id} element identyfikatorem aplikacji (klienta), który został skopiowany i {organization} nazwą organizacji Azure DevOps:

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

   Alternatywnie utwórz .mcp.json plik w katalogu głównym repozytorium przy użyciu następującej konfiguracji:

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

2. Uruchom program Claude Code, uruchamiając polecenie claude.

3. Uruchom polecenie /mcp, a następnie postępuj zgodnie z przepływem logowania przeglądarki, aby uwierzytelnić się przy użyciu konta Microsoft Entra.

Aby uzyskać więcej informacji na temat tych opcji, zobacz Connect Claude Code to tools via MCP (Łączenie kodu Claude'a z narzędziami za pośrednictwem programu MCP).

Weryfikowanie połączenia

Po skonfigurowaniu sprawdź, czy zdalny serwer MCP działa, zadając asystentowi sztucznej inteligencji pytanie dotyczące danych Azure DevOps.

Przykłady:

• "Wyświetl listę projektów w mojej organizacji Azure DevOps".
• Pokaż moje przypisane zadania.
• Jakie prośby o scalenie wymagają mojej recenzji?

Jeśli asystent sztucznej inteligencji zwraca wyniki z organizacji Azure DevOps, zdalny serwer MCP jest poprawnie skonfigurowany.

Używanie sztucznej inteligencji do weryfikowania i rozwiązywania problemów z zdalną konfiguracją mcp

Poniższe przykładowe monity dla Copilot Chat pomagają wybrać odpowiednie podejście do MCP, skonfigurować i zweryfikować konfigurację zdalnego połączenia, udoskonalić monity używane na co dzień oraz w razie potrzeby rozwiązywać problemy związane z błędami. Skopiuj i wklej te prompty w Copilot Chat, a następnie zastąp symbole zastępcze rzeczywistymi informacjami o swojej organizacji, kliencie i szczegółach błędu.

Copilot jest obsługiwany przez sztuczną inteligencję, więc możliwe są niespodzianki i błędy. Aby uzyskać więcej informacji, zobacz Copilot — często zadawane pytania.

Troubleshooting

Aby uzyskać pomoc techniczną, możesz utworzyć problem w lokalnym repozytorium serwera MCP . Pamiętaj, aby użyć szablonu zdalnego zgłoszenia.

Często zadawane pytania

Co z innymi klientami, takimi jak Claude Desktop lub Codex?

Claude Desktop i Codex wymagają dynamicznej rejestracji identyfikatora klienta OAuth w Microsoft Entra ID przed użyciem zdalnego serwera MCP. Microsoft Entra ID obecnie nie obsługuje dynamicznego przepływu rejestracji klienta wymaganego przez tych klientów. Użyj lokalnego serwera MCP z tymi klientami.

Treści powiązane

• Azure DevOps Omówienie serwera MCP
• Repozytorium GitHub Azure DevOps MCP Server