Don't script your AI. Arm it.
자연스럽게 AI에게 물어보세요.
나머지는 MCP 스킬이 알아서 처리합니다.
이 한 줄만 복사하세요. 끝입니다.
아래 명령어를 AI 코딩 어시스턴트에 붙여넣으세요.
uv, Playwright, MCP 설정, 스킬 설치까지 한 번에 자동으로 설정됩니다.
Install and configure mfa-servicenow-mcp by following the instructions here:
curl -s https://raw.githubusercontent.com/jshsakura/mfa-servicenow-mcp/main/docs/llm-setup.md
Claude Code, Cursor, Codex, OpenCode, Windsurf, VS Code Copilot, Gemini CLI 등과 호환됩니다.
AI가 클라이언트와 OS를 감지한 뒤, 대화형으로 설정을 진행해 줍니다.
설정이 완료되면 AI 클라이언트를 재시작하여 MCP 서버를 로드하세요.
클라이언트용 setup 실행
터미널에서 직접 설치하고 싶다면 아래 installer를 사용하세요.
클라이언트에 맞는 MCP 설정을 써 주고, 기존 설정은 보존하며, 지원되는 경우 스킬도 함께 설치합니다.
# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 클라이언트 설정과 선택 스킬 설치
uvx --with playwright --from mfa-servicenow-mcp servicenow-mcp setup opencode \
--instance-url "https://your-instance.service-now.com" \
--auth-type "browser"# Install uv (if not already installed)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 클라이언트 설정과 선택 스킬 설치
uvx --with playwright --from mfa-servicenow-mcp servicenow-mcp setup opencode `
--instance-url "https://your-instance.service-now.com" `
--auth-type "browser"# Install with pip + browser auth support
pip install "mfa-servicenow-mcp[browser]"
playwright install chromium
# Run with MFA browser login
servicenow-mcp \
--instance-url "https://your-instance.service-now.com" \
--auth-type "browser" \
--browser-headless "false"# Clone and install in development mode
git clone https://github.com/jshsakura/mfa-servicenow-mcp.git
cd mfa-servicenow-mcp
uv pip install -e ".[browser]"
playwright install chromium
# Run with MFA browser login
servicenow-mcp \
--instance-url "https://your-instance.service-now.com" \
--auth-type "browser" \
--browser-headless "false"클라이언트 설정을 직접 점검하거나 복구하기
installer가 권장 경로입니다. 아래 원시 설정 예시는 설정 파일을 직접 점검하거나 복구해야 할 때만 사용하세요.
{
"mcpServers": {
"servicenow": {
"command": "uvx",
"args": ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_TYPE": "browser",
"SERVICENOW_BROWSER_HEADLESS": "false",
"SERVICENOW_USERNAME": "your.username",
"SERVICENOW_PASSWORD": "your-password",
"MCP_TOOL_PACKAGE": "standard"
}
}
}
}{
"mcpServers": {
"servicenow": {
"command": "uvx",
"args": ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_TYPE": "browser",
"SERVICENOW_BROWSER_HEADLESS": "false",
"SERVICENOW_USERNAME": "your.username",
"SERVICENOW_PASSWORD": "your-password",
"MCP_TOOL_PACKAGE": "standard"
}
}
}
}[mcp_servers.servicenow]
command = "uvx"
args = ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"]
enabled = true
[mcp_servers.servicenow.env]
SERVICENOW_INSTANCE_URL = "https://your-instance.service-now.com"
SERVICENOW_AUTH_TYPE = "browser"
SERVICENOW_BROWSER_HEADLESS = "false"
SERVICENOW_USERNAME = "your-username"
SERVICENOW_PASSWORD = "your-password"
MCP_TOOL_PACKAGE = "full"{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servicenow": {
"type": "local",
"command": [
"uvx", "--with", "playwright",
"--from", "mfa-servicenow-mcp", "servicenow-mcp"
],
"enabled": true,
"environment": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_TYPE": "browser",
"SERVICENOW_BROWSER_HEADLESS": "false",
"SERVICENOW_USERNAME": "your.username",
"SERVICENOW_PASSWORD": "your-password",
"MCP_TOOL_PACKAGE": "standard"
}
}
}
}{
"mcpServers": {
"servicenow": {
"command": "uvx",
"args": ["--with", "playwright", "--from", "mfa-servicenow-mcp", "servicenow-mcp"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_TYPE": "browser",
"SERVICENOW_BROWSER_HEADLESS": "false",
"SERVICENOW_USERNAME": "your.username",
"SERVICENOW_PASSWORD": "your-password",
"MCP_TOOL_PACKAGE": "standard"
}
}
}
}{
"mcpServers": {
"servicenow": {
"command": "uvx",
"args": [
"--with", "playwright",
"--from", "mfa-servicenow-mcp",
"servicenow-mcp"
],
"env": {
"SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
"SERVICENOW_AUTH_TYPE": "browser",
"SERVICENOW_BROWSER_HEADLESS": "false",
"SERVICENOW_USERNAME": "your.username",
"SERVICENOW_PASSWORD": "your-password",
"MCP_TOOL_PACKAGE": "standard"
}
}
}
}LLM 최적화 스킬 추가하기
도구(Tool)만으로는 단순한 API 호출일 뿐입니다.
안전 장치, 롤백, 문맥 인식을 통한 위임 파이프라인이 포함된 스킬(Skill)들이 결합되었을 때
LLM은 진정으로 유용해집니다. 현재 24개 스킬을 지원하며 릴리스마다 더 추가되고 있습니다.
uvx --from mfa-servicenow-mcp servicenow-mcp-skills claudeuvx --from mfa-servicenow-mcp servicenow-mcp-skills codexuvx --from mfa-servicenow-mcp servicenow-mcp-skills opencodeuvx --from mfa-servicenow-mcp servicenow-mcp-skills gemini🔍 analyze/
6개 스킬 — 위젯 분석, 포털 진단, 의존성 매핑, 코드 감지
🔧 fix/
3개 스킬 — 안전망이 있는 위젯 패치, 디버깅, 코드 리뷰
📦 manage/
5개 스킬 — 페이지 레이아웃, 스크립트 인클루드, 소스 내보내기, 변경 집합(Changeset) 워크플로우
🚀 deploy/
2개 스킬 — 변경 요청(CR) 수명주기, 인시던트 분류
🧭 explore/
4개 스킬 — 상태 점검(Health check), 스키마 탐색, 라우트 추적, ESC 카탈로그 흐름
항상 최신 버전으로 업데이트하기
uvx는 마지막으로 다운로드한 버전을 캐시하여 계속 재사용합니다 — 자동 업데이트되지 않습니다.
uv를 통해 업그레이드하세요:
uvx --refresh --from mfa-servicenow-mcp servicenow-mcp --version업그레이드 후 MCP 클라이언트를 재시작해야 새 버전이 적용됩니다 (Claude Code, Cursor 등).
운영 환경까지 단 3단계
설정할 API 키나 구성 파일에 넣을 비밀번호가 없습니다.
브라우저를 통해 한 번만 인증하면 AI 에이전트가 실시간 세션을 상속받습니다.
설치
uvx를 사용한 명령 한 줄로 모든 설정이 끝납니다. 제로 구성(Zero config).
인증
실제 브라우저가 열려 조직에서 요구하는 MFA, SSO, SAML을 처리합니다.
연결
Claude, Cursor 또는 모든 MCP 클라이언트에 연결하세요. 97개 이상의 도구가 즉시 준비됩니다.
엔터프라이즈 환경에 맞게 구축됨
AI 에이전트와 ServiceNow를
대규모로 안전하게 연결하는 데 필요한 모든 것을 제공합니다.
🔒 제로 트러스트 보안
브라우저 기반 인증은 자격 증명이 절대 로컬 장치를 벗어나지 않음을 의미합니다. MFA, SSO, SAML 및 조직에서 사용하는 모든 로그인 흐름을 지원합니다.
⚡ 최적화된 성능
배치 쿼리, 연결 풀링, 응답 캐싱 및 토큰 효율적인 JSON은 지연 시간과 API 비용을 최소화합니다.
🧩 모듈식 스킬 패키지
인시던트, 변경 관리, 카탈로그, 포털, 워크플로우 및 스크립트 등 — 필요한 기능만 로드하거나 전체 제품군을 실행할 수 있습니다.
🤖 다중 LLM 호환
Claude, ChatGPT, Gemini, Cursor 및 모델 컨텍스트 프로토콜(MCP)을 사용하는 모든 클라이언트에서 작동합니다.