도구 패키지 — 고급 레퍼런스¶
대부분의 사용자는 이 페이지가 필요 없습니다. 기본 패키지는
standard로, 읽기 전용이며 어떤 환경에서도 안전합니다.standard로 충분하지 않은 쓰기 도구가 필요할 때만 이 문서를 참고하세요.
패키지 선택 가이드¶
자신의 작업에 필요한 가장 좁은 패키지부터 시작하세요. 단계가 올라갈수록 더 많은 도메인의 쓰기 권한이 추가됩니다:
읽기 전용 — 어떤 환경에서도 안전, 쓰기 도구 없음:
| 패키지명 | 도구 수 | 사용 시기 |
|---|---|---|
core |
12 | 최소 읽기 전용: 헬스체크, 스키마, 탐색, 핵심 조회만 |
standard |
27 | (기본값) 인시던트/변경/포털/로그/소스 분석 읽기 전용 |
none |
0 | 모든 도구를 의도적으로 비활성화 (테스트, 잠금 환경) |
⚠️ 쓰기 가능 — 고급 옵션, 생성/수정/삭제 권한 부여:
| 패키지명 | 도구 수 | 사용 시기 |
|---|---|---|
service_desk |
29 | ⚠️ 인시던트/변경 업데이트·종료가 필요한 서비스 데스크 담당자 |
portal_developer |
39 | ⚠️ 위젯, 체인지셋, Script Include를 배포하는 포털 개발자 |
platform_developer |
39 | ⚠️ 워크플로우, Flow Designer, 스크립트를 관리하는 플랫폼 엔지니어 |
full |
53 | ⚠️ 가장 고급 — 모든 도메인의 쓰기 도구 전체를 동시에 (아래 경고 참고) |
core와 none을 제외한 모든 패키지는 _extends를 통해 standard 읽기 전용 도구를 상속합니다. 전체 상속 구조는 config/tool_packages.yaml을 참고하세요.
⚠️ standard 위의 패키지는 전부 쓰기 가능한 고급 옵션입니다
service_desk, portal_developer, platform_developer, full 모두 쓰기 도구를 활성화합니다 — 이 패키지로 실행된 AI 에이전트는 ServiceNow 레코드를 생성·수정·삭제할 수 있습니다. full은 모든 도메인에서 동시에 가능하므로(인시던트, 변경, 포털, Flow Designer, 워크플로우, 스크립트 등), 프롬프트 오해나 환각 한 번으로 여러 영역에서 동시에 파괴적인 변경이 발생할 수 있습니다.
standard에서 올라가기 전에 다음을 확인하세요:
- 활성화되는 모든 쓰기 도구를 파악한 경우 (도구 목록 참고)
- 비프로덕션 또는 샌드박스 인스턴스에서 작업하거나 allow_writes 게이트를 걸어둔 경우
- 의도치 않은 변경을 복구할 방법을 아는 숙련된 ServiceNow 개발자인 경우
확실하지 않다면, 읽기 전용 기본값 standard에 머물고 작업에 꼭 필요할 때만 가장 좁은 쓰기 패키지로 올리세요.
패키지 설정 방법¶
환경변수로 설정 (권장):
CLI 플래그로 설정:
MCP 클라이언트 설정 파일:
패키지에 없는 도구 호출 시¶
현재 패키지에 없는 도구를 호출하면 서버가 명확한 오류를 반환합니다:
Tool 'manage_widget' is not available in package 'standard'.
Enable package 'portal_developer' or higher to use this tool.
자동 실패 없이 LLM이 어느 패키지가 필요한지 정확히 알 수 있습니다.
전체 도구 목록¶
카테고리와 패키지별 전체 73개 도구 목록은 도구 목록에서 확인하세요.