Configurar o servidor MCP do Azure DevOps remoto (versão prévia)

Serviços do Azure DevOps

O servidor MCP de Azure DevOps remoto é uma versão hospedada do servidor MCP Azure DevOps que não requer uma instalação local. Em vez de executar o servidor em seu computador, você conecta seu assistente de IA diretamente ao ponto de extremidade hospedado no Azure DevOps usando transporte HTTP em streaming.

O servidor remoto fornece os mesmos recursos que o servidor local, incluindo acesso a itens de trabalho, solicitações de pull, pipelines e muito mais, eliminando a complexidade da instalação local.

Servidor MCP local vs. remoto

Pré-requisitos

configuração de mcp.json

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

Você também pode omitir o nome da organização da URL. No entanto, se você omitir o nome da organização, deverá fornecê-lo como contexto em cada chamada de ferramenta.

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

Conjuntos de ferramentas

Especifique os conjuntos de ferramentas para restringir as ferramentas disponíveis para o servidor MCP. Não deve ser combinado com X-MCP-Tools.

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

Ferramentas somente leitura

Use o X-MCP-Readonly cabeçalho para restringir o servidor a operações somente leitura. Essa restrição é útil quando você deseja impedir modificações em recursos Azure DevOps.

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

Combinar conjuntos de ferramentas e filtragem somente para leitura

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

Ferramentas individuais

Use o X-MCP-Tools cabeçalho para habilitar apenas ferramentas específicas. Não deve ser combinado com X-MCP-Toolsets.

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

Funcionários internos

À medida que experimentamos e introduzimos novas ferramentas e atualizações para as existentes, você pode obter acesso antecipado a essas alterações usando o X-MCP-Insiders cabeçalho.

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

Ferramentas disponíveis

Ferramentas principais

As principais ferramentas estão sempre disponíveis.

Trabalho

Repos

As ferramentas do repositório são consolidadas em despachantes agrupados usando um parâmetro action seguindo o mesmo padrão das ferramentas da wiki. Os nomes de ferramentas individuais anteriores continuam funcionando como aliases. Use repo_create_branch e repo_search_commits diretamente – eles não foram consolidados.

Wit

As ferramentas de item de trabalho são consolidadas em dispatchers agrupados usando um action parâmetro, seguindo o mesmo padrão que as ferramentas de repositório e pipeline. Os nomes de ferramentas individuais anteriores continuam funcionando como aliases. Use search_workitem diretamente – ele não foi consolidado.

Pipelines

As ferramentas de pipeline são consolidadas em dispatchers agrupados usando um action parâmetro, seguindo o mesmo padrão que as ferramentas wiki e repositório. Os nomes de ferramentas individuais anteriores continuam funcionando como aliases.

Wiki

As operações de leitura da wiki são consolidadas em uma única ferramenta wiki. Use o action parâmetro para selecionar a operação.

Planos de teste

Pesquisa

Ambientes com suporte

O servidor MCP de Azure DevOps remoto exige que sua conta de usuário e organização do Azure DevOps se conectem ao Microsoft Entra ID.

Nem todos os clientes MCP dão suporte à autenticação do Entra por padrão. Alguns ambientes exigem etapas extras para registrar o aplicativo cliente.

Os ambientes com suporte no momento incluem:

• Visual Studio Code
• Visual Studio

Visual Studio Code

Para configurar o servidor MCP remoto no Visual Studio Code:

1. Adicione um arquivo .vscode/mcp.json ao repositório com a configuração de mcp.json mostrada anteriormente.
2. Salve o arquivo.
3. Abra GitHub Copilot no VS Code.
4. Quando solicitado, autentique-se usando sua conta Microsoft Entra e selecione sua conta.

Após a conclusão da autenticação, uma lista de ferramentas disponíveis será exibida.

Visual Studio (2022 e posterior)

Configure o servidor MCP remoto em Visual Studio adicionando a URL do servidor às configurações do MCP. Para obter mais informações, consulte Use servidores MCP no Visual Studio.

Verificar conexão

Após a instalação, verifique se o servidor MCP remoto está funcionando fazendo uma pergunta ao assistente de IA sobre seus dados de Azure DevOps.

Exemplos:

• "Liste os projetos na minha organização Azure DevOps."
• "Mostrar meus itens de trabalho atribuídos."
• "Quais solicitações de pull exigem minha revisão?"

Se o assistente de IA retornar resultados de sua organização Azure DevOps, o servidor MCP remoto será configurado corretamente.

Solução de problemas

Para obter suporte, você pode criar um problema no repositório do SERVIDOR MCP local . Use o modelo de problema Remoto.

perguntas frequentes

E quanto a outros clientes como GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX ou Cursor?

Ferramentas de cliente adicionais, como CodeX, Claude Desktop, Claude Code e ChatGPT, exigem o registro dinâmico de uma ID do cliente OAuth no Entra antes que possam ser usadas com o servidor MCP. Estamos trabalhando em estreita colaboração com a equipe do Entra para habilitar essa funcionalidade. Por enquanto, há suporte apenas para Visual Studio e Visual Studio Code.

Quais serviços podem usar Azure DevOps servidor MCP?

O suporte para outros serviços, incluindo Fábrica de IA do Azure, Microsoft 365 Copilot e Copilot Studio, ainda não está disponível, mas será adicionado em breve.

O servidor MCP Azure DevOps dá suporte a AgentId?

O suporte a AgentId estará disponível em breve.

Conteúdo relacionado

• visão geral do servidor MCP Azure DevOps
• Repositório GitHub do Azure DevOps MCP Server