Don't script your AI. Arm it.

자연스럽게 AI에게 물어보세요.
나머지는 MCP 스킬이 알아서 처리합니다.

시작하기 GitHub

mfa-servicenow-mcp

빠른 시작

이 한 줄만 복사하세요. 끝입니다.

아래 명령어를 AI 코딩 어시스턴트에 붙여넣으세요.
uv, Playwright, MCP 설정, 스킬 설치까지 한 번에 자동으로 설정됩니다.

AI에 붙여넣기

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, Antigravity, Zed 등과 호환됩니다.
AI가 클라이언트와 OS를 감지한 뒤, 대화형으로 설정을 진행해 줍니다.
설정이 완료되면 AI 클라이언트를 재시작하여 MCP 서버를 로드하세요.

회사 보안툴이 uvx를 막는 환경이라면 아래 로컬 설치 (릴리즈 zip) 섹션을 참고하세요.

수동 설치 — 설치 + 설정

설치 후 클라이언트 설정에 추가

터미널에서 직접 하려면: uv + Chromium 설치 후, MCP 클라이언트 설정파일에 서버를 추가하세요(아래 예시).
별도 installer 명령도, 클라이언트별 플래그도 없습니다.

macOS / Linux Windows

# 1. uv 설치 (이미 있으면 생략)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. 서버 + Chromium 미리 받기 (첫 브라우저 호출에서 ~150 MB
#    받다가 timeout 나는 걸 예방)
uvx --refresh --with playwright --from mfa-servicenow-mcp servicenow-mcp --version
uvx --with playwright playwright install chromium

# 3. MCP 클라이언트 설정파일에 서버 추가 — 아래 예시 복사

# 1. uv 설치 (이미 있으면 생략)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 2. 서버 + Chromium 미리 받기 (첫 브라우저 호출에서 ~150 MB
#    받다가 timeout 나는 걸 예방)
uvx --refresh --with playwright --from mfa-servicenow-mcp servicenow-mcp --version
uvx --with playwright playwright install chromium

# 3. MCP 클라이언트 설정파일에 서버 추가 — 아래 예시 복사

로컬 설치 — 오프라인 친화

릴리즈 zip으로 설치하기

uvx나 PyPI 접속이 막히는 사내망에서 사용하세요. 릴리즈 zip에는 PyInstaller로 빌드된 단일 실행 파일만 들어 있어 Python·설치 스크립트가 필요 없습니다. GitHub Releases에서 플랫폼 zip(필요 시 같은 릴리즈의 ms-playwright-chromium zip도)을 받아 풀고, MCP 클라이언트의 command를 실행 파일로 지정하면 됩니다.

macOS / Linux Windows

# 1. 본인이 정한 안정 폴더에 zip을 미리 다 풀어두세요 — .zip 파일을
#    실행 파일 옆에 남기지 말고. Chromium 폴더 이름은 ms-play로
#    시작하고 안에 chromium-*만 있으면 OK:
#
#    ~/apps/servicenow-mcp/                              (본인이 정하는 경로)
#    ├── servicenow-mcp                                  ← 실행 파일
#    └── ms-playwright-chromium-linux-x64-<ver>/         ← 기본 이름 OK
#        └── chromium-1185/
#
# 2. 시작 시 실행 파일이 옆 ms-play* 디렉토리를 글롭으로 찾아
#    Playwright를 그쪽으로 보냅니다. 시스템 표준 캐시
#    (~/.cache/ms-playwright) 와 MCP 클라이언트 설정은 그대로.
# 3. 바이너리 동작 확인:
~/apps/servicenow-mcp/servicenow-mcp --version

# 4. 아래 "수동 복구용" 섹션의 설정 스니펫을 본인 클라이언트 설정 파일에
#    붙여넣고 'command'를 아래 경로로 지정:
#       ~/apps/servicenow-mcp/servicenow-mcp
# 클라이언트 재시작 끝.

# 1. 본인이 정한 안정 폴더에 zip을 미리 다 풀어두세요 — .zip 파일을
#    실행 파일 옆에 남기지 말고. Chromium 폴더 이름은 ms-play로
#    시작하고 안에 chromium-*만 있으면 OK:
#
#    C:\Users\you\apps\servicenow-mcp\
#    ├── servicenow-mcp.exe                              ← 실행 파일
#    └── ms-playwright-chromium-windows-x64-<ver>\       ← 기본 이름 OK
#        └── chromium-1185\
#
# 2. 시작 시 실행 파일이 옆 ms-play* 디렉토리를 글롭으로 찾아
#    Playwright를 그쪽으로 보냅니다. 시스템 표준 캐시
#    (%LOCALAPPDATA%\ms-playwright) 와 MCP 클라이언트 설정은 그대로.
# 3. 바이너리 동작 확인:
& "$HOME\apps\servicenow-mcp\servicenow-mcp.exe" --version

# 4. 아래 "수동 복구용" 섹션의 설정 스니펫을 본인 클라이언트 설정 파일에
#    붙여넣고 'command'를 아래 경로로 지정:
#       C:/Users/you/apps/servicenow-mcp/servicenow-mcp.exe
# 클라이언트 재시작 끝.

설치 스크립트 없음. 본인이 정한 안정 폴더에 실행 파일을 풀고, Chromium zip을 그 옆 ms-playwright 서브폴더로 풀면, 실행 파일이 시작 시 그 구조를 자동 인식해 PLAYWRIGHT_BROWSERS_PATH를 현재 프로세스에만 지정합니다. 시스템 표준 Playwright 캐시(~/.cache/ms-playwright, %LOCALAPPDATA%\ms-playwright) 는 보존되고, MCP 클라이언트 설정 파일도 본인이 직접 관리 — 아래 수동 복구용 섹션의 스니펫을 붙여넣고 command를 실행 파일 절대 경로로 지정하세요.

수동 복구용

클라이언트 설정을 직접 점검하거나 복구하기

installer가 권장 경로입니다. 아래 원시 설정 예시는 설정 파일을 직접 점검하거나 복구해야 할 때만 사용하세요.

구조는 4가지뿐 — env 블록은 어느 클라이언트에서나 동일합니다. 외부 래퍼만 다릅니다.

Claude Desktop / Claude Code / AntiGravity / Cursor Zed Codex (TOML) OpenCode

{
  "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"
      }
    }
  }
}

{
  "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_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"

{
  "$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"
      }
    }
  }
}

읽기 전용 standard 패키지가 기본 로드됩니다 — MCP_TOOL_PACKAGE를 적을 필요 없습니다. 쓰기 권한이 필요하면 어드밴스 패키지(service_desk, portal_developer, platform_developer, full)로 지정하세요 — 자세한 내용은 툴 패키지 (어드밴스) 가이드 참고.

수동 설치 — 3단계

LLM 최적화 스킬 추가하기

도구(Tool)만으로는 단순한 API 호출일 뿐입니다.
안전 장치, 롤백, 문맥 인식을 통한 위임 파이프라인이 포함된 스킬(Skill)들이 결합되었을 때
LLM은 진정으로 유용해집니다. 현재 16개 스킬을 지원하며 릴리스마다 더 추가되고 있습니다.

Claude Code Codex OpenCode Antigravity

uvx --from mfa-servicenow-mcp servicenow-mcp-skills claude

uvx --from mfa-servicenow-mcp servicenow-mcp-skills codex

uvx --from mfa-servicenow-mcp servicenow-mcp-skills opencode

uvx --from mfa-servicenow-mcp servicenow-mcp-skills antigravity

🔍 analyze/

5개 스킬 — 위젯 분석, 포털 진단, 로컬 소스 감사, provider 감사, ESC 페이지 감사

🔧 fix/

3개 스킬 — 안전망이 있는 위젯 패치, 디버깅, 코드 리뷰

📦 manage/

5개 스킬 — 앱 소스 다운로드, 변경 집합(Changeset) 워크플로우, 로컬 동기화, 워크플로우 관리, 스킬 관리

🚀 deploy/

1개 스킬 — 변경 요청(CR) 수명주기

🧭 explore/

2개 스킬 — 플로우 트리거 추적, ESC 카탈로그 흐름

최신 버전 유지

항상 최신 버전으로 업데이트하기

uvx는 마지막으로 다운로드한 버전을 캐시하여 계속 재사용합니다 — 자동 업데이트되지 않습니다.
uv를 통해 업그레이드하세요:

Terminal

uvx --refresh --from mfa-servicenow-mcp servicenow-mcp --version

업그레이드 후 MCP 클라이언트를 재시작해야 새 버전이 적용됩니다 (Claude Code, Cursor 등).

70 등록 도구

MFA 네이티브 지원

5 스킬 패키지

0 외부 공유되는 자격 증명

---

작동 방식

운영 환경까지 단 3단계

설정할 API 키나 구성 파일에 넣을 비밀번호가 없습니다.
브라우저를 통해 한 번만 인증하면 AI 에이전트가 실시간 세션을 상속받습니다.

1

설치

uvx를 사용한 명령 한 줄로 모든 설정이 끝납니다. 제로 구성(Zero config).

2

인증

실제 브라우저가 열려 조직에서 요구하는 MFA, SSO, SAML을 처리합니다.

3

연결

Claude, Cursor, Zed 또는 모든 MCP 클라이언트에 연결하세요. 등록 도구 70개가 활성 패키지 프로필을 통해 준비됩니다.

---

주요 기능

엔터프라이즈 환경에 맞게 구축됨

AI 에이전트와 ServiceNow를
대규모로 안전하게 연결하는 데 필요한 모든 것을 제공합니다.

🔒 제로 트러스트 보안

브라우저 기반 인증은 자격 증명이 절대 로컬 장치를 벗어나지 않음을 의미합니다. MFA, SSO, SAML 및 조직에서 사용하는 모든 로그인 흐름을 지원합니다.

⚡ 토큰 효율 성능

레이지 도구 디스커버리, 패키지별 스키마, 컴팩트 JSON, 응답 캐싱, 배치 조회로 startup과 LLM 컨텍스트 비용을 낮춥니다.

🧩 안전한 데이터 비교

선택형 named instance는 read-only dev/test drift 확인으로 제한됩니다. 일반 도구는 하나의 active 인스턴스에만 고정됩니다.

🤖 폭넓은 클라이언트 지원

Claude, Codex, Cursor, Zed, Antigravity, OpenCode, Windsurf, VS Code Copilot과 stdio/Streamable HTTP MCP 클라이언트에서 동작합니다.

---

AI를 ServiceNow에 연결할 준비 되셨나요?

단계별 가이드로 5분 안에 설정을 완료하세요.

설정 가이드 보기