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

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

Repos

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

Wit

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

Pipelines

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

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 despachadores agrupados por meio de um parâmetro action.

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. Para habilitá-los, use o cabeçalho X-MCP-Toolsets com o valor elm:

{
  "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 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.

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 . Certifique-se de usar o modelo de problema remoto .

perguntas frequentes

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

Outras ferramentas de cliente, como CodeX, Claude Desktop, Claude Code e ChatGPT, exigem o registro dinâmico de uma ID do cliente OAuth em Microsoft Entra antes que possam ser usadas com o servidor MCP. Estamos trabalhando em estreita colaboração com a equipe de Microsoft 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