Azure DevOps Integration
Manage Azure DevOps projects, repositories, pull requests, builds, and work items
The Azure DevOps integration provides access to manage Azure DevOps projects, repositories, pull requests, builds, and work items through the Integrate MCP server.
Installation
The Azure DevOps integration is included with the SDK:
import { azureDevopsIntegration } from "integrate-sdk/server";Setup
1. Create an Azure DevOps OAuth App
- Create an OAuth application for Azure DevOps
- Configure your redirect URI
- Note your Client ID and Client Secret
2. Configure the Integration on Your Server
Add the Azure DevOps integration to your server configuration. The integration automatically reads AZURE_DEVOPS_CLIENT_ID and AZURE_DEVOPS_CLIENT_SECRET from your environment variables:
import { createMCPServer, azureDevopsIntegration } from "integrate-sdk/server";
export const { client: serverClient } = createMCPServer({
apiKey: process.env.INTEGRATE_API_KEY,
integrations: [
azureDevopsIntegration({
scopes: ["vso.profile", "vso.project", "vso.code_write", "vso.build", "vso.work_write"], // Optional
}),
],
});You can override the environment variables by passing explicit values:
azureDevopsIntegration({
clientId: process.env.CUSTOM_AZURE_DEVOPS_ID,
clientSecret: process.env.CUSTOM_AZURE_DEVOPS_SECRET,
scopes: ["vso.profile", "vso.project", "vso.code_write", "vso.build", "vso.work_write"], // Optional
});3. Client-Side Usage
The default client automatically includes all integrations. You can use it directly:
import { client } from "integrate-sdk";
await client.authorize("azure_devops");
const result = await client.azure_devops.listProjects({});
console.log(result);If you're using a custom client, add the integration to the integrations array:
import { createMCPClient, azureDevopsIntegration } from "integrate-sdk";
const customClient = createMCPClient({
integrations: [azureDevopsIntegration()],
});Configuration Options
Prop
Type
Default Scopes
These defaults are applied unless you override scopes in the integration config:
vso.profilevso.projectvso.code_writevso.buildvso.work_write
Tools
azure_devops_list_projects
Devops list projects
Prop
Type
azure_devops_list_repositories
Devops list repositories
Prop
Type
azure_devops_list_pull_requests
Devops list pull requests
Prop
Type
azure_devops_list_builds
Devops list builds
Prop
Type
azure_devops_queue_build
Devops queue build
Prop
Type
azure_devops_get_work_item
Devops get work item
Prop
Type
Notes
- Category: Engineering
- Authentication mode: OAuth