ServiceNow MCP Server

자체 호스팅되는 Model Context Protocol 서버로, ServiceNow 인스턴스를 Microsoft Copilot Studio 및 기타 MCP 클라이언트 (예: Claude)에 노출합니다. 플랫폼의 REST API(Table / Aggregate / CMDB)를 호출하여 표준 ServiceNow 라이선스에서 완전히 실행되며, 사용자별 OAuth 2.0 토큰 패스스루를 사용하므로 모든 호출이 로그인한 사용자로 실행되어 해당 사용자의 ACL이 적용됩니다.

존재 이유

대상 인스턴스는 표준 ServiceNow 라이선스를 사용 중이므로 ServiceNow의 네이티브 MCP Server Console(Now Assist / AI Native SKU 전용)은 사용할 수 없습니다. 이 서버는 휴대 가능하고 재사용 가능한 통합 레이어, 즉 여러 클라이언트와 여러 AI 프런트엔드에서 사용할 수 있는 하나의 MCP 서버로, Copilot Studio 전용 커넥터가 아닙니다.

Related MCP server: servicenow-mcp-server

인증 작동 방식 (토큰 패스스루)

User ⇄ Copilot Studio  --(per-user OAuth: ServiceNow access token as Bearer)-->  this server
                                                       │ forwards the same Bearer token
                                                       ▼
                                          ServiceNow REST APIs (ACLs enforced as that user)

서버는 사용자 자격 증명을 저장하지 않습니다. 들어오는 Authorization: Bearer <token> 헤더를 읽어 그대로 ServiceNow에 전달합니다. auth.py를 참조하세요.

도구

Tier 1 — 직접 검색(읽기 전용): get_incident, list_incidents, get_change_request, list_change_requests, get_service_request, list_service_requests, get_configuration_item, find_configuration_items, search_knowledge, get_knowledge_article, lookup_user, lookup_group.

Tier 2 — 결정적 로직: correlate_changes_to_incident, get_incident_trends, get_ci_impact, find_similar_incidents, get_incident_context.

근본 원인 분석과 최종 유사 인시던트 순위 결정은 의도적으로 에이전트의 추론에 맡겨지며, get_incident_context / find_similar_incidents가 필요한 데이터를 제공합니다.

로컬에서 실행

python -m venv .venv
.venv/Scripts/pip install -e ".[dev]"      # Windows; use .venv/bin on macOS/Linux
cp .env.example .env                        # set SERVICENOW_INSTANCE_URL
SERVICENOW_INSTANCE_URL=https://devXXXXX.service-now.com .venv/Scripts/servicenow-mcp

서버는 /health 프로브와 함께 http://HOST:PORT/mcp(Streamable HTTP)에서 수신 대기합니다.

MCP Inspector로 검사

npx @modelcontextprotocol/inspector

http://localhost:8000/mcp로 지정하고 Streamable HTTP를 선택한 다음 ServiceNow OAuth 액세스 토큰을 Bearer 토큰으로 제공하여 도구를 실행하세요. 이는 Swagger UI에 가장 가까운 MCP 방식입니다. 모든 도구를 스키마와 함께 나열하고 각 도구를 대화형으로 호출할 수 있습니다.

모든 도구 나열(서버 또는 ServiceNow 연결 불필요)

.venv/Scripts/python scripts/list_tools.py         # human-readable catalog
.venv/Scripts/python scripts/list_tools.py --json   # machine-readable (like an OpenAPI dump)

배포

컨테이너 이미지 + Azure Container Apps. ServiceNow OAuth 앱 등록, Copilot Studio 연결 및 인프라에 대해서는 docs/DEPLOYMENT.md를 참조하세요.

로컬 서버를 개발 터널로 노출하고 에이전트를 처음부터 만들고 두 사용자 ACL 테스트를 수행하는 단계별 전체 가이드는 docs/COPILOT_STUDIO_SETUP.md를 참조하세요.

테스트

.venv/Scripts/pytest