Azure DevOps MCP Server for Cline

Cline용 Azure DevOps MCP 서버

이 MCP(Model Context Protocol) 서버는 Azure DevOps와의 통합을 제공하여 Cline이 Azure DevOps 서비스와 상호 작용할 수 있도록 합니다.

필수 조건

• Node.js(v20 LTS 이상)
• npm(Node.js와 함께 제공)
• 클라인 설치
• 액세스 토큰이 있는 Azure DevOps 계정

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Azure DevOps Server를 자동으로 설치하려면 다음을 수행합니다.

지엑스피1

수동 설치

1. 이 저장소를 복제하세요:

2. 종속성 설치:

3. 서버를 빌드하세요:

참고: 빌드 출력( build/ 디렉터리)은 버전 관리에 포함되지 않습니다. 저장소를 복제한 후 build 명령을 실행해야 합니다.

구성

1. Azure DevOps 개인 액세스 토큰(PAT) 받기

1. Azure DevOps로 이동하여 로그인하세요.
2. 오른쪽 상단의 프로필 사진을 클릭하세요
3. "보안"을 선택하세요
4. "새로운 토큰"을 클릭하세요
5. 토큰 이름을 지정하고 필요한 범위를 선택하세요.
   • Code (read, write) - 풀 리퀘스트 작업용
   • Work Items (read, write) - 작업 항목 관리용
   • Build (read, execute) - 파이프라인 작업용
   • Wiki (read, write) - 위키 작업을 위해
   • Project and Team (read) - 프로젝트 및 이사회 정보
6. 생성된 토큰을 복사하세요

2. Cline MCP 설정 구성

Cline MCP 설정 파일에 서버 구성을 추가합니다.

• VSCode 확장자의 경우: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• Claude 데스크톱 앱의 경우: %LOCALAPPDATA%/Claude/claude_desktop_config.json

mcpServers 개체에 다음 구성을 추가합니다.

다음 값을 바꾸세요:

• /absolute/path/to/azure-devops-server : 이 리포지토리를 복제한 절대 경로
• your-organization : Azure DevOps 조직 이름
• your-project-name : Azure DevOps 프로젝트 이름
• your-personal-access-token : 1단계에서 생성한 PAT

사용 가능한 도구

작업 항목

• get_work_item : ID로 작업 항목을 가져옵니다.
• list_work_items : WIQL을 사용하여 작업 항목 쿼리
• create_work_item : 새로운 작업 항목(버그, 작업, 사용자 스토리)을 생성합니다.
• update_work_item : 기존 작업 항목 업데이트

무대

• get_boards : 프로젝트에서 사용 가능한 보드를 가져옵니다.

파이프라인

• list_pipelines : 프로젝트의 모든 파이프라인을 나열합니다.
• trigger_pipeline : 파이프라인을 실행합니다

풀 리퀘스트

• list_pull_requests : 풀 리퀘스트 목록
• create_pull_request : 새로운 풀 리퀘스트를 생성합니다.
• update_pull_request : 풀 리퀘스트 업데이트
• get_pull_request : 풀 리퀘스트 세부 정보 가져오기

위키

• get_wikis : 프로젝트의 모든 위키를 나열합니다.
• get_wiki_page : 위키 페이지 가져오기
• create_wiki : 새로운 위키를 만듭니다
• update_wiki_page : 위키 페이지를 생성하거나 업데이트합니다.

프로젝트

• list_projects : Azure DevOps 조직의 모든 프로젝트를 나열합니다.

확인

1. 구성을 추가한 후 Cline(또는 VSCode)을 다시 시작합니다.
2. Azure DevOps MCP 서버가 이제 Cline의 기능에 나열되어야 합니다.
3. MCP Inspector를 사용하여 설치를 확인할 수 있습니다.

문제 해결

1. 서버가 연결되지 않는 경우:
   • MCP 설정의 경로가 올바른지 확인하세요.
   • Azure DevOps 자격 증명을 확인하세요
   • 오류 메시지가 있는지 Cline 로그를 확인하세요.
2. 인증 오류가 발생하는 경우:
   • PAT가 만료되지 않았는지 확인하세요
   • PAT에 필요한 모든 범위가 있는지 확인하세요.
   • 조직 및 프로젝트 이름을 다시 확인하세요
3. 기타 문제에 대해서는:
   • 검사기 도구를 실행하여 서버가 올바르게 작동하는지 확인하세요.
   • 서버 로그에서 오류 메시지를 확인하세요.

개발

서버를 수정하거나 확장하려면:

1. src 디렉토리에서 변경하세요
2. 개발을 위해 npm run watch 실행하세요.
3. 준비가 되면 npm run build 로 빌드하세요.
4. 검사기를 사용하여 테스트: npm run inspector

특허

MIT 라이선스 - 자세한 내용은 라이선스를 참조하세요.