Skip to main content

Setting up Azure DevOps MCP server for Katalon AI Assistant

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

requirements

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.
button to create a new personal access token in azure devops
  1. Click + New Token.
  2. 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
create a new access token for azure devops
  1. Click Create

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

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

ParameterDescription
--port 3000Server port (customize as needed)
--host 127.0.0.1Server host (localhost)
--statelessEnable 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:

katalon studio adding a azure devops mcp server to studioassist

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

azure devops mcp server tool list

Troubleshoot​

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

Was this page helpful?