Set up Azure DevOps MCP server

Last updated: August 2026

This document demonstrates how to integrate Azure DevOps MCP server with Katalon AI Assistant.

There are two ways to connect, depending on whether you use Microsoft's hosted server or run one locally:

• Remote server: using a Microsoft work or school account
• Local server: using Personal Access Token and the MCP proxy

Connect to the remote Azure DevOps MCP server

Requirements

• Katalon Studio 11.5.0.

Microsoft hosts an Azure DevOps MCP server that authenticates with Microsoft Entra ID, so no Personal Access Token or MCP proxy is needed.

1. In Katalon AI Assistant settings, add an MCP server with the transport type HTTP and this server URL, replacing {organization} with your Azure DevOps organization name: https://mcp.dev.azure.com/{organization}.
2. In the connection dialog, input required fields and select This server uses Microsoft Entra ID.
3. Click OK to save the server.
4. An Authorization required dialog opens. Cick Authorize and choose the account you use for Azure DevOps.
5. Once completed, the list of connected tools updates accordingly.

The server reconnects on its own the next time you open Katalon Studio. For more on how these servers behave, see Servers protected by Microsoft Entra ID.

Connect to a local Azure DevOps MCP server

Use this method if you run the Azure DevOps MCP server yourself.

requirements

• MCP proxy installed. See Setup MCP proxy for STDIO MCP servers for more details.

Create and setup a Personal Access Token (PAT)

Before you integrate with the Azure DevOps MCP server, you need a Personal Access Token (PAT) to authenticate with Azure DevOps. Follow these steps:

1. Go to Azure DevOps: <https://dev.azure.com/{YourOrganization}>
2. Click on User Settings (top right) > Personal Access Tokens.

3. Click + New Token.
4. Configure:
   • Name: Give it a descriptive name (e.g., "MCP Bridge")
   • Organization: Select your organization (e.g., "Katalon")
   • Expiration: Set expiration date
   • Scopes: Select the permissions you need:
     • Work Items: Read & Write
     • Code: Read
     • Build: Read
     • Or select Full Access for all permissions

5. Click Create

6. Copy the token - you won't be able to see it again.

7. Set up the PAT as an environment variable:

   For Windows (PowerShell):

   $env:AZURE_DEVOPS_PAT = "your-pat-token-here"

   For Windows (CMD):

   set AZURE_DEVOPS_PAT=your-pat-token-here

   For macOS/Linux:

   export AZURE_DEVOPS_PAT="your-pat-token-here"

   For macOS/Linux (Permanent setup):

   Add to your ~/.zshrc or ~/.bashrc:

   echo 'export AZURE_DEVOPS_PAT="your-pat-token-here"' >> ~/.zshrc source ~/.zshrc

Host and integrate with Azure DevOps MCP server

In your terminal, run:

mcp-proxy --port 3000 --host 127.0.0.1 --stateless --allow-origin '*' -- npx -y @azure-devops/mcp "katalon"

Replace "Katalon" with your Azure DevOps organization name.

Parameter	Description
--port 3000	Server port (customize as needed)
--host 127.0.0.1	Server host (localhost)
--stateless	Enable stateless mode
--allow-origin '*'	Allow all CORS origins (use specific origin in production)
"Katalon"	Your Azure DevOps organization name

The server will run locally at: http://127.0.0.1:3000/mcp. Add it to Katalon AI Assistant:

You can see the tool list in the added MCP server for Azure DevOps:

Troubleshoot

If you encounter CORS errors, double-check to make sure --allow-origin "*" is in the command