Configurare il server MCP Azure DevOps remoto (anteprima)

Servizi di Azure DevOps

Il server MCP Azure DevOps remoto è una versione ospitata del Azure DevOps Server MCP che non richiede un'installazione locale. Invece di eseguire il server nel computer, è possibile connettere l'assistente di intelligenza artificiale direttamente all'endpoint Azure DevOps ospitato usando il trasporto HTTP streamable.

Il server remoto offre le stesse funzionalità del server locale, tra cui l'accesso a elementi di lavoro, richieste pull, pipeline e altro ancora, eliminando la complessità della configurazione locale.

Server MCP remoto e locale

Prerequisiti

configurazione di mcp.json

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

È anche possibile omettere il nome dell'organizzazione dall'URL. Tuttavia, se si omette il nome dell'organizzazione, è necessario specificarlo come contesto in ogni chiamata allo strumento.

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

Set di strumenti

Specificare i set di strumenti per limitare gli strumenti disponibili per il server MCP. Non deve essere combinato con X-MCP-Tools.

{
  "servers": {
    "ado-remote-mcp": {
      "url": "https://mcp.dev.azure.com/{organization}",
      "type": "http",
      "headers": {
        "X-MCP-Toolsets": "repos,wiki,wit"
      }
    }
  },
  "inputs": []
}

Strumenti di sola lettura

Usare l'intestazione X-MCP-Readonly per limitare il server alle operazioni di sola lettura. Questa restrizione è utile quando si desidera impedire modifiche alle risorse Azure DevOps.

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

Combinare strumentazione e filtraggio in modalità sola lettura

{
  "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": []
}

Singoli strumenti

Usare l'intestazione X-MCP-Tools per abilitare solo strumenti specifici. Non deve essere combinato con 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": []
}

Membri del programma Insider

Durante l'esperimento e l'introduzione di nuovi strumenti e aggiornamenti a quelli esistenti, è possibile ottenere l'accesso anticipato a queste modifiche usando l'intestazione X-MCP-Insiders .

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

Strumenti disponibili

Strumenti di base

Gli strumenti di base sono sempre disponibili.

Lavoro

Repos

Gli strumenti del repository vengono consolidati in dispatcher raggruppati usando un action parametro, seguendo lo stesso modello degli strumenti wiki. I nomi dei singoli strumenti precedenti continuano a funzionare come alias. Usa repo_create_branch e repo_search_commits direttamente; non sono stati consolidati.

Arguzia

Gli strumenti degli elementi di lavoro vengono consolidati in dispatcher organizzati in gruppi utilizzando un action parametro, seguendo lo stesso schema degli strumenti del repository e della pipeline. I nomi dei singoli strumenti precedenti continuano a funzionare come alias. Usare search_workitem direttamente : non è stato consolidato.

Pipeline

Gli strumenti della pipeline vengono consolidati in dispatcher raggruppati usando un parametro action, seguendo lo stesso schema degli strumenti wiki e repo. I nomi dei singoli strumenti precedenti continuano a funzionare come alias.

Wiki

Le operazioni di lettura wiki vengono consolidate in un unico wiki strumento. Usare il action parametro per selezionare l'operazione.

Piani di test

Ricerca

Ambienti supportati

Il server MCP Azure DevOps remoto richiede il tuo account utente e la tua organizzazione Azure DevOps per connettersi a Microsoft Entra ID.

Non tutti i client MCP supportano l'autenticazione Entra per impostazione predefinita. Alcuni ambienti richiedono passaggi aggiuntivi per registrare l'applicazione client.

Gli ambienti attualmente supportati includono:

• Visual Studio Code
• Visual Studio

Visual Studio Code

Per configurare il server MCP remoto in Visual Studio Code:

1. Aggiungi un .vscode/mcp.json file al repository con la configurazione mcp.json illustrata in precedenza.
2. Salva il file.
3. Apri GitHub Copilot in VS Code.
4. Quando richiesto, effettuare l'autenticazione utilizzando l'account Microsoft Entra e selezionare l'account.

Al termine dell'autenticazione, viene visualizzato un elenco degli strumenti disponibili.

Visual Studio (2022 e versioni successive)

Configurare il server MCP remoto in Visual Studio aggiungendo l'URL del server alle impostazioni mcp. Per altre informazioni, vedere Use MCP servers in Visual Studio.

Verificare la connessione

Dopo l'installazione, verificare che il server MCP remoto funzioni ponendo all'assistente di intelligenza artificiale una domanda sui dati Azure DevOps.

Esempi:

• "Elencare i progetti nell'organizzazione Azure DevOps."
• "Mostra gli elementi di lavoro assegnati".
• Quali pull request richiedono la mia revisione?

Se l'assistente per intelligenza artificiale restituisce i risultati dell'organizzazione Azure DevOps, il server MCP remoto è configurato correttamente.

Risoluzione dei problemi

Per il supporto, è possibile creare un problema nel repository del server MCP locale . Assicurarsi di usare il modello di segnalazione remoto.

Domande frequenti

E riguardo ad altri client come GitHub Copilot CLI, Claude Desktop, Claude Code, CodeX o Cursor?

Altri strumenti client, ad esempio CodeX, Claude Desktop, Claude Code e ChatGPT, richiedono la registrazione dinamica di un ID client OAuth in Entra prima di poterli usare con il server MCP. Stiamo lavorando a stretto contatto con il team entra per abilitare questa funzionalità. Per il momento sono supportati solo Visual Studio e Visual Studio Code.

Quali servizi possono usare Azure DevOps server MCP?

Il supporto per altri servizi, tra cui Azure AI Foundry, Microsoft 365 Copilot e Copilot Studio, non è ancora disponibile, ma verrà aggiunto a breve.

Il server MCP Azure DevOps supporta AgentId?

Il supporto di AgentId sarà presto disponibile.

Contenuti correlati

• La panoramica di Azure DevOps MCP Server
• repository GitHub del server MCP di Azure DevOps