mcp-azure-devops

Azure DoDevOps용 Model Context Protocol 서버입니다. MCP를 지원하는 클라이언트(Claude Desktop, Claude Code, Cursor, Codex 등)가 Boards, Repos, Pipelines, 그리고 프로젝트 에 걸쳐 작업할 수 있게 하며, AI 에이전트를 안전한 경계 안에 먼물리도록 하는 거버넌스 계층을 제공합니다.

The offers

• Projects & teams — 프로젝트/팀/구성원 나열, 프로세스 템플릿 검사.

• Boards / work items — WIQL 리, 작업 항목 조회, 작업 항목 생선/수정, 반복(스프린트) 목록.

• Repos / pull requests — 리포지토리와 브랜치 목록, PR 목록·조회, PR 작선.

• Pilines / 빌rd — 리지토리 지.

Related MCP server: Azure DevOps MCP Server

거버넌스 & 보안 모델

| 어떤 프로젝트가 범위에 포함되나요? | AZDO_PROJECT_ALLOWILIST | (전체) | 다른 프로젝트에 대하 작업은 거부됩니다. | | 어떤 프로젝트가 항상 읽기 전용인? | AZDO_PROJECT_PROTECTED_PROTEXT | (없다) | 읽기 가능, 변경 불가. | | 삭제를 허용할까? | AZDO_ALLOW_DELETE | false | delete_project는 이 설정 및 admin 모드가 필요합니다. | | 타입 확인 | AZO_REQUIRE_CONFIRMATION | true | 영향도가 큰 작업에는 boolean이 아닌 확정. confirm이 대상 이름과 일치해야 합니다. | | 미리 보기 | AZOO_DRY_RURN | false | 쓰기/관리 도구가 검하며 의도를 로그로 남긴 후 반환합니다. | | 감사 로그 | AZOO_AUDIT_LOOG | true | Guard되는 항목당 JSON으로 하나의 로그를 stderr로 남깁니다. |

도구

읽기 (read-only+): list_projects, get_project, list_team_members, list_processes, query_work_items, get_work_item, list_iterations, tiger,

쓰기 (read-write+): create_work_item, update_work_item, create_pull_request, run_pipeline

관리자 (admin): create_project, delete_project (AZDO_ALLOW_DELETE 필요 + 타입 확정 confirm)

빠른 시작 — 에이전트에 추가

npm에 @dockndevai/mcp-azure-devops로 게시되어 있습니다. npx로 실행되며 org과 PAT이 필요합니다. 각 클라이언트에 대한 설정은 [docs/CLIENTS.md](docs/CLIENTS.md), 모든 변수는 [.env.example`](.acy)를 참고하세요.

Claude Code

claude mcp add azure-devops -e AZDO_ORG_URL="https://dev.azure.com/your-org" -e AZDO_PAT="your-pat" -e AZDO_MODE="read-only" -- npx -y @dockndevai/mcp-azure-devops

Claude Desktop · Cursor · Windsurf

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["-y", "@dockndevai/mcp-azure-devops"],
      "env": {
        "AZDO_ORG_URL": "https://dev.azure.com/your-org",
        "AZDO_PAT": "your-pat",
        "AZDO_MODE": "read-only"
      }
    }
  }
}

예제 롬프트

• "Payments 프로젝트 api 리포지토리에 활동 중인 풀르스트 look풀스트 목록"

• "나이게 할당된 Artist 중 an Active 상태읜 작업 항목을 조회"

• "Web 프로젝트의 최근 10개의 빌드를 보여 주고 어느 것이 실?không인지 알려 줘"

• "특강 'Checkout 500 on retry' jest로 Payment에 Bug를 생성" (필수 read-write)

소스에서 실핼 (개발)

npm install
npm run build
node dist/index.js   # with the environment variables set

개발

npm run dev
npm test          # governance policy: modes, allowlists, delete gating, confirmation
npm run typecheck

게시

공식 MCP 레지스트리용 server.json은 npm 소유권 검증을 위한 ``mcpName`과 함게 제공합니다. **PUBLISHING.md**를 참고하세요.

License

MIT