Azure DevOps Setup

Guide the user through Azure DevOps integration setup:

Step 1: Create a Personal Access Token (PAT)

Direct the user to create a PAT at: https://dev.azure.com/_usersettings/tokens

The PAT should have these scopes based on what they want to use:

• Work Items: Read & Write (for work item management)
• Code: Read & Write (for repository operations)
• Build: Read & Execute (for pipeline operations)
• Wiki: Read & Write (for wiki operations)
• Project and Team: Read (for project listing)

Step 2: Set Environment Variables

The user needs to set the ADO_ORGANIZATION environment variable:

Windows (PowerShell - session):

$env:ADO_ORGANIZATION = "your_organization_name"

Windows (PowerShell - persistent):

[System.Environment]::SetEnvironmentVariable("ADO_ORGANIZATION", "your_organization_name", "User")

macOS/Linux:

export ADO_ORGANIZATION="your_organization_name"
# Add to ~/.bashrc or ~/.zshrc for persistence

Step 3: Verify Connection

After setting up, use /mcp to verify the azure-devops server is connected.

Then try a simple query like "List my Azure DevOps projects" to confirm everything works.

Troubleshooting

If the MCP server fails to connect:

1. Verify Node.js 20+ is installed: node --version
2. Check the organization name is correct
3. Ensure you're logged into Azure DevOps CLI: az devops login
4. Try running manually: npx -y @azure-devops/mcp YOUR_ORG