# Azure DevOps On-Premises

Azure DevOps On-Premises bridges local TFS instances and private DevOps servers with AI coding assistants. Helps inspect repositories, review changes, and manage tasks behind corporate firewalls.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: zwitbaum
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zwitbaum/mcp-devops-on-prem
- Updated: 2026-09-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/azure-devops-on-premises

## What it does

This bridge connects AI assistants directly to self-hosted DevOps environments. Because the official Microsoft tooling targets only cloud services, private deployments require a dedicated integration. The server lets agents inspect repository diffs and update wiki pages directly.

A major capability is native NTLM authentication using Windows domain credentials. This is essential for setups running over VPN where token authentication is disabled. Personal access tokens and OAuth bearer tokens can also be used when allowed by policy.

Running the server requires Python 3.10 or higher together with `uv`. Connection attempts will fail if `DEVOPS_API_URL` does not specify the complete path to the organization and project.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `DEVOPS_API_URL`, `DEVOPS_USERNAME`, `DEVOPS_PASSWORD`, `DEVOPS_PAT`, `DEVOPS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Azure DevOps

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DEVOPS_API_URL=<DEVOPS_API_URL> --env DEVOPS_USERNAME=<DEVOPS_USERNAME> --env DEVOPS_PASSWORD=<DEVOPS_PASSWORD> --env DEVOPS_PAT=<DEVOPS_PAT> --env DEVOPS_TOKEN=<DEVOPS_TOKEN> --transport stdio azure-devops-on-premises -- uvx mcp-devops-onpremise
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-devops-onpremise <command>

### Codex

**Platform CLI**
```bash
codex mcp add azure-devops-on-premises --env DEVOPS_API_URL=<DEVOPS_API_URL> --env DEVOPS_USERNAME=<DEVOPS_USERNAME> --env DEVOPS_PASSWORD=<DEVOPS_PASSWORD> --env DEVOPS_PAT=<DEVOPS_PAT> --env DEVOPS_TOKEN=<DEVOPS_TOKEN> -- uvx mcp-devops-onpremise
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-devops-onpremise <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "azure-devops-on-premises": {
            "command": "uvx",
            "args": [
                "mcp-devops-onpremise"
            ],
            "env": {
                "DEVOPS_API_URL": "<DEVOPS_API_URL>",
                "DEVOPS_USERNAME": "<DEVOPS_USERNAME>",
                "DEVOPS_PASSWORD": "<DEVOPS_PASSWORD>",
                "DEVOPS_PAT": "<DEVOPS_PAT>",
                "DEVOPS_TOKEN": "<DEVOPS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-devops-onpremise <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "azure-devops-on-premises": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-devops-onpremise"
            ],
            "env": {
                "DEVOPS_API_URL": "<DEVOPS_API_URL>",
                "DEVOPS_USERNAME": "<DEVOPS_USERNAME>",
                "DEVOPS_PASSWORD": "<DEVOPS_PASSWORD>",
                "DEVOPS_PAT": "<DEVOPS_PAT>",
                "DEVOPS_TOKEN": "<DEVOPS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-devops-onpremise <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DEVOPS_API_URL=<DEVOPS_API_URL> -e DEVOPS_USERNAME=<DEVOPS_USERNAME> -e DEVOPS_PASSWORD=<DEVOPS_PASSWORD> -e DEVOPS_PAT=<DEVOPS_PAT> -e DEVOPS_TOKEN=<DEVOPS_TOKEN> azure-devops-on-premises uvx mcp-devops-onpremise
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-devops-onpremise <command>

## When to use it
- inspect repositories and commit diffs on self-hosted instances
- conduct code reviews for pull requests inside private networks
- create and track work items without leaving the terminal
- read and edit internal wiki documentation alongside codebase changes

## Example prompts
- List the active pull requests in our project
- Fetch the documentation page for API deployment from the wiki
- Inspect the latest commit diff and file a work item for detected bugs

## Similar
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2092 repo stars
- [azure-devops](https://affpapa.org/en/nevibecode/skills/markpitt-azure-devops.md) — skill · 191 installs
- [045-planning-azure-devops](https://affpapa.org/en/nevibecode/skills/045-planning-azure-devops.md) — skill · 168 installs
- [azure-devops-pipelines](https://affpapa.org/en/nevibecode/rules/azure-devops-pipelines.md) — rule · ★ 41430 repo stars
- [azure-devops-specialist](https://affpapa.org/en/nevibecode/agents/azure-devops-specialist.md) — subagent · ★ 1357 repo stars
- [azure-repos](https://affpapa.org/en/nevibecode/skills/azure-repos.md) — skill · 300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
