Frequently Asked Questions (FAQ) about Azure DevOps MCP (ADO-MCP-Server)

Q: What is the Azure DevOps MCP (ADO-MCP-Server)? A: The Azure DevOps MCP (ADO-MCP-Server) is a Model Context Protocol server that integrates Azure DevOps services with Cline, allowing users to interact with Azure DevOps through natural language commands and automate various development tasks.

Q: What are the prerequisites for installing the ADO-MCP-Server? A: The prerequisites include Node.js (v20 LTS or higher), npm, a Cline installation, and an Azure DevOps account with access tokens.

Q: How do I install the ADO-MCP-Server? A: You can install it either automatically via Smithery using the command npx -y @smithery/cli install @cakriwut/ado-mcp-server --client claude or manually by cloning the repository, installing dependencies, and building the server.

Q: How do I configure the ADO-MCP-Server? A: Configuration involves obtaining an Azure DevOps Personal Access Token (PAT) and updating the MCP settings file (either in Roo Code or the Cline Desktop App) with the necessary credentials and project details.

Q: What is a Personal Access Token (PAT) and how do I get one? A: A Personal Access Token (PAT) is a secure way to authenticate with Azure DevOps. You can generate one by going to Azure DevOps, clicking on your profile picture, selecting “Security,” and creating a new token with the required scopes (Code, Work Items, Build, Wiki, Project and Team).

Q: Where is the MCP settings file located? A: For Roo Code (VSCode extension), the file is located at %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json. For Cline Desktop App, it’s at %LOCALAPPDATA%/Claude/claude_desktop_config.json.

Q: What tools are available in the ADO-MCP-Server? A: The server offers tools for managing work items, boards, pipelines, pull requests, wikis, and projects in Azure DevOps.

Q: Can I interact with Azure DevOps directly from the terminal? A: Yes, the ADO-MCP-Server includes a command-line interface (CLI) that allows you to interact with Azure DevOps directly from the terminal.

Q: How do I verify that the ADO-MCP-Server is installed correctly? A: Restart Cline (or VSCode), and the Azure DevOps MCP server should be listed in Cline’s capabilities. You can also use the MCP Inspector (npm run inspector) to verify the installation.

Q: What should I do if the server isn’t connecting? A: Check that the path in your MCP settings is correct, verify your Azure DevOps credentials, and check the Cline logs for any error messages.

Q: What should I do if I get authentication errors? A: Verify that your PAT hasn’t expired, ensure the PAT has all necessary scopes, and double-check the organization and project names.

Q: How can I contribute to the development of the ADO-MCP-Server? A: You can modify or extend the server by making changes in the src directory, running npm run watch for development, building with npm run build, and testing using the inspector (npm run inspector).

Q: What is UBOS and how does it enhance the ADO-MCP-Server? A: UBOS is a full-stack AI Agent Development Platform that allows businesses to orchestrate AI Agents, connect them with enterprise data, build custom AI Agents with their LLM models, and create Multi-Agent Systems. Integrating the ADO-MCP-Server with UBOS enables AI Agents to automate complex tasks within Azure DevOps and provide intelligent insights.

Q: Where can I find more detailed CLI usage examples? A: See docs/wiki-cli-usage.md and docs/command-list.md for more detailed CLI usage examples.