Configurar o servidor MCP do Azure DevOps remoto

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.

Escolha o controle remoto primeiro

Use o servidor MCP remoto quando o ambiente der suporte a ele. O servidor remoto é a opção recomendada porque Azure DevOps os hosts e os atualiza e você não precisa instalar Node.js ou gerenciar um processo de servidor local.

Use o servidor MCP local quando o cliente não puder se autenticar no servidor remoto com Microsoft Entra ID. Atualmente, essa limitação se aplica a clientes como Claude Desktop, Claude Code, Cursor e Codex. Para obter instruções de configuração local, consulte Habilitar a assistência de IA com o servidor MCP Azure DevOps.

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.

Especifique os nomes de ferramentas que aparecem na lista de ferramentas disponíveis . Para ferramentas consolidadas como wit_work_item, escolha a operação usando o parâmetro da action ferramenta quando você a chamar.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Tools": "core_list_projects, wit_work_item"
      }
    }
  },
  "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 ferramentas principais estão sempre disponíveis, a menos que anotadas de outra forma.

Trabalho

As ferramentas de trabalho são consolidadas em dispatchers agrupados usando um parâmetro action.

Repos

As ferramentas do repositório são consolidadas em dispatchers agrupados usando um parâmetro action.

Wit

As ferramentas de itens de trabalho são consolidadas em dispatchers agrupados usando um parâmetro action.

Pipelines

As ferramentas do pipeline são consolidadas em dispatchers agrupados usando um parâmetro action.

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

As ferramentas do plano de teste são consolidadas em dispatchers agrupados usando um parâmetro action.

Segurança avançada

As ferramentas de Segurança Avançada são consolidadas em um dispatcher agrupado que usa um action parâmetro.

Enterprise Live Migration (versão prévia)

As ferramentas de Migração Dinâmica da Empresa usam um action parâmetro para agrupar e expedir tarefas. Saiba mais sobre a versão prévia da Migração Ao Vivo Da Empresa.

As ferramentas de Migração Dinâmica da Empresa são desabilitadas por padrão. Como o suporte do ELM no servidor MCP remoto está em versão prévia, eles exigem que sua organização tenha acesso à visualização pública limitada do ELM. Para habilitar as ferramentas elm, use o X-MCP-Toolsets cabeçalho com o elm valor:

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

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 Microsoft Entra por padrão. Alguns ambientes exigem etapas extras para registrar o aplicativo cliente.

Os ambientes com suporte para o ponto de extremidade remoto, quando Microsoft Entra autenticação estiver disponível, incluem:

• Visual Studio com GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• CLI do GitHub Copilot
• aplicativo GitHub Copilot

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.

Usar a IA para validar e solucionar problemas de configuração remota do MCP

Os prompts de exemplo a seguir para o Copilot Chat ajudam você a escolher a abordagem de MCP correta, configurar e validar a configuração remota, melhorar os prompts de uso diário e resolver falhas quando necessário. Copie e cole estes prompts no Copilot Chat e substitua os marcadores pelos dados reais da sua organização, do cliente e dos erros.

Copilot é alimentado pela IA, portanto, surpresas e erros são possíveis. Para mais informações, consulte as perguntas frequentes sobre o uso geral do Copilot.

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 Claude Desktop, Claude Code, Codex ou Cursor?

Claude Desktop, Claude Code, Codex e Cursor exigem o registro dinâmico de uma ID do cliente OAuth em Microsoft Entra ID antes que eles possam usar o servidor MCP remoto. Microsoft Entra ID atualmente não dá suporte ao fluxo de registro de cliente dinâmico que esses clientes exigem. Use o servidor MCP local com esses clientes.

Conteúdo relacionado

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