Configurar o servidor remoto Azure DevOps MCP Server

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.

Escolha primeiro o remoto.

Usa o servidor MCP remoto quando o teu ambiente o permite. O servidor remoto é a opção recomendada porque Azure DevOps aloja e atualiza, e não precisas de instalar Node.js nem gerir um processo de servidor local.

Usa o servidor MCP local quando o teu cliente não conseguir autenticar-se ao servidor remoto com o Microsoft Entra ID. Esta limitação aplica-se atualmente a clientes como Claude Desktop e Codex. O Cursor e o Claude Code requerem um registo personalizado na aplicação Microsoft Entra para autenticação. Para instruções de configuração local, consulte Habilitar assistência de IA com o Azure DevOps MCP Server.

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.

Especifique os nomes das ferramentas que apareçam na lista de ferramentas disponíveis . Para ferramentas consolidadas, como wit_work_item, escolha a operação utilizando o parâmetro action da ferramenta quando 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": []
}

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, salvo indicação em contrário.

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.

Segurança Avançada

As ferramentas de Segurança Avançada estão consolidadas num dispatcher de grupo que utiliza 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.

Para disponibilizar apenas as ferramentas de Enterprise Live Migration, utilize 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.

Ambientes suportados para o endpoint remoto, quando a autenticação Microsoft Entra está disponível, incluem:

• Visual Studio com GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• GitHub Copilot CLI
• GitHub aplicação Copilot
• Cursor desktop, Cursor Cloud Agents, ou Claude Code com um registo personalizado da aplicação Microsoft Entra

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.

Escolha âmbitos do OAuth para clientes personalizados

Quando regista um cliente MCP personalizado, conceda apenas as permissões delegadas necessárias para as operações Azure DevOps que o cliente realiza. Os escopos OAuth determinam quais os recursos e operações do Azure DevOps a que o cliente pode acedecer. Ativar uma ferramenta ou conjunto de ferramentas MCP não concede permissões adicionais.

Siga o princípio do privilégio mínimo:

• Grant lê os escopos quando o cliente utiliza apenas ferramentas MCP de leitura.
• Conceda permissões de escrita ou de gestão apenas quando o cliente precisar das respetivas operações de escrita.
• Revise os escopos herdados para evitar conceder permissões redundantes.

Para os âmbitos disponíveis e as suas relações, consulte âmbitos do OAuth.

Os âmbitos do OAuth não substituem as permissões do utilizador com sessão iniciada. Uma operação MCP só tem sucesso quando tanto o âmbito da aplicação como as permissões Azure DevOps do utilizador o permitem.

Cursor

O Cursor requer um registo personalizado da aplicação Microsoft Entra para aceder ao servidor remoto Azure DevOps MCP.

Registe a aplicação para o ambiente de trabalho Cursor

1. Confirme que a aplicação empresarial Azure DevOps MCP está provisionada no seu tenant. Se não conseguir encontrar, veja Não é possível encontrar a aplicação empresarial Azure DevOps MCP no tenant.
2. No centro de administração Microsoft Entra, vá a Registos de aplicações e depois crie um registo de app.
3. No registo da aplicação, selecione Autenticação (Pré-visualização)>Adicionar redirecionamento URI>Aplicações móveis e desktop.
4. Introduza http://localhost:8787/callback como URI de redirecionamento e depois guarde as suas alterações.
5. Na página de Autenticação (Pré-visualização ), selecione o separador Definições e depois ative Permitir fluxos públicos do cliente.
6. Na página de permissões da API , selecione Adicionar uma permissão>APIs que a minha organização utiliza.
7. Procure por Azure DevOps MCP ou o ID 2a72489c-aab2-4b65-b93a-a91edccf33b8da aplicação, e depois selecione a aplicação.
8. Selecione as permissões delegadas que o seu cliente necessita, seguindo as orientações do âmbito OAuth, e depois selecione Adicionar permissões.
9. Selecione Conceder consentimento de administrador. Dependendo do seu papel, um administrador de inquilinos pode ter de completar este passo.

Copie o ID da Aplicação (cliente) do registo da aplicação. Precisas deste valor para configurar o Cursor.

Configurar a aplicação Cursor para computador

1. No Cursor, abre as Ferramentas de Definições>e o MCP.

2. Selecione o Novo Servidor MCP.

3. Adicione a seguinte configuração, substituindo {client-id} pelo ID da aplicação (cliente) que copiou:

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}"
         }
       }
     }
   }
   

4. Guarda a configuração e, em seguida, regressa a Definições>Ferramentas e MCP.

5. Localiza o servidor ado e depois seleciona Autenticar.

Configurar Agentes da Nuvem de Cursor

Os Agentes Cloud Cursor requerem um URI de redirecionamento web e um segredo do cliente, além do registo personalizado da aplicação Microsoft Entra.

1. No centro de administração do centro de administração Microsoft Entra, abra o registo da aplicação que criou para o Cursor.

2. Selecione Autenticação (Pré-visualização)>Adicionar redirecionamento URI>Web.

3. Introduza https://www.cursor.com/agents/mcp/oauth/callback como URI de redirecionamento e depois guarde as suas alterações.

4. Selecione Certificados & SegredosSegredos do clienteNovo segredo do cliente.

5. Introduza uma descrição, selecione um período de validade e depois selecione Adicionar.

6. Copie o valor secreto do cliente. O valor aparece apenas uma vez.

7. No Cursor, abre a configuração do servidor MCP dos Cloud Agents e depois adiciona ou edita o servidor MCP personalizado.

8. Defina a URL do servidor para https://mcp.dev.azure.com.

9. Introduza o ID da aplicação (cliente) a partir do registo da sua aplicação no ID do Cliente e o valor do cliente secreto no Cliente Secreto.

   Alternativamente, edite a configuração JSON e substitua os marcadores de posição pelos valores de registo da sua aplicação:

   {
     "mcpServers": {
       "ado": {
         "url": "https://mcp.dev.azure.com",
         "type": "http",
         "auth": {
           "CLIENT_ID": "{client-id}",
           "CLIENT_SECRET": "{client-secret}"
         }
       }
     }
   }
   

10. Guarde a configuração e depois selecione Iniciar sessão a partir dos Agentes da Nuvem Cursor para completar a autenticação Microsoft Entra.

Se o Microsoft Entra devolver o erro AADSTS50011, verifique se o URI de redirecionamento Web corresponde exatamente a https://www.cursor.com/agents/mcp/oauth/callback. Se a troca de token falhar com o erro AADSTS7000218, verifique se o valor atual do segredo do cliente está configurado nos agentes do Cursor Cloud.

Código Claude

O Claude Code requer um registo personalizado da aplicação Microsoft Entra para aceder ao servidor remoto Azure DevOps MCP.

Registar a candidatura

1. Confirme que a aplicação empresarial Azure DevOps MCP está provisionada no seu tenant. Se não conseguir encontrar, veja Não é possível encontrar a aplicação empresarial Azure DevOps MCP no tenant.
2. No centro de administração Microsoft Entra, vá a Registos de aplicações e depois crie um registo de app.
3. No registo da aplicação, selecione Autenticação (Pré-visualização)>Adicionar redirecionamento URI>Aplicações móveis e desktop.
4. Introduza http://localhost:3118/callback como URI de redirecionamento e depois guarde as suas alterações.
5. Na página de Autenticação (Pré-visualização ), selecione o separador Definições e depois ative Permitir fluxos públicos do cliente.
6. Na página de permissões da API , selecione Adicionar uma permissão>APIs que a minha organização utiliza.
7. Procure por Azure DevOps MCP ou o ID 2a72489c-aab2-4b65-b93a-a91edccf33b8da aplicação, e depois selecione a aplicação.
8. Selecione as permissões delegadas que o seu cliente necessita, seguindo as orientações do âmbito OAuth, e depois selecione Adicionar permissões.
9. Selecione Conceder consentimento de administrador. Dependendo do seu papel, um administrador de inquilinos pode ter de completar este passo.

Copie o ID da Aplicação (cliente) do registo da aplicação. Precisas deste valor para configurar o Claude Code.

Configurar o Código Claude

1. Execute o seguinte comando, substituindo {client-id} pelo ID da aplicação (cliente) que copiou e {organization} pelo nome da sua organização Azure DevOps:

   claude mcp add --transport http ado https://mcp.dev.azure.com/{organization} \
     --client-id {client-id} --callback-port 3118
   

   Alternativamente, crie um .mcp.json ficheiro na raiz do seu repositório com a seguinte configuração:

   {
     "mcpServers": {
       "ado": {
         "type": "http",
         "url": "https://mcp.dev.azure.com/{organization}",
         "oauth": {
           "clientId": "{client-id}",
           "callbackPort": 3118
         }
       }
     }
   }
   

2. Inicie o Claude Code executando claude.

3. Execute /mcp, e depois siga o fluxo de login do navegador para autenticar com a sua conta Microsoft Entra.

Para mais informações sobre estas opções, consulte Ligar Código Claude a ferramentas via MCP.

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 o Claude Desktop ou o Codex?

Claude Desktop e Codex exigem o registo dinâmico de um ID de cliente OAuth no Microsoft Entra ID antes de poderem usar o servidor MCP remoto. O Microsoft Entra ID atualmente não suporta o fluxo dinâmico de registo de clientes que estes clientes exigem. Use o servidor MCP local com estes clientes.

Conteúdo relacionado

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