Configurar o servidor remoto Azure DevOps MCP (pré-visualização)

Azure DevOps Serviços

O servidor remoto Azure DevOps MCP é uma versão alojada do Azure DevOps MCP Server que não requer instalação local. Em vez de correr o servidor na sua máquina, liga o seu assistente de IA diretamente ao endpoint hospedado no Azure DevOps, usando transporte HTTP streamable.

O servidor remoto oferece as mesmas capacidades que o servidor local, incluindo acesso a itens de trabalho, pull requests, pipelines e mais, eliminando a complexidade da configuração local.

Servidor MCP remoto vs. local

Pré-requisitos

configuração mcp.json

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

Também pode omitir o nome da organização na URL. No entanto, se omitir o nome da organização, deve 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 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 de apenas leitura

Use o X-MCP-Readonly cabeçalho para restringir o servidor a operações apenas de leitura. Esta restrição é útil quando se quer evitar modificações nos recursos do 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 de somente 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 ativar 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": []
}

Insiders

À medida que experimentamos e introduzimos novas ferramentas e atualizações para as já existentes, pode obter acesso antecipado a estas 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 essenciais estão sempre disponíveis.

Trabalho

As ferramentas de trabalho são consolidadas em distribuidores agrupados, utilizando o parâmetro action.

Repos

As ferramentas do repositório são consolidadas em encaminhadores agrupados através de um parâmetro action.

Humor

As ferramentas de item de trabalho são consolidadas em despachadores agrupados utilizando um parâmetro action.

Tubulações

As ferramentas do pipeline são consolidadas em encaminhadores agrupados, utilizando o parâmetro action.

Wiki

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

Planos de teste

As ferramentas de plano de teste são consolidadas em processadores agrupados, utilizando um parâmetro action.

Migração em Direto Empresarial (pré-visualização)

As ferramentas de Migração ao Vivo Empresarial usam um action parâmetro para agrupar e despachar tarefas. Saiba mais sobre a pré-visualização da Enterprise Live Migration.

As ferramentas de Migração ao Vivo da Enterprise estão desativadas por defeito. Para os ativar, 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 suportados

O servidor remoto Azure DevOps MCP requer que a sua conta de utilizador e a organização Azure DevOps se liguem ao Microsoft Entra ID.

Nem todos os clientes MCP suportam autenticação Microsoft Entra por defeito. Alguns ambientes exigem passos extra para registar a aplicação cliente.

Os ambientes atualmente suportados incluem:

• Visual Studio Code
• Visual Studio

Visual Studio Code

Para configurar o servidor MCP remoto no Visual Studio Code:

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

Após a autenticação concluída, aparece uma lista das ferramentas disponíveis.

Visual Studio (2022 e posteriores)

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

Verificar a ligação

Após a configuração, verifique se o servidor MCP remoto está a funcionar perguntando ao seu assistente de IA sobre os seus dados do Azure DevOps.

Exemplos:

• "Lista os projetos na minha organização Azure DevOps."
• Mostra os meus itens de trabalho atribuídos.
• "Que pull requests exigem a minha revisão?"

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

Use IA para validar e resolver problemas na configuração remota do MCP

Os seguintes exemplos de prompts para o Copilot Chat ajudam-no a escolher a abordagem MCP certa, configurar e validar a configuração remota, melhorar os comandos de uso diário e resolver falhas quando necessário. Copie e cole estes pedidos no Copilot Chat, e substitua os marcadores de posição pelos detalhes reais da sua organização, do cliente e dos erros.

O Copilot é alimentado por IA, por isso surpresas e erros são possíveis. Para mais informações, consulte Perguntas frequentes sobre o uso geral do Copilot.

Troubleshooting

Para suporte, pode reportar um problema no repositório local do MCP Server. Certifique-se de usar o modelo de problema Remote.

FAQ

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 registo dinâmico de um ID de Cliente OAuth no Microsoft Entra antes de poderem ser usadas com o servidor MCP. Estamos a trabalhar em estreita colaboração com a equipa da Microsoft Entra para possibilitar esta capacidade. Por agora, apenas o Visual Studio e o Visual Studio Code são suportados.

Que serviços podem usar o Azure DevOps MCP Server?

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

O Azure DevOps MCP Server suporta AgentId?

O suporte ao AgentId está a chegar em breve.

Conteúdo relacionado

• Azure DevOps Visão geral do servidor MCP
• repositório GitHub do Servidor MCP do Azure DevOps