ServiceNow MCP 변경 관리 도구¶

이 문서는 ServiceNow MCP 서버에서 제공하는 변경 관리 도구에 대한 정보를 다룹니다.

개요¶

변경 관리 도구를 사용하면 Claude가 ServiceNow의 변경 관리 기능과 연동되어, 자연어 대화를 통해 사용자가 변경 요청을 생성, 수정, 관리할 수 있습니다.

사용 가능한 도구¶

ServiceNow MCP 서버는 다음과 같은 변경 관리 도구를 제공합니다.

기본 변경 요청 관리¶

create_change_request - ServiceNow에 새로운 변경 요청을 생성합니다.
매개변수:
- short_description (필수): 변경 요청의 간단한 설명
- description: 변경 요청에 대한 상세 설명
- type (필수): 변경 유형 (normal, standard, emergency)
- risk: 변경의 위험 수준
- impact: 변경의 영향도
- category: 변경의 분류
- requested_by: 변경을 요청한 사용자
- assignment_group: 변경이 할당된 그룹
- start_date: 계획 시작일 (YYYY-MM-DD HH:MM:SS)
- end_date: 계획 종료일 (YYYY-MM-DD HH:MM:SS)
update_change_request - 기존 변경 요청을 수정합니다.
매개변수:
- change_id (필수): 변경 요청 ID 또는 sys_id
- short_description: 변경 요청의 간단한 설명
- description: 변경 요청에 대한 상세 설명
- state: 변경 요청의 상태
- risk: 변경의 위험 수준
- impact: 변경의 영향도
- category: 변경의 분류
- assignment_group: 변경이 할당된 그룹
- start_date: 계획 시작일 (YYYY-MM-DD HH:MM:SS)
- end_date: 계획 종료일 (YYYY-MM-DD HH:MM:SS)
- work_notes: 변경 요청에 추가할 작업 노트
list_change_requests - 필터링 옵션으로 변경 요청 목록을 조회합니다.
매개변수:
- limit: 반환할 최대 레코드 수 (기본값: 10)
- offset: 시작 오프셋 (기본값: 0)
- state: 상태 필터
- type: 유형 필터 (normal, standard, emergency)
- category: 분류 필터
- assignment_group: 할당 그룹 필터
- timeframe: 기간 필터 (upcoming, in-progress, completed)
- query: 추가 쿼리 문자열
get_change_request_details - 특정 변경 요청의 상세 정보를 조회합니다.
매개변수:
- change_id (필수): 변경 요청 ID 또는 sys_id
add_change_task - 변경 요청에 작업을 추가합니다.
매개변수:
- change_id (필수): 변경 요청 ID 또는 sys_id
- short_description (필수): 작업의 간단한 설명
- description: 작업에 대한 상세 설명
- assigned_to: 작업이 할당된 사용자
- planned_start_date: 계획 시작일 (YYYY-MM-DD HH:MM:SS)
- planned_end_date: 계획 종료일 (YYYY-MM-DD HH:MM:SS)

변경 승인 워크플로우¶

submit_change_for_approval - 변경 요청을 승인 요청 상태로 전환합니다.
매개변수:
- change_id (필수): 변경 요청 ID 또는 sys_id
- approval_comments: 승인 요청에 대한 코멘트
approve_change - 변경 요청을 승인합니다.
매개변수:
- change_id (필수): 변경 요청 ID 또는 sys_id
- approver_id: 승인자 ID
- approval_comments: 승인 코멘트
reject_change - 변경 요청을 반려합니다.
매개변수:
- change_id (필수): 변경 요청 ID 또는 sys_id
- approver_id: 승인자 ID
- rejection_reason (필수): 반려 사유

Claude와 함께 사용하는 예시¶

ServiceNow MCP 서버를 Claude Desktop에 구성하면, Claude에게 다음과 같은 작업을 요청할 수 있습니다.

변경 요청 생성 및 관리¶

"내일 밤 보안 패치 적용을 위한 서버 유지보수 변경 요청을 만들어줘"
"다음 주 화요일 새벽 2시부터 4시까지 데이터베이스 업그레이드를 예약해줘"
"웹 애플리케이션의 중요 보안 취약점을 긴급 수정하기 위한 긴급 변경 요청을 만들어줘"

작업 추가 및 구현 상세¶

"서버 유지보수 변경 요청에 사전 점검 작업을 추가해줘"
"데이터베이스 업그레이드 시작 전 시스템 백업 확인 작업을 추가해줘"
"네트워크 변경 요청의 구현 계획에 롤백 절차를 포함하도록 수정해줘"

승인 워크플로우¶

"서버 유지보수 변경 요청을 승인 요청 상태로 올려줘"
"내 승인을 기다리는 모든 변경 요청을 보여줘"
"데이터베이스 업그레이드 변경 요청을 승인해줘. 코멘트: 구현 계획이 꼼꼼하네요"
"테스트가 부족해서 네트워크 변경 요청을 반려해줘"

변경 정보 조회¶

"이번 주 예정된 모든 긴급 변경 요청을 보여줘"
"데이터베이스 업그레이드 변경 요청의 상태가 어때?"
"네트워크 팀에 할당된 모든 변경 요청을 조회해줘"
"CHG0010001 변경 요청의 상세 정보를 보여줘"

코드 예시¶

변경 관리 도구를 프로그래밍 방식으로 사용하는 예시입니다.

from servicenow_mcp.auth.auth_manager import AuthManager
from servicenow_mcp.tools.change_tools import create_change_request
from servicenow_mcp.utils.config import ServerConfig

# Create server configuration
server_config = ServerConfig(
    instance_url="https://your-instance.service-now.com",
)

# Create authentication manager
auth_manager = AuthManager(
    auth_type="basic",
    username="your-username",
    password="your-password",
    instance_url="https://your-instance.service-now.com",
)

# Create a change request
create_params = {
    "short_description": "Server maintenance - Apply security patches",
    "description": "Apply the latest security patches to the application servers.",
    "type": "normal",
    "risk": "moderate",
    "impact": "medium",
    "category": "Hardware",
    "start_date": "2023-12-15 01:00:00",
    "end_date": "2023-12-15 03:00:00",
}

result = create_change_request(auth_manager, server_config, create_params)
print(result)

위 예시는 프로그래밍 방식의 요청 구조와 변경 관리를 자동화에 통합할 때 필요한 핵심 임포트를 보여줍니다.

Claude Desktop 연동¶

Claude Desktop에서 변경 관리 도구가 포함된 ServiceNow MCP 서버를 구성하려면 다음 단계를 따르세요.

Claude Desktop 설정 파일을 엽니다. 경로는 macOS의 경우 ~/Library/Application Support/Claude/claude_desktop_config.json 이며, 사용 중인 OS에 맞는 경로를 사용하세요.

{
  "mcpServers": {
    "ServiceNow": {
      "command": "/Users/yourusername/dev/servicenow-mcp/.venv/bin/python",
      "args": [
        "-m",
        "servicenow_mcp.cli"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_USERNAME": "your-username",
        "SERVICENOW_PASSWORD": "your-password",
        "SERVICENOW_AUTH_TYPE": "basic"
      }
    }
  }
}

변경 사항을 적용하려면 Claude Desktop을 재시작하세요.

커스터마이징¶

변경 관리 도구는 조직의 ServiceNow 구성에 맞게 커스터마이징할 수 있습니다.

상태 값은 ServiceNow 인스턴스 구성에 따라 조정이 필요할 수 있습니다.
필요한 경우 매개변수 모델에 추가 필드를 포함할 수 있습니다.
승인 워크플로우는 조직의 승인 프로세스에 맞게 수정이 필요할 수 있습니다.

도구를 커스터마이징하려면 src/servicenow_mcp/tools 디렉토리의 change_tools.py 파일을 수정하세요.