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

Repos

As ferramentas do repositório são consolidadas em despachantes agrupados usando o parâmetro action, seguindo o mesmo padrão das ferramentas wiki. Os nomes de ferramentas individuais anteriores continuam a funcionar como pseudónimos. Use repo_create_branch e repo_search_commits diretamente — estes não foram consolidados.

Humor

As ferramentas de item de trabalho são consolidadas em despachantes agrupados usando um action parâmetro, seguindo o mesmo padrão das ferramentas de repositório e pipeline. Os nomes de ferramentas individuais anteriores continuam a funcionar como pseudónimos. Usar search_workitem diretamente — não foi consolidado.

Tubulações

As ferramentas de pipeline são consolidadas em distribuidores agrupados usando o parâmetro action, seguindo o mesmo padrão das ferramentas wiki e repositório. Os nomes de ferramentas individuais anteriores continuam a funcionar como pseudónimos.

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

Pesquisa

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

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?

Ferramentas de cliente adicionais como CodeX, Claude Desktop, Claude Code e ChatGPT exigem o registo dinâmico de um ID de Cliente OAuth no Entra antes de poderem ser usadas com o servidor MCP. Estamos a trabalhar em estreita colaboração com a equipa da 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