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 o Azure DevOps o hospeda e o atualiza, e você não precisa instalar o Node.js nem 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 e Codex. O Cursor e o Claude Code exigem um registro de aplicativo Microsoft Entra personalizado para autenticação. 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 action da ferramenta ao chamá-la.

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

Para tornar disponíveis apenas as ferramentas de Migração ao Vivo Enterprise, 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 compatíveis com o endpoint remoto, quando a autenticação do Microsoft Entra está disponível, incluem:

• Visual Studio com GitHub Copilot
• Visual Studio
• Microsoft Foundry
• Microsoft Copilot Studio
• CLI do GitHub Copilot
• aplicativo GitHub Copilot
• aplicativo Cursor para desktop, agentes de nuvem do Cursor ou Claude Code com um registro de aplicativo personalizado do Microsoft Entra

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.

Escolher escopos OAuth para clientes personalizados

Ao registrar um cliente MCP personalizado, conceda apenas as permissões delegadas necessárias para as operações de Azure DevOps que o cliente executa. Os escopos do OAuth determinam quais Azure DevOps recursos e operações que o cliente pode acessar. Habilitar uma ferramenta mcp ou conjunto de ferramentas não concede permissões adicionais.

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

• Conceda escopos de leitura quando o cliente usar somente ferramentas MCP somente de leitura.
• Conceda escopos de escrita ou de gerenciamento somente quando o cliente precisar das operações de escrita correspondentes.
• Examine os escopos herdados para evitar a concessão de permissões redundantes.

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

Os escopos OAuth não substituem as permissões do usuário conectado. Uma operação MCP só é bem-sucedida quando o escopo do aplicativo e as permissões de Azure DevOps do usuário permitem isso.

Cursor

O Cursor requer um registro de aplicativo personalizado do Microsoft Entra para acessar o servidor MCP remoto do Azure DevOps.

Registrar o aplicativo para a área de trabalho do Cursor

1. Confirme se o Azure DevOps aplicativo empresarial MCP está provisionado em seu locatário. Se você não conseguir encontrá-lo, consulte Não é possível localizar o aplicativo empresarial mcp Azure DevOps no locatário.
2. No centro de administração do Microsoft Entra, vá para Registros de aplicativo e crie um registro de aplicativo.
3. No registro do aplicativo, selecione Autenticação (Prévia)>Adicionar URI de redirecionamento>Aplicativos móveis e de desktop.
4. Insira http://localhost:8787/callback como o URI de redirecionamento e salve as alterações.
5. Na página Autenticação (Versão Prévia), selecione a guia Configurações e habilite Permitir fluxos de cliente públicos.
6. Na página Permissões de API, selecione Adicionar uma permissão>APIs que minha organização usa.
7. Pesquise Azure DevOps MCP ou a ID 2a72489c-aab2-4b65-b93a-a91edccf33b8do aplicativo e selecione o aplicativo.
8. Selecione as permissões delegadas necessárias ao cliente, seguindo as diretrizes de escopo do OAuth e, em seguida, selecione Adicionar permissões.
9. Selecione Conceder consentimento do administrador. Dependendo de sua função, um administrador de locatários pode precisar concluir esta etapa.

Copie a ID do aplicativo (cliente) do registro do aplicativo. Você precisa desse valor para configurar o Cursor.

Configurar a área de trabalho do Cursor

1. No Cursor, abra Configurações>Ferramentas & MCP.

2. Selecione Novo Servidor MCP.

3. Adicione a seguinte configuração, substituindo {client-id} pela ID do aplicativo (cliente) copiada:

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

4. Salve a configuração e retorne às Ferramentas de Configurações>&MCP.

5. Localize o servidor ado e selecione Autenticar.

Configurar agentes do Cursor Cloud

Os Agentes de Nuvem do Cursor exigem um URI de redirecionamento da Web e um segredo do cliente, além do registro personalizado do aplicativo Microsoft Entra.

1. No centro de administração do Microsoft Entra, abra o registro de aplicativo que você criou para o Cursor.

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

3. Insira https://www.cursor.com/agents/mcp/oauth/callback como o URI de redirecionamento e salve as alterações.

4. Selecione Certificados e segredos>Segredos do cliente>Novo segredo do cliente.

5. Insira uma descrição, selecione um período de expiração e, em seguida, selecione Adicionar.

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

7. No Cursor, abra a configuração do servidor MCP dos Agentes de Nuvem e adicione ou edite o servidor MCP personalizado.

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

9. Insira a ID do aplicativo (cliente) do registro do aplicativo na ID do Cliente e o valor do segredo do cliente no Segredo do Cliente.

   Como alternativa, edite a configuração JSON e substitua os placeholders pelos valores de registro do seu aplicativo:

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

10. Salve a configuração e selecione Entrar em Cursor Cloud Agents para concluir a autenticação do Microsoft Entra.

Se o Microsoft Entra retornar o erro AADSTS50011, verifique se o URI de redirecionamento da web corresponde exatamente a https://www.cursor.com/agents/mcp/oauth/callback. Se a troca de tokens falhar com o erro AADSTS7000218, verifique se o valor do segredo do cliente atual está configurado nos Agentes de Nuvem do Cursor.

Código Claude

O Claude Code requer um registro de aplicativo Microsoft Entra personalizado para acessar o servidor MCP do Azure DevOps remoto.

Registrar o aplicativo

1. Confirme se o Azure DevOps aplicativo empresarial MCP está provisionado em seu locatário. Se você não conseguir encontrá-lo, consulte Não é possível localizar o aplicativo empresarial mcp Azure DevOps no locatário.
2. No centro de administração do Microsoft Entra, vá para Registros de aplicativo e crie um registro de aplicativo.
3. No registro do aplicativo, selecione Autenticação (Prévia)>Adicionar URI de redirecionamento>Aplicativos móveis e de desktop.
4. Insira http://localhost:3118/callback como o URI de redirecionamento e salve as alterações.
5. Na página Autenticação (Versão Prévia), selecione a guia Configurações e habilite Permitir fluxos de cliente públicos.
6. Na página Permissões de API, selecione Adicionar uma permissão>APIs que minha organização usa.
7. Pesquise Azure DevOps MCP ou a ID 2a72489c-aab2-4b65-b93a-a91edccf33b8do aplicativo e selecione o aplicativo.
8. Selecione as permissões delegadas necessárias ao cliente, seguindo as diretrizes de escopo do OAuth e, em seguida, selecione Adicionar permissões.
9. Selecione Conceder consentimento do administrador. Dependendo de sua função, um administrador de locatários pode precisar concluir esta etapa.

Copie a ID do aplicativo (cliente) do registro do aplicativo. Você precisa desse valor para configurar o Claude Code.

Configurar o Código Claude

1. Execute o seguinte comando, substituindo {client-id} pela ID do aplicativo (cliente) copiada e {organization} pelo nome da organização Azure DevOps:

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

   Como alternativa, crie um .mcp.json arquivo na raiz do 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 siga o fluxo de entrada no navegador para autenticar com sua conta Microsoft Entra.

Para obter mais informações sobre essas opções, consulte Conectar o Claude Code às ferramentas por meio do MCP.

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 ou Codex?

Claude Desktop e Codex 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 dinâmico do cliente 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