不要给你的 AI 写脚本。为它装备武器。

用平实的语言告诉你的 AI 你需要什么。 剩下的交给 MCP Skills。

开始使用 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 会检测客户端和操作系统，然后以交互方式引导你完成安装。
安装后，重启你的 AI 客户端以加载 MCP 服务器。

如果 uvx 被企业安全工具阻止，请跳到下方的 当 uvx 被阻止时（pip）一节。

手动 — 安装 + 配置

先安装，再添加到客户端配置

更喜欢用终端？安装 uv + Chromium，然后将服务器添加到你的 MCP 客户端配置文件（片段见下）。无需安装命令，无需各客户端专属标志。

macOS / Linux Windows

# 1. Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 2. Fetch the server + Chromium up front (so the first browser-auth call
#    doesn't download ~150 MB and time out)
uvx --refresh --with playwright --from mfa-servicenow-mcp servicenow-mcp --version
uvx --with playwright playwright install chromium

# 3. Add the server to your MCP client config — copy a snippet below

# 1. Install uv (if not already installed)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# 2. Fetch the server + Chromium up front (so the first browser-auth call
#    doesn't download ~150 MB and time out)
uvx --refresh --with playwright --from mfa-servicenow-mcp servicenow-mcp --version
uvx --with playwright playwright install chromium

# 3. Add the server to your MCP client config — copy a snippet below

当 uvx 被阻止时

改用 pip 安装

Windows 的 Smart App Control 会阻止 uvx，因为 uvx 每次运行都要解压一个未签名的临时可执行文件。如果 uvx 一直用得好好的，却在某次 Windows 更新之后突然失效，原因就在这里。改用 pip 安装，并以模块方式启动服务器 —— servicenow-mcp 控制台脚本是 pip 生成的未签名 .exe 包装器，会因为同样的原因被阻止。

macOS / Linux Windows

# Homebrew 和发行版自带的 Python 会拒绝全局 pip 安装（PEP 668）。
# 请改用 python.org 的 Python，或者干脆继续用上面的 uvx。
pip install mfa-servicenow-mcp playwright
python -m playwright install chromium

# 验证：
python -m servicenow_mcp --version

# 以后升级：
pip install --upgrade mfa-servicenow-mcp playwright
python -m playwright install chromium

# python.org 的 Python 3.10+ 已签名，可以通过 Smart App Control。
pip install mfa-servicenow-mcp playwright
python -m playwright install chromium

# 验证：
python -m servicenow_mcp --version

# 以后升级：
pip install --upgrade mfa-servicenow-mcp playwright
python -m playwright install chromium

无论用哪种方式，env 块都完全相同 —— 只有 command 和 args 不同。粘贴下方手动回退一节中的片段，然后把 command 设为 python，args 设为 ["-m", "servicenow_mcp"]。

手动回退

手动修复或检查客户端配置

安装程序是推荐路径。仅当你需要手动检查或修复客户端配置时，才使用下面的原始配置示例。

四种不同的形态涵盖了所有受支持的客户端。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 优化的技能

仅有工具只是原始的 API 调用。技能才是让你的 LLM 真正有用的东西 —— 带安全门控、回滚和上下文感知委派的经验证流水线。 如今有 4 个技能，每次发布都会有更多。

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/

1 个技能 —— 本地源码审计：交叉引用、死代码、执行顺序、HTML 报告

🧭 explore/

1 个技能 —— flow 触发器追踪：当某个表发生更改时哪些 workflow/flow 会触发

📦 manage/

2 个技能 —— 应用源码下载、本地同步（diff → 推送，带冲突检测）

保持更新

始终运行最新版本

uvx 会缓存上次下载的版本 —— 它不会自动更新。
通过 uv 升级以获取最新发布版：

终端

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

然后重启你的 MCP 客户端（Claude Code、Cursor 等）以加载新版本。

66 已注册工具

MFA 原生支持

3 技能类别

0 凭据共享

---

工作原理

三步即可投入生产

无需配置 API 密钥，配置文件中也没有密码。 通过浏览器认证一次，你的 AI 代理便继承一个实时会话。

1

安装

用 uvx 一条命令搞定一切。零配置。

2

认证

会打开一个真实浏览器用于 MFA、SSO、SAML —— 无论你的组织要求什么。

3

连接

指向 Claude、Cursor、Zed 或任意 MCP 客户端。66 个已注册工具通过活动包配置加载。

---

特性

为企业打造

在规模化场景下安全地连接 AI 代理与 ServiceNow，你所需的一切尽在于此。

🔒 零信任安全

基于浏览器的认证意味着凭据永不离开你的机器。支持 MFA、SSO、SAML 以及你组织使用的任意登录流程。

⚡ token 高效的性能

惰性工具发现、按包限定的 schema、紧凑 JSON、响应缓存和批量读取，将启动开销和 LLM 上下文成本控制在可控范围内。

🧩 安全的数据比对

可选的命名实例被限制为只读的 dev/test 漂移检查。普通工具始终固定在一个活动实例上。

🤖 广泛的客户端支持

适用于 Claude、Codex、Cursor、Zed、Antigravity、OpenCode、Windsurf、VS Code Copilot，以及通过 stdio 或 Streamable HTTP 通信的 MCP 客户端。

---

准备好把你的 AI 连接到 ServiceNow 了吗？

跟随我们的分步指南，五分钟内即可完成设置。

阅读安装指南