servicenow-mcp-ai

servicenow-mcp-ai — ServiceNow MCP 服务

📖 文档网站 →

这是一个 Model Context Protocol 服务，可让 MCP 客户端（VS Code、Claude Desktop 等）通过 REST API 对 ServiceNow 实例执行命令，包括 Table、Aggregate、Attachment、Import Set、Batch 和 CMDB，以及 Service Catalog、Change Management 和 Knowledge 插件 API。 凭据保存在本地 env 文件中，并可在运行时通过工具更新。

从 2.x 升级？ 3.0 的默认设置存在重大变化（破坏性应用需要计划令牌、系统表受到保护、默认工具集更小）。运行一次 npx servicenow-mcp-ai migrate --write：它会迁移你的 env 文件和 MCP 客户端配置，并添加 SN_COMPAT=2，以保留所有尚未设置的 2.x 默认值。 每项变更请参阅 CHANGELOG →“迁移概览”。

从 1.x 升级？ v2.0 默认采用先计划再写入：create/update/delete 及其他记录写入工具会返回不执行修改的预览，除非传入 apply: true（或设置 SN_WRITE_MODE=apply，以恢复 v1“立即执行”的行为）。完整迁移说明请参阅 CHANGELOG → 2.0.0。

目录： 快速演示 · 功能 · 要求 · 设置 · 配置凭据 · 运行 / 调试 · 开发 · 工具 · 资源 · 提示词 · 项目结构 · 安全说明 · 项目文档 · 支持

这是我利用业余时间开发和维护的项目——如果它对你有帮助，可以通过 GitHub Sponsors 赞助支持，让项目持续运行。 完整的支持选项位于文末。

快速演示

平台让三件事变得棘手，而每件事只需调用一次。将 MCP 客户端指向一个实例（设置），然后提问：

1. “这个字段实际上在哪里用到？” — 所有涉及该字段的脚本、业务规则、客户端脚本、UI 策略/操作和 ACL，以 JSON 或 Mermaid 图的形式呈现。ServiceNow 没有按钮可实现的 IDE 级 查找用法：

// servicenow_where_used
{
  "kind": "field", // "table" | "field" | "script"
  "name": "u_cost_center",
  "mermaid": true, // also render a reference graph
}

2. “保存这条记录时会运行什么？” — 按执行顺序列出完整的自动化链（display → before → after → async 业务规则，然后是流、工作流和通知），并附上每项的条件——这是一个什么都不执行的逻辑测试：

// servicenow_trace_table_event
{
  "table": "incident",
  "operation": "update", // insert | update | delete | query
}

3. “开发环境和生产环境之间有哪些差异？” — 对两个已配置的配置文件中的表、列、脚本（先按 sys_id、再按名称匹配，并提供每个已更改脚本的统一差异）和插件生成 Markdown 差异报告；还可按需包含属性、选项、ACL、通知、流、服务目录项目和角色；并提供适合 CI 的退出代码，让流水线能够阻止有风险的部署：

servicenow-mcp-ai drift dev prod   # report on stdout; exit 1 on drift, 0 if clean

这三项功能均为只读，适用于任何实例——包括免费的 PDI——模型和客户端均可自行选择。

功能

• 完整的 Table API：在任何表上查询、读取、创建、更新和删除记录，并支持编码查询、字段选择和分页。
• 其他 ServiceNow API：Aggregate（统计）、Attachment（列出／上传／下载／删除）、Import Set、Batch（在单个请求中执行多个 REST 调用），以及表／列元数据（sys_db_object、sys_dictionary）。
• 流程与插件 API：CMDB（支持类的 CI CRUD 和元数据、从 cmdb_rel_ci 读取关系、IRE 识别与协调并提供仅识别计划）、 Service Catalog（浏览／订购条目）、Change Management（类型化创建和冲突检测）以及 Knowledge（文章搜索）。 如果实例未启用相应插件，插件专属 API 会明确报告。
• 脚本智能：读取和搜索实例自身的代码（业务规则、脚本包含项、客户端脚本、UI 策略／操作、计划作业、转换／REST 脚本、ACL、Service Portal 小组件、UI 页面／脚本／宏、处理器、电子邮件／修复／验证脚本、脚本操作、数据源、REST 消息函数、转换映射／条目、目录客户端脚本和字典计算／默认值），并获取表的完整自动化概况——所有操作都通过 Table API 以只读方式完成。servicenow_search_code 会返回每个工件中所有匹配的行（最多 20 行，并附带前后各一行上下文），与 servicenow_where_used 一样，支持可选的应用 scope。 servicenow_where_used 还会查找结构性引用——字典引用字段、列表和表单布局、目录变量、流程输入和报表——并在单独的 structural 部分中列出。
• 流程追踪与代码检查（Phase 8）：确定性地追踪表操作会触发的内容（flows 包——按顺序列出业务规则、流程、工作流和通知，并生成 Mermaid 流程图）；读取 Flow Designer 流程和运行历史；解释 Process Automation Designer 操作手册（servicenow_explain_flow 使用 kind: "playbook"——以 Mermaid 子图表示泳道，并列出活动、触发器和变体）；依据本地规则集检查脚本，并生成汇总代码健康报告（codecheck；设置 domains: true 可启用流程、Service Portal 和旧版工作流分析器）。通过 CI/CD API 运行 ATF 测试（atf，需选择启用，默认关闭——运行工具会在实例上执行）。
• 基于日志的撤销（revert）：列出本地写入日志，并撤销一项已应用的创建／更新／删除操作——同时检查后续编辑导致的偏移。
• 通用工件读取（artifacts，需选择启用）：列出并读取任何已注册的工件类型——包括带操作项的 UI 策略、带布局的门户页面、流程、目录条目等——并显示范围和 SDK 管理状态。
• 更新集支持（updatesets，需选择启用）：列出更新集，按工件汇总某个更新集，与另一个配置档案或快照进行比较——并将已应用的 Table 写入绑定到指定名称的更新集（update_set／SN_UPDATE_SET），之后恢复用户当前的更新集。
• 运维与数据健康（ops，需选择启用）：有界读取系统日志、调度器队列、出站电子邮件队列和信号量，以排查“为何变慢”；此外还提供 servicenow_check_data_health——通过 Aggregate API 统计单个表中的重复键、孤立引用和过期引用。
• 运维读取（需选择启用）：通过 sys_audit 和 sys_journal_field 查看记录的变更历史（history——包括 Table API 读取时为空的评论和工作备注）；查看经过机密遮罩且写入日志、可撤销的系统属性集合（properties）；以及查询用户／组／角色和成员关系（directory）。ATF 运行可以等待结果（wait_seconds），Import Set 插入操作会报告转换运行和映射。
• 自我文档化：本地 Markdown 知识库（读取／写入／搜索），以及确定性的 Mermaid 生成器（从引用生成 ER 图、从业务规则生成记录生命周期流程图），帮助服务端构建持久且可复用的上下文。
• 提示词：现成的工作流（事件分诊、变更影响分析、记录表文档、诊断实例性能问题、安全写入、偏移审查、架构影响、实例发现），用于编排各项工具；每个插件技能都有对应的提示词，供未安装插件的客户端使用。
• 工具包：通过 SN_TOOL_PACKAGES 仅加载所需的工具组（默认配置档案为 discovery；all 会启用全部工具）。
• 通过 HTTPS 使用 Basic 或 OAuth 2.0 身份验证；密码／令牌绝不会回显。
• 最小权限控制：表允许／拒绝列表，以及全局只读模式。
• 弹性保障：每请求超时、带退避和 Retry-After 的重试、SSRF 防护和结果大小限制。
• MCP 工具注解和资源、结构化错误载荷，以及输出到 stderr 的结构化日志。
• 凭据存储于环境文件（项目目录、~/.config 或 SN_ENV_FILE），并可在运行时通过 servicenow_set_credentials 更新。

要求

• Node.js 22.12+（强制要求：通过 engines 和带有明确提示信息的运行时检查；项目以 .nvmrc 中的版本为目标）。

设置

从源代码安装（用于开发）：

npm install
npm run build

或直接运行已发布的软件包，无需克隆：

npx servicenow-mcp-ai

在 MCP 客户端中安装

每个客户端都会启动相同的 stdio 命令 npx -y servicenow-mcp-ai（Node.js 22.12+），服务器名称为 servicenow。下面的一键链接和代码片段不包含任何凭据：请将凭据保存在环境文件中（~/.config/servicenow-mcp-ai/.env，参见配置凭据），运行一次性命令 npx servicenow-mcp-ai login 进行 OAuth 登录，或在连接服务器后让助手调用一次 servicenow_set_credentials。客户端配置中设置的实际环境变量会覆盖环境文件，因此只有在确有需要时才添加 env 代码块；切勿将 SN_PASSWORD 或其他机密写入你要分享或提交的客户端配置（参见 SECURITY.md）。

code --add-mcp '{"name":"servicenow","command":"npx","args":["-y","servicenow-mcp-ai"]}'
code-insiders --add-mcp '{"name":"servicenow","command":"npx","args":["-y","servicenow-mcp-ai"]}'

vscode:mcp/install?%7B%22name%22%3A%22servicenow%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22servicenow-mcp-ai%22%5D%7D
vscode-insiders:mcp/install?%7B%22name%22%3A%22servicenow%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22servicenow-mcp-ai%22%5D%7D

{
  "servers": {
    "servicenow": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "servicenow-mcp-ai"]
    }
  }
}

/plugin marketplace add IvanBBaev/servicenow-mcp-ai
/plugin install servicenow-mcp-ai

claude mcp add servicenow --scope user --env SN_INSTANCE=your-instance.service-now.com -- npx -y servicenow-mcp-ai

{
  "mcpServers": {
    "servicenow": {
      "command": "npx",
      "args": ["-y", "servicenow-mcp-ai"]
    }
  }
}

cursor://anysphere.cursor-deeplink/mcp/install?name=servicenow&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNlcnZpY2Vub3ctbWNwLWFpIl19

{
  "mcpServers": {
    "servicenow": {
      "command": "npx",
      "args": ["-y", "servicenow-mcp-ai"]
    }
  }
}

{
  "context_servers": {
    "servicenow": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "servicenow-mcp-ai"],
      "env": {}
    }
  }
}

{
  "mcpServers": {
    "servicenow": {
      "command": "npx",
      "args": ["-y", "servicenow-mcp-ai"]
    }
  }
}

codex mcp add servicenow --env SN_INSTANCE=your-instance.service-now.com -- npx -y servicenow-mcp-ai

[mcp_servers.servicenow]
command = "npx"
args = ["-y", "servicenow-mcp-ai"]
# Optional, non-secret only — secrets stay in ~/.config/servicenow-mcp-ai/.env:
# env = { SN_INSTANCE = "your-instance.service-now.com" }

更倾向于全局安装（npm install -g servicenow-mcp-ai）？在任意代码片段中，将 "command": "npx", "args": ["-y", "servicenow-mcp-ai"] 替换为 "command": "servicenow-mcp-ai"。MCP Inspector 的用法也相同： npx @modelcontextprotocol/inspector npx -y servicenow-mcp-ai。

一键链接由 scripts/install-links.mjs 根据 package.json 生成（运行 node scripts/install-links.mjs 可打印链接）；如果本 README 或文档网站与生成的字符串不一致，test/install-links.test.js 会报错。

通过 MCP bundle（.mcpb）安装

MCP bundle 是一个包含服务及其依赖项的 .mcpb 文件；Claude Desktop（或任何 MCPB 主机）可一键安装，无需使用 npm / npx。安装表单会要求填写连接密钥（仅 SN_INSTANCE 为必填项）和 SN_TOOL_PACKAGES；机密信息会标记为敏感数据（并保存在操作系统的密钥链中）。字段留空时会回退到环境文件。目前尚未发布（O-22）——使用 npm run mcpb:pack 构建（位于 dist/mcpb/；-- --validate 会运行官方验证器）。

Docker

仓库提供了一个多阶段 Dockerfile（精简版 Node 22 运行时，非 root 用户 uid 65532）。镜像中仅包含 npm pack 发布的内容和生产依赖，默认通过 0.0.0.0:3000 启动 HTTP 传输。目前尚未将镜像发布到镜像仓库，请在本地构建：

docker build -t servicenow-mcp-ai .

# Secrets as files (Docker / Kubernetes secrets), mounted read-only
mkdir -p secrets && printf '%s' 'your-password' > secrets/sn_password
openssl rand -hex 32 > secrets/sn_http_token

docker run --rm -p 127.0.0.1:3000:3000 \
  -e SN_INSTANCE=your-instance.service-now.com -e SN_USER=your.user \
  -e SN_PASSWORD_FILE=/run/secrets/sn_password \
  -e SN_HTTP_TOKEN_FILE=/run/secrets/sn_http_token \
  -v "$PWD/secrets:/run/secrets:ro" -v sn-data:/data \
  servicenow-mcp-ai

• 任何非回环地址绑定都必须设置 SN_HTTP_TOKEN。 镜像绑定到 0.0.0.0，以便已发布的端口正常工作；如果未设置令牌（或 OAuth），服务将拒绝启动（3.0，B6）。设置 SN_HTTP_REQUIRE_TOKEN=0 可让服务在发出警告后启动；此时，任何能访问该端口的客户端都可以使用已配置的凭据操作你的实例。客户端需发送 Authorization: Bearer <token>；请在容器前终止 TLS。
• 使用 OAuth 代替共享令牌（N-17）： 设置 SN_HTTP_OAUTH_ISSUER（你的 OIDC 提供商）和 SN_HTTP_OAUTH_RESOURCE（此服务的公开 URL，例如 https://mcp.example.com/mcp）。客户端会从 /.well-known/oauth-protected-resource 发现发行方，并发送其 JWT 访问令牌；令牌的受众必须为该资源。可选设置：SN_HTTP_OAUTH_SCOPES、SN_HTTP_OAUTH_AUDIENCE、SN_HTTP_OAUTH_JWKS_URI。如果发行方提供不透明令牌，请设置 SN_HTTP_OAUTH_INTROSPECTION_URI 及其客户端 ID 和密钥（RFC 7662）。默认情况下，实例仍使用已配置的服务帐户调用。
• 按用户访问 ServiceNow（N-17 第 2 阶段）： 添加 SN_HTTP_OAUTH_USER_TOKENS=true、32 字节的 SN_HTTP_OAUTH_TOKEN_KEY（base64 或 hex，例如 openssl rand -base64 32），并在实例上创建 OAuth 客户端（设置 SN_OAUTH_CLIENT_ID / SN_OAUTH_CLIENT_SECRET，并启用刷新令牌），其重定向 URL 需为 SN_HTTP_OAUTH_RESOURCE 源上的 /oauth/servicenow/callback。用户首次调用时，会收到指向实例登录页面的链接（URL 引导；2025 会话会收到 -32042，不支持 URL 引导的客户端和后台任务会收到包含该链接的错误）。用户登录后，服务会检查帐户的 sys_user 字段是否与令牌声明匹配（SN_HTTP_OAUTH_USER_MATCH，默认值为 email=email），使用 AES-256-GCM 加密刷新令牌并保存在 SN_HTTP_OAUTH_TOKEN_STORE 中；此后会以该用户身份调用实例，因此 ServiceNow ACL 会按用户生效。用户可通过 DELETE /oauth/servicenow/link 删除自己的关联（使用其 bearer 令牌；响应为 { unlinked, revoked }）；服务也会尽力在实例上撤销刷新令牌。共用一个 SN_HTTP_OAUTH_RESOURCE 的副本，只要共享 SN_HTTP_OAUTH_TOKEN_KEY 和存储区，就都可以完成关联。限制：使用 SN_HTTP_TOKEN 授权的请求仍使用共享凭据。
• /data 存放文档目录（SN_DOCS_DIR=/data/docs）和环境文件（SN_ENV_FILE=/data/.env）；请在此处挂载卷以保留这些文件。
• 每个 <KEY>_FILE 密钥来源均在从文件读取密钥中说明。
• 对于通过 stdio 启动容器的 MCP 客户端，请传入 -i -e SN_TRANSPORT=stdio（docker run --rm -i -e SN_TRANSPORT=stdio -e SN_INSTANCE=… servicenow-mcp-ai）。
• HEALTHCHECK 是 TCP 存活探针。GET /healthz（存活）和 GET /readyz（已配置凭据）无需令牌即可响应，供编排探针使用；GET /readyz?probe=1 还会调用实例，并且与所有 MCP 路由一样，需要通过令牌验证。设置 SN_HTTP_ALLOWED_HOSTS 为客户端使用的名称，以便在绑定到 0.0.0.0 时检查 Host 标头。
• smithery.yaml 为 Smithery 描述了相同的镜像（stdio，配置键映射到 SN_* 设置）。

HTTP 传输：会话、探测与关闭

设置 SN_TRANSPORT=http 后，每个 MCP 会话（一次 initialize）都会获得自己的服务：

• 每会话状态。 启用的包、MCP 日志级别、列表变更通知、计划令牌、任务和写入上限均属于会话。连接池、OAuth 令牌和架构缓存由各会话共享，并按配置文件 + 主机进行键控。
• servicenow_use_instance 在 HTTP 下按会话生效。 它只切换调用该工具的会话所用的配置文件；其他会话保留各自的配置，且不会写入任何内容。传入 persist: true，还会将 SN_ACTIVE_PROFILE 写入环境变量文件（并记录日志）——这会更改尚未切换配置文件的会话所用的默认值。使用 stdio 时，切换会持续到进程退出；persist: true 也会将其写入文件（3.0，B12）。
• 生命周期。 会话在收到 DELETE 或空闲达到 SN_HTTP_SESSION_TTL_SEC 后结束（默认 30 min）；使用已结束会话 ID 的请求会收到 404，客户端随后会重新初始化。同时最多可有 SN_HTTP_MAX_SESSIONS（64）个会话处于打开状态。
• DNS 重绑定防护。 Host 标头必须与 SN_HTTP_ALLOWED_HOSTS 匹配（默认值：绑定到环回地址时使用的环回名称），浏览器的 Origin 必须与 SN_HTTP_ALLOWED_ORIGINS 匹配（默认值：环回源）；否则返回 403。
• 探测。 服务运行时，GET /healthz → 200 {"status":"ok"}。已配置凭据时，GET /readyz 返回 200，否则返回 503。两者均无需令牌即可响应。GET /readyz?probe=1（需要令牌）还会读取一行 sys_user 记录；实例无法访问时返回 503。结果会缓存 5 s。
• 关闭。 收到 SIGTERM / SIGINT 后，监听器停止接受连接，新请求返回 503，正在运行的工具调用最多有 5 s 完成；之后所有会话都会关闭，进程以 0 退出。
• 保活。 打开的 SSE 流会每隔 SN_HTTP_KEEPALIVE_MS（25 s）收到一条注释。

快速入门

最快的方式是使用三行 Basic auth — 在环境变量文件或真实环境中设置以下变量，即可连接：

SN_INSTANCE=dev12345.service-now.com
SN_USER=your.username
SN_PASSWORD=your-password

其他设置均为可选调优；其余内容请参阅完整的环境变量参考。

快速试用后，建议使用 OAuth，而不是存储密码。 对于共享或长期使用的场景，请改为运行一次性命令 npx servicenow-mcp-ai login——它存储的是刷新令牌，而不是密码。请参阅配置凭据 → OAuth 2.1。

验证设置

设置好这三个变量后，请在开始前确认连接：

1. 运行 servicenow_test_connection 工具——它会读取一条 sys_user 记录，并报告 ok、HTTP 状态和延迟。
2. 运行 servicenow_check_capabilities——它会预览已连接用户实际可以读取的、受管理员限制的 sys_* 表。

或者，在 shell 中一次性完成这两项：

npx servicenow-mcp-ai doctor   # checks credentials, reachability and capabilities

希望通过提示完成设置？运行 npx servicenow-mcp-ai init，按提示输入实例、认证方法和凭据；该命令会写入环境变量文件并运行 doctor——请参阅命令行界面。

配置凭据

凭据保存在 ~/.config/servicenow-mcp-ai/.env 中（或由 SN_ENV_FILE 指定的文件中）：

SN_INSTANCE=your-instance.service-now.com
[email protected]
SN_PASSWORD=your-password

SN_INSTANCE 接受 dev12345、dev12345.service-now.com 或完整的 https:// URL。

你也可以在运行时调用 servicenow_set_credentials 工具来设置或更改凭据——新值会直接写回 env 文件。 将已配置的配置档迁移到其他实例时，必须在同一次调用中提供 user 和 password（存储的密钥绝不会发送到其他主机），并且客户端必须确认此更改——不支持征询的客户端会被拒绝，除非设置了 SN_ALLOW_UNCONFIRMED_CREDENTIAL_CHANGE=1。

该工具还会设置身份验证方式（auth）、OAuth 客户端 ID（oauth_client_id）和授权类型（oauth_grant）。密钥——API 密钥和 OAuth 客户端密钥——绝不会作为工具参数传递：将它们列在 request_secrets 中，服务端会通过征询提示词索取，因此它们不会出现在已记录的工具调用、结果或写入日志中。不支持征询的客户端会被拒绝（上述退出选项不适用于密钥）；请改为在 env 文件中设置这些密钥。实例变更规则取决于最终的身份验证方式：API 密钥配置档需要新的 API 密钥，OAuth client_credentials 配置档需要新的客户端密钥，OAuth password 授权类型需要 user、password 和客户端密钥，Basic / none 需要 user 和 password；使用 bearer-token、refresh_token 和 jwt_bearer 的配置档无法通过此工具迁移。

servicenow_get_status（authWarnings）、servicenow_list_instances 和 doctor 会根据每个配置档自身的身份验证方式进行检查——API 密钥配置档不需要密码——并报告身份验证方式、OAuth 授权类型、刷新令牌状态和写入模式，但绝不报告密钥值。当刷新令牌授权类型返回轮换后的刷新令牌时，该令牌会写回读取它时所用的 env 键；如果无法写入 env 文件，新令牌会保存在内存中（重启后丢失），并记录警告，该警告也会显示在 get_status / doctor 中。服务端写入的值会保留 Windows 路径原样（反斜杠会用单引号括起），CRLF 格式的 env 文件也会继续保持 CRLF。在 Windows 上，env 文件会继承其所在文件夹的 ACL——请自行限制权限（例如 icacls .env /inheritance:r /grant:r "%USERNAME%:F"）；服务端只会发出警告，绝不会运行 icacls。

env 文件按以下顺序解析：先检查 SN_ENV_FILE，然后检查 ~/.config/servicenow-mcp-ai/.env（XDG）。项目根目录中的 .env 已弃用（3.0，B5）：如果该文件存在，且上述两个位置均未使用，仍会读取它，并在启动时提示应将其移至何处。 因此，全局 / npx 安装会将文件写入用户配置目录，而不是 node_modules。实际环境变量始终优先于文件中的值。

首次运行：模型自行配置

在 initialize 时，服务端会根据实时配置发送 instructions：启用的包和工具数量、写入模式、活动配置档；如果尚未配置任何内容，还会说明缺少什么以及如何修复——此外还会提供关于提示词、参考资源和大结果处理（分页、format "file"）的指引。在此之前，每个实例工具都会失败，并返回 code: "NOT_CONFIGURED"，以及一条指出 servicenow_set_credentials 的提示。使用空 env 文件启动的首个会话如下所示（节选）：

instructions  Credentials: NOT configured (missing instance, user, password). Instance tools
              fail with code NOT_CONFIGURED until fixed. To configure: ask the user for
              the instance and credentials, call servicenow_set_credentials, then
              servicenow_test_connection. Never guess or echo a password.
user          How many open P1 incidents do we have?
model         Which instance, user and password should I connect with?
user          dev12345, admin, ••••••
tool call     servicenow_set_credentials { instance: "dev12345", user: "admin", password: … }
tool result   { message: "Credentials saved", profile: "default", configured: true, password: "***" }
tool call     servicenow_test_connection {}
tool result   { ok: true, … }
tool call     servicenow_aggregate { table: "incident", query: "active=true^priority=1" }
model         There are 7 open P1 incidents.

servicenow_get_status 随后会显示实时状态：服务端版本、运行时间和传输方式、policy.summary、限制、脱敏设置、文档目录、写入计数器、配置档来源以及 profileDetails（每个配置档的身份验证模式、写入模式和缺失的键）——但绝不包含密钥值。

OAuth 2.1（Authorization Code + PKCE）— 推荐

在 ServiceNow 中注册一个 Authorization Code OAuth API 端点，并设置 loopback 重定向 URL（例如 http://localhost:53682/callback），设置 SN_OAUTH_CLIENT_ID（对于机密客户端，还需设置 SN_OAUTH_CLIENT_SECRET）， 然后运行一次性交互式登录：

npx servicenow-mcp-ai login

浏览器会打开，批准授权后，获取的 refresh token 会存储在环境文件中。随后服务将以非交互方式运行（refresh_token grant）—— 不会存储密码。始终使用 PKCE（S256）。

OAuth 2.0 password grant（ROPC）已在 OAuth 2.1 中弃用，且在许多实例上已禁用；请优先使用 login。client_credentials 和 refresh_token grant 仍支持服务帐户。请参阅 .env.example。

支持的身份验证方法

ServiceNow 提供的所有入站 REST 身份验证方法均已涵盖：

环境变量

所有设置均从环境文件（SN_ENV_FILE，否则为 ~/.config/servicenow-mcp-ai/.env）或实际进程环境中读取，后者优先级更高。只有前三项为必填项，其余均为可选的调优参数。 请参阅 .env.example 获取模板。启动时会验证每个值：无效值会导致服务停止，并显示列出所有问题键的错误 （3.0，B5）；或者，如果设置了 SN_STRICT_SETTINGS=0，则会记录为警告，并继续使用该设置的默认值。

这些表格由设置清单 （src/core/settings-manifest.ts）生成 — 编辑清单，然后运行 npm run docs:env。

连接与身份验证

实例及其凭据。始终只需要 SN_INSTANCE；除非通过 SN_AUTH 指定身份验证方法，否则会根据现有密钥自动检测（API 密钥 → bearer 令牌 → OAuth → Basic）。

文件中的机密

容器机密（D-5）：<KEY>_FILE=/path 会在启动时从该文件加载 <KEY>（去掉一个末尾换行符）。同时设置 <KEY> 和 <KEY>_FILE 会导致启动错误；文件不可读或为空也会导致启动错误。以这种方式加载的值不会写回环境文件。每个配置文件的 ServiceNow 机密：SN_PROFILE_<NAME>_<KEY>_FILE。

配置文件与环境文件

未加前缀的 SN_INSTANCE / SN_USER / SN_PASSWORD 键属于“default”配置文件。更多实例通过 SN_PROFILE__* 键配置；使用 SN_ACTIVE_PROFILE 或 servicenow_use_instance 工具切换。

网络、TLS 与弹性

超时、重试、主机允许列表、出站代理、双向 TLS 以及每主机队列和断路器。这些设置适用于服务的所有 REST 客户端。代理和双向 TLS 需要可选的 undici 软件包。

工具包

已注册的工具。管理工具（set_credentials、get_status、use_instance）始终启用。

访问策略与写入安全

最小权限表策略、先规划后应用的写入流程、破坏性写入确认、每会话上限、生产环境配置文件、更新集绑定，以及上传、邮件和 SDK 管理范围的防护措施。

结果、脱敏与导出

结果大小预算、输出整形、记录值脱敏、写入日志和 CSV 导出安全性。

缓存

用于读取架构的缓存，以及能力 / 插件 API 探测缓存。

文档存储和图表

本地 Markdown 文档存储（也是写入日志的存放位置——请勿纳入版本控制）以及生成的 Mermaid 图表。

HTTP 传输

stdio（默认，单个本地客户端）或用于远程客户端和 Agent 客户端的 Streamable HTTP。HTTP 端点的安全防护（TLS、身份验证、网络）由运营者负责。

日志记录

stderr 日志、可选的日志文件，以及镜像到 MCP 客户端的日志行。

设置验证

每项设置都会在启动时验证。无效的安全设置值会导致启动错误；无效的调优设置值会作为警告记录，且设置保留默认值（参见 SN_STRICT_SETTINGS）。

标准变量

SN_ 命名空间之外，服务也会遵循的常规变量。

从文件读取密钥

每项密钥设置都可以从文件读取，遵循 Docker、Compose / Swarm 和 Kubernetes 密钥的惯例：将 <KEY>_FILE 设为路径，服务器会在启动时从该文件加载 <KEY>。这适用于 SN_PASSWORD、SN_API_KEY、SN_BEARER_TOKEN、SN_OAUTH_CLIENT_SECRET、SN_OAUTH_REFRESH_TOKEN 和 SN_HTTP_TOKEN，也适用于各配置文件对应的形式（SN_PROFILE_PROD_PASSWORD_FILE、SN_PROFILE_PROD_API_KEY_FILE，……）。

• 会去掉一个末尾换行符，因此 echo secret > file 可正常使用；其他空白字符会保留。
• 同时设置 <KEY> 和 <KEY>_FILE 会导致启动错误，并指出冲突的设置对——服务器绝不会静默选择其中一个。
• 文件不可读或为空会导致启动错误，并指出设置名称和原因，但绝不泄露文件内容。
• 从文件加载的值绝不会写回环境文件：servicenow_set_credentials 和 OAuth 刷新令牌轮换会拒绝持久化该值（轮换后的刷新令牌会保留在内存中，并显示警告）——请更新文件。
• 现有文件设置的含义保持不变：SN_TOKEN_FILE（收到 401 时重新读取的 bearer token）、SN_OAUTH_JWT_KEY_FILE 和 SN_TLS_*_FILE PEM 路径，都是由服务器自行读取的路径，而非 <KEY>_FILE 来源。

双轴访问策略

访问权限由两个独立的轴控制：表和工具包。

自 H-4 起，由插件提供支持的工具（Change、Catalog、Knowledge、Email、ATF）和附件（通过父记录的表）也遵循表轴策略；工具包轴仍会移除整个功能面。完整模型（包括 Batch API 如何同时遵循两个轴）请参阅安全说明。

列表语法：表列表（SN_TABLES_ALLOW / SN_TABLES_DENY）以逗号分隔；工具包列表（SN_TOOL_PACKAGES、SN_PACKAGES_DENY、SN_PACKAGES_READONLY）接受逗号或空白字符。两者都会去除首尾空格，且表名匹配不区分大小写——因此 SN_TABLES_DENY=Change_Request, sys_user 可以正常使用。自 H-11 起，表项可以是模式（* 表示任意长度的字符序列，? 表示一个字符）：SN_TABLES_DENY=sys_* 会阻止 sys_user，但不影响 incident。匹配顺序为：精确拒绝、精确允许、模式拒绝、受保护的表（写入；自 3.0 起需要调用自身设置 apply: true——SN_PROTECTED_TABLES_WRITE=confirm；deny 会拒绝访问，allow 会解除此规则），然后是允许列表中的模式。调用 servicenow_explain_policy({table, action}) 查看由哪条规则决定，或读取 servicenow://policy。

运行 / 调试

• VS Code：打开命令面板，启动 .vscode/mcp.json 中定义的服务器，然后在 Chat 中使用。
• MCP Inspector：npm run inspector
• 直接运行：npm start

可观测性

• 状态。 servicenow_get_status 包含一个 observability 区块：每个工具的 {count, errors, p50, p95, totalMs}（各工具最近 256 次调用的百分位数，单位为 ms —— 内存占用保持有界），以及结果大小 {bytesTotal, textBytes, structuredBytes, bytesP50, bytesP95}（文本块和 structuredContent 的 UTF-8 字节数，即每个工具的网络传输开销）、架构缓存命中数/未命中数、每个主机的重试计数器、 队列限制和占用情况、熔断器状态，以及每个主机最近发送的 X-RateLimit-* 标头。它绝不会调用实例。

• 日志。 日志仅写入 stderr（stdout 用于 MCP 协议）。SN_LOG_FORMAT=text 可将 JSON 行切换为人类可读的格式；SN_LOG_FILE 还会将 JSON 行追加到按大小轮转的文件中。所有输出目标中的凭据字段（password、token、 authorization 等）都会被遮盖，此外还会应用 SN_REDACT_FIELDS / SN_REDACT_PII 规则以及机密列遮盖。

• 追踪钩子。 每次工具调用和请求循环都会通过 node:diagnostics_channel 发布消息，因此 OpenTelemetry（或任何）订阅者都可以接入，无需依赖此服务。 只有在某个通道存在订阅者时才会构建消息：

  通道	时机	消息字段
  servicenow-mcp:mcp.tool.call.start	工具调用开始	id、tool、package、requestId，以及已知时的 sessionId / traceparent / tracestate
  servicenow-mcp:mcp.tool.call.end	返回成功结果	起始字段，以及 profile、outcome（ok）、ms、resultBytes
  servicenow-mcp:mcp.tool.call.error	返回错误结果或抛出异常	起始字段，以及 profile、outcome（error / cancelled）、ms，以及 code / resultBytes 或 errorName
  servicenow-mcp:http.request.start	逻辑请求开始	id、system、method、host、telemetryKey、url，以及调用中的 profile / requestId / sessionId / tool / callId / traceparent / tracestate
  servicenow-mcp:http.request.end	收到成功响应并完成	起始字段，以及 status、attempts、ms
  servicenow-mcp:http.request.error	请求失败	起始字段，以及 attempts、ms、status、code、errorName、errorMessage
  servicenow-mcp:http.request.retry	重放一次尝试（退避、401 重新认证）	id、system、method、host、url、attempt、reason、waitMs

  url 绝不包含查询字符串；绝不会发布标头、正文和凭据，并且 errorMessage 会遵循脱敏规则。

  绝不会发布工具参数和结果（只发布结果的字节数）。 HTTP 消息中的 callId 是发起该请求的工具调用的 id。 traceparent / tracestate 是客户端在调用的 params._meta 中发送的 W3C Trace Context；格式错误的值会被丢弃。

• OpenTelemetry span。 SN_OTEL=1 会通过 @opentelemetry/api 将这些通道映射为 span。它是可选的对等依赖（在服务旁边运行 npm install @opentelemetry/api，并通过 node --import 注册你的 SDK 和导出器）。如果未安装此包，服务会记录一条警告并在不生成 span 的情况下运行；如果关闭 SN_OTEL，则不会加载此包。

  • 每次工具调用都会生成一个名为 tools/call <tool> 的 SERVER span；如果客户端发送了 traceparent，此 span 会作为其子 span。属性包括：mcp.method.name、gen_ai.operation.name（execute_tool）、gen_ai.tool.name、jsonrpc.request.id、mcp.session.id、network.transport、error.type，以及 servicenow_mcp.package / .profile / .outcome / .result.bytes。
  • 每个出站请求都会生成一个以方法命名的 CLIENT span，作为其工具 span 的子 span；属性包括：http.request.method、server.address、url.full（不含查询字符串）、http.response.status_code、http.request.resend_count、error.type，并且每次重放都会生成一个 retry 事件。
  • MCP 和 GenAI 语义约定仍在开发中，因此这些名称是暂定的，可能会随规范变更。
  • SN_OTEL_PROPAGATE=1（默认关闭）还会在向 ServiceNow 实例发送的请求中加入 traceparent / tracestate 标头：如果启用了 SN_OTEL，则使用 HTTP span 的上下文；否则，原样使用客户端的上下文。此功能需要显式启用，因为它会将 trace ID 发送给实例；OAuth 令牌端点不会收到这些信息。

• Prometheus。 使用 HTTP 传输时，设置 SN_METRICS=1 和 SN_HTTP_TOKEN 后，GET /metrics（使用相同的 bearer token）会以 Prometheus 文本格式提供相同的指标（servicenow_mcp_* 指标族，仅按 tool / host 标记）。未设置令牌时，该端点会保持关闭状态，并记录一条警告。

命令行界面

已发布的 servicenow-mcp-ai 二进制文件（直接运行或通过 npx servicenow-mcp-ai 运行）在未指定命令时会启动 MCP 服务；否则会运行下列命令之一并退出。连接设置来自环境变量 / env 文件（参见环境变量）。servicenow-mcp-ai --help 会列出所有内容；--version 会输出版本。未知命令或选项会将用法说明输出到 stderr，并以 2 退出——绝不会启动服务。

init 使用与 servicenow_set_credentials 相同的原子写入器写入环境文件，该写入器仅允许文件所有者访问（0600）。文件路径由 doctor 指出（默认为 ~/.config/servicenow-mcp-ai/.env）。它会依次询问：实例（dev12345 或完整主机名；自定义域名需要设置 SN_ALLOWED_HOSTS）、身份验证方式 （basic / oauth / apikey / token），然后询问该方式的设置——对于 oauth，还会询问授权类型（client_credentials、password 或 authorization_code；选择最后一种时会提示运行 login）。绝不会回显或记录机密；摘要中只会列出键名。使用 --profile qa 时，键会写入为 SN_PROFILE_QA_*。只有在输入 y 后，才会覆盖现有配置文件。可以按每行一个答案的方式通过管道传入答案，CI 和测试就是这样驱动此命令的：

printf 'dev12345\nbasic\nalice\n%s\n' "$SN_PASSWORD" | npx servicenow-mcp-ai init

如果没有终端且未通过管道传入答案，init 会拒绝执行（退出代码为 2），并且不会写入任何内容。 doctor 会打印纯 ASCII 文本（使用 [ok] / [x] 代替勾号）：使用 --ascii 时、标准输出不是终端时，以及在 Windows Terminal 之外的 Windows 环境中。 --json 则会打印单个 JSON 文档，包含 envFile、status、summary、 checks[]（name、ok、detail）、config、connection、capabilities 和 serverStatus（servicenow_get_status 的载荷）——例如 servicenow-mcp-ai doctor --json | jq .checks。退出代码相同。

support-bundle 会收集 doctor --json 载荷、所有 SN_* 设置（将机密内容遮蔽为 ***）、npm ls --omit=dev（尽力执行）、工具清单摘要（版本、工具和软件包数量、启用的工具），以及 SN_LOG_FILE 已设置时该文件末尾的 200 行。所有被遮蔽的值也会从整个文件中清除。默认路径为 ./servicenow-mcp-ai-support-<timestamp>.json（模式为 0600）。实例名和用户名不会被遮蔽——将文件附加到问题报告前，请先检查文件内容。

migrate 会升级 2.x 安装的设置。它会读取服务解析到的 env 文件（或 --from <file>），但不会加载该文件；因此，即使 3.x 会拒绝该文件，迁移仍会继续，并保留所有键、值和注释，以下情况除外：

• 项目根目录中的 .env（已弃用，B5）或 --from 指定的文件会复制到 ~/.config/servicenow-mcp-ai/.env（或 SN_ENV_FILE）；原文件会保留；
• 名为 capabilities、docs、policy、profiles、reference、 schema 或 status 的配置文件（保留名称，B13）会改名为 <name>_v2，其所有 SN_PROFILE_<NAME>_* 键和 SN_ACTIVE_PROFILE 也会相应更新，其文档和写入日志文件夹 <SN_DOCS_DIR>/<name> 也会随之改名（相对路径的 SN_DOCS_DIR 会以运行 migrate 的目录为基准解析；如果 <name>_v2 文件夹已存在，则不会覆盖）；
• 3.x 在启动时会拒绝的值（B5）会被注释掉，因此会应用默认值，与 2.x 中的行为一致；
• KEY: value 行（2.x 解析器接受、3.x 跳过）会转换为 KEY=value；
• 除非文件已设置 SN_COMPAT=2 或指定了 --v3-defaults，否则会追加 SN_COMPAT=2。

MCP 客户端 env 块中的设置会优先于 env 文件传递给服务，因此 migrate 还会在 Claude Desktop、Claude Code（~/.claude.json、.mcp.json）、Cursor、VS Code（用户级和 .vscode/mcp.json）以及 Windsurf 配置文件中查找此服务，并对设置了 SN_* 键的 env 块应用相同规则（无效值会被移除）。含有注释的文件会被报告，但不会被重写；VS Code 的 envFile 会列出名称，以便你对其运行 migrate --from。重写后请重启客户端。

使用 --write 时，每个被就地重写的文件都会先复制为 <file>.v2.bak（0600）；env 文件的模式也会设为 0600，客户端文件则保留原有模式。升级后运行一次：

npx servicenow-mcp-ai migrate          # review the plan
npx servicenow-mcp-ai migrate --write  # apply it

login 会针对当前启用的配置文件（SN_ACTIVE_PROFILE，默认值为 default）运行，并读取该配置文件的以下设置：

• SN_INSTANCE — 必需；目标实例。
• SN_OAUTH_CLIENT_ID — 必需；Authorization Code OAuth API 端点的客户端 ID。
• SN_OAUTH_CLIENT_SECRET — 可选；用于机密客户端。
• SN_OAUTH_REDIRECT_URI — 可选；环回 URL，默认值为 http://localhost:53682/callback。必须与端点上注册的重定向 URI 匹配。
• SN_OAUTH_SCOPE — 可选；请求的 OAuth 范围。

成功后，会将 SN_AUTH=oauth、SN_OAUTH_GRANT=refresh_token 和 SN_OAUTH_REFRESH_TOKEN 写回 env 文件（当前配置文件不是 default 时，会使用带配置文件前缀的键）。如果浏览器未自动打开，授权 URL 会打印到 stderr。

drift 接受两个位置参数作为配置文件名称；每个名称都必须解析为已配置的配置文件（SN_PROFILE_<NAME>_*，或 default 对应的裸 SN_INSTANCE / SN_USER / SN_PASSWORD 键）。Markdown 报告会写入标准输出（可将其保存为 CI 工件）；一行式偏差摘要会写入 stderr。

CI 偏移门禁（DF-3）

比较两个已配置的配置档，在配置出现偏移时使流水线失败：

servicenow-mcp-ai drift dev prod   # report on stdout; exit 1 on drift, 0 if clean, 2 on error

报告会将每个变更的脚本显示为 diff 块。CLI 会比较表、列、脚本、插件和应用；记录分区（servicenow_compare_instances 上的 sections）为可选项，因此退出码不会改变。

servicenow_snapshot_instance 会将相同内容写入文档文件夹，每个分区一个文件，每次最多处理四个分区。运行中断时，会在 index.json 中标记为 partial；使用 resume: true 重新运行，即可跳过文件未变更的所有分区。

开发

npm run check     # full gate: build, lint, format check, coverage-gated tests, tarball guard, prod audit
npm test          # unit tests only (node:test; needs a prior npm run build)
npm run lint      # ESLint (flat config + typescript-eslint)
npm run format    # format with Prettier

有关约定（每项任务提交一个 commit、随变更提交测试、生成文档），请参阅 CONTRIBUTING.md。

工具

完整参考文档涵盖每个参数、输出字段、各工具的写入方式以及错误码，位于 docs/tools/，每个软件包对应一个页面。docs/llms-full.txt 将本 README、SECURITY.md 和该参考文档合并到一个文件中，供大模型上下文使用。

tools/list 中的每个 inputSchema 和 outputSchema 都采用 JSON Schema 2020-12 编写，这是 MCP 的默认方言，且不包含 $schema 字段。服务不支持其他方言，也不会读取客户端提供的架构。

此表由工具注册信息生成——请编辑 src/tools/ 中的工具定义，然后运行 npm run docs:readme。每个工具名称都带有 servicenow_ 前缀，下文省略该前缀。

所有工具均带有 MCP 注解（readOnlyHint、destructiveHint、 idempotentHint），以便客户端应用恰当的确认交互体验。

工具名称（v3）

每个工具都采用 servicenow_<verb>_<noun> 命名。参数遵循一套统一词汇：sys_id 是记录 ID，table 是表名（CMDB 工具仍接受 class_name 作为已弃用的别名），fields 是要返回的列列表，values 是写入负载。3.0 版重命名了这些工具：

由 src/mcp/naming.ts 中的 TOOL_RENAMES 生成 — 更改后运行 npm run docs:readme。

2.x 客户端仍可正常工作：每个旧名称仍会通过 tools/call 响应，作为新工具隐藏且已弃用的别名，并接受旧参数名称，且不会占用 tools/list 名额。设置 SN_LEGACY_TOOL_NAMES=1，即可在一个次要版本发布周期内同时在 tools/list 中列出这些别名，并接受旧参数名称（attachment_sys_id、item_sys_id、 catalog_sys_id、test_sys_id、suite_sys_id、staging_table、作为写入负载的 fields、 attributes）。每次使用都会记录一条弃用警告。工具清单会列出重命名映射（toolRenames）以及每个工具接受的别名。

迁移期间若要保持所有 2.x 默认行为，请设置 SN_COMPAT=2：未设置的选项将按 2.x 的方式处理（受保护的表可写入、没有 plan token、允许未映射的批次行、列出旧名称、使用 core 软件包集）。显式设置仍优先生效。

工具包

工具按包分组，因此你可以只向特定客户端公开所需的工具 （工具越少，模型越专注）。将 SN_TOOL_PACKAGES 设置为以逗号或空格 分隔的配置文件或包名称列表：

• discovery（默认）——table、schema、aggregate，以及始终启用的 管理工具；对于其他任何工具，servicenow_find_tools 会指出其所属的包。 core（2.x 默认配置）是在 discovery 的基础上加上 attachment（B20）。
• all——以下所有包。
• 单个包：table、schema、aggregate、attachment、 importset、batch、catalog、change、knowledge、cmdb、scripts、 flows、codecheck、docs、instance、email、atf、revert、 artifacts、updatesets、ops、history、properties、directory、ui。

管理工具（servicenow_set_credentials、servicenow_get_status、 servicenow_enable_package 以及管理包中的其他工具）始终会被注册， 无论当前启用了哪些包。未知名称会被忽略。 servicenow_get_status 会报告解析后的 enabledPackages。

# Only table + batch tools (plus the always-on admin tools)
SN_TOOL_PACKAGES=table,batch

预设

如果你不想自行整理列表，三个命名预设涵盖了常见角色。管理工具始终启用，因此不会列出。每个预设 还有一个单词别名——SN_TOOL_PACKAGES=reader|developer|admin—— 会展开为相同的包集合。

developer 预设以 reader 集合为基础；docs 包包含 Mermaid 图表生成器。可以使用别名以简化配置，也可以逐一列出包，以添加或移除某个包。

运行时切换包

客户端无需重启即可扩展或收缩可用功能： servicenow_list_packages 会显示本次会话中每个包及其状态（已启用、已配置、已拒绝、只读、工具数量），而 servicenow_enable_package / servicenow_disable_package 可切换单个包。服务端会通过 notifications/tools/list_changed 通知变更（提示词和资源变更时也会发送相应通知），每次切换会为每个列表发送一条通知。 切换操作不会超出策略限制：SN_PACKAGES_DENY 中的包会被拒绝（PACKAGE_DENIED），SN_PACKAGES_READONLY 中的包只会启用其读取工具，管理工具则无法禁用。切换仅在当前会话中有效；HTTP 会话关闭后会恢复为 SN_TOOL_PACKAGES 的设置。除非客户端调用这些工具，否则不会发生任何变化。

服务端还会声明 resources.subscribe：在调用 servicenow_use_instance 或 servicenow_set_credentials 后，服务端会发送 notifications/resources/list_changed，并向订阅者发送 notifications/resources/updated，通知其 servicenow://status 资源已更新。

按键值插入或更新

servicenow_upsert_record({table, key, fields}) 会创建或更新一条由 key 匹配的记录；key 是一个或多个字段/值对的精确匹配（例如 {"u_external_id": "A-17"}；空字符串匹配空字段）。没有匹配项时，会使用键和值字段创建记录；恰好有一条匹配项时，会更新该记录；如果有多条匹配项，则会拒绝操作并返回 AMBIGUOUS_KEY。如果用户无法读取匹配到的记录，也会拒绝操作，因为创建另一条记录会造成重复。

操作类型在计划中决定：如果没有 apply:true，工具会返回 create 或 update（包含 sys_id 和 before 值），以及 apply_with: {expected_action, expected_sys_id}。将这些值传回并设置 apply:true；如果此时键解析出的结果发生变化（记录出现、消失或换成了另一条记录），调用会失败并返回 STALE_RECORD，且不会写入任何内容。 已应用的写入会记录为创建或更新，因此 servicenow_revert_write 可以像撤销直接调用 create_record / update_record 一样撤销它。

撤销写入（基于日志的还原）

每次已应用的写入都会记录在本地、采用哈希链的写入日志中 （<SN_DOCS_DIR>/<profile>/write-journal.jsonl）。选择启用的 revert 软件包可用该日志撤销写入：

• servicenow_list_writes — 按时间从新到旧列出日志，并可按 profile、table、since（ISO 日期/时间）、result 和 action 筛选。每行包含条目 id，以及该行是否单独满足还原条件（revertible + reason）。
• servicenow_revert_write — entry_id → 通过 Table API 执行逆向写入：update 会将日志中记录的 before 值写回；create 会删除记录；delete 会根据其 before 记录重新创建记录（丢弃系统字段，并请求使用原始 sys_id；结果会报告 sys_id_preserved）。与所有写入工具一样，它遵循计划/应用流程：如果没有 apply:true，它会返回逆向操作、记录当前状态和漂移检查结果，不会更改任何内容。

安全规则：

• 漂移检查。 将记录的 sys_mod_count 与日志中记录的写入所留下的值（after_mod_count，或 before.sys_mod_count + 1）进行比较；如果没有可用的计数，则改为比较已写入的字段值。如果记录之后发生了变化，或者无法进行比较，则会拒绝还原并返回 STALE_RECORD；传入 force:true 可强制覆盖（还原对应的日志行会记录 force: true）。
• 如果条目未知、日志链断裂、写入未处于 applied 状态、该行没有 before 状态、before 值已被脱敏（SN_REDACT_FIELDS / SN_REDACT_PII）、条目已还原，或其来源没有安全的逆向操作，则返回 NOT_REVERTIBLE，并附带原因：附件上传/删除、send_email、导入集行、目录订单、Batch API 子请求、ATF 运行、CMDB 创建（IRE 可能匹配到了现有 CI）以及本地/配置条目。脱敏值绝不会以 [redacted] 的形式还原：整个条目都会被拒绝还原，不会部分还原——请手动恢复这些字段。
• 还原操作本身也会记入日志（reverts: <entry_id>、tool: servicenow_revert_write），因此还原还原操作即可重做。策略与直接写入相同：适用 SN_READONLY、表允许/拒绝列表，以及原始软件包和 table 的软件包维度。将 revert 加入 SN_PACKAGES_READONLY，即可保留 list_writes 而不启用撤销功能。

更新集

可选启用的 updatesets 软件包用于读取更新集（这 3 个工具均为只读工具，并且与所有读取工具一样遵循表策略和脱敏规则）：

• servicenow_list_update_sets — 可选的 state、name 片段、 application（范围命名空间、global 或 sys_id）、query、limit / offset → 按时间从新到旧列出更新集，并标记用户当前使用的更新集。
• servicenow_get_update_set — update_set（sys_id 或精确名称）→ 按项目列出该更新集的 客户更新（sys_update_xml）：类型、目标名称、操作、表，以及 by_type / by_action 计数。除非设置 include_payload: true，否则不返回有效载荷； 设置后会将有效载荷解析为字段值，每个字段的长度上限为 payload_max_chars（默认为 500），看起来像机密的字段会被遮蔽。
• servicenow_compare_update_set — update_set 加上 with_profile（实时读取） 或 with_snapshot（servicenow_snapshot_instance 快照）→ 对每个项目返回 same / different（仅列出不同的字段名称）/ missing / not_comparable / not_covered / unknown。仅比较更新有效载荷中的字段； 忽略审计列。

写入：servicenow_create_record、servicenow_update_record、 servicenow_upsert_record 和 servicenow_delete_record 可接受可选的 update_set（sys_id 或精确名称；默认为 SN_UPDATE_SET）。计划预览会显示目标更新集；应用计划时会切换用户的 sys_update_set 首选项（如果是范围更新集，还会切换范围的 updateSetForScope<scope> 首选项）， 执行写入，然后恢复先前的值 — 结果会报告 update_set: { bound, previous, restored }，日志条目 会记录 update_set。如果更新集不是 in progress，则会拒绝操作 （UPDATE_SET_NOT_IN_PROGRESS）；对于数据行表（不扩展 sys_metadata 且没有 update_synch 属性的任何表），写入时不会切换更新集，计划也会说明这一点。如果未提供此参数且未设置相关配置，则不会发生任何变化。其他写入工具（批处理、目录、变更……）不会绑定更新集。

运维和数据健康状况

可选启用的 ops 软件包包含两个只读工具，用于排查“实例运行缓慢”问题和数据质量问题。每个部分都会读取自己的表；如果表不可读取（ACL、表策略、表不存在），则会报告 available: false 和原因，而不是让调用失败，因此空白部分绝不会被视为健康。

• servicenow_read_ops — kind：

  • overview — 在一次调用中返回以下所有部分的计数。
  • syslog — 最近 minutes（默认为 60，最大为 1440）内、级别不低于 level（默认为 warning）的条目，可选 source 片段：按级别统计数量、列出主要来源和最新行（消息最长为 500 个字符）。
  • jobs — 按状态统计调度器队列（sys_trigger）、已超过下次执行时间 overdue_minutes 分钟的就绪作业数量，以及带有领取节点信息的 overdue（默认）、running 或 queued 作业。
  • email_queue — 出站 sys_email：可发送积压邮件及其最早条目、时间窗口内按类型统计的数量，以及近期发送失败记录。
  • semaphores — 按时间从新到旧列出 sys_semaphore 行。

  行数受 limit 限制（默认为 25，最大为 200）。

• servicenow_check_data_health — 针对一个 table 的数据版 servicenow_check_code_health，可选通过 query 指定范围（不允许 ^NQ / ORDERBY）：按 key_fields 检查重复组（使用 Aggregate API 分组，计数 > 1，数量受 limit 限制）；对每个引用字段（reference_fields，默认取前 10 个非系统字段）检查孤立引用（目标行不存在），以及 — 如果目标表有 active 列且 stale 不为 false — 检查过期引用（目标行未激活），并为每项检查提供列出相关行的编码查询。字段名称会先通过数据字典进行检查。用户无权读取的目标行也会被计为孤立引用。

servicenow_why_is_it_slow 提示词会引导用户完成这些读取；如果提供了 table，还会介绍该表写入时运行的逻辑。

记录历史、属性和目录

有 3 个可选软件包可用于处理日常运维问题。每次读取都会像其他读取器一样遵循表策略并进行脱敏。

• servicenow_get_record_history（history）——table + sys_id → 来自 sys_audit 的字段变更，以及来自 sys_journal_field 的日志条目（评论、工作备注），合并后按时间从新到旧排列。可通过 source（all / audit / journal）、fields、since（YYYY-MM-DD[ HH:MM:SS]）、limit（默认值为 100）和 value_max_chars（默认值为 2000）缩小范围。重复日志条目的审计行会被跳过。如果某个来源无法读取（ACL 或策略限制），会在 sources 下报告，但仍会返回另一个来源的结果。

• servicenow_get_properties（properties）——精确的 name 或名称 prefix → sys_properties 行。密码类型或看起来像机密信息的属性会以 [redacted] 返回，过长的值会被截断。

• servicenow_set_property（properties）——设置一个现有属性的值。它按计划/应用方式运行：计划会显示当前值和新值，应用操作会记录在日志中。servicenow_revert_write 可撤销此操作，但不会明文记录机密属性。它遵循 SN_READONLY 和 SN_PACKAGES_READONLY=properties。属性不存在时会返回 PROPERTY_NOT_FOUND；该工具不会创建属性。

• servicenow_lookup_directory（directory）——kind（user / group / role）以及搜索 term 或 sys_id。启用 include_details 且匹配结果恰好为 1 条时，结果会增加以下内容：

  • 对于用户，显示其角色和群组；
  • 对于群组，显示其成员和角色；
  • 对于角色，显示其包含的角色以及授予该角色的群组。

  无法读取的详情表会列在 details_unavailable 中。将 directory 加入 SN_PACKAGES_DENY 可移除用户数据功能。

实例发现

servicenow_document_instance（docs）接受可选的 depth，用于在 README.md 旁添加发现文件夹 <SN_DOCS_DIR>/<profile>/discovery/。各级内容逐级累加：

作用域为指定的 apps，否则为每个非全局 sys_app 作用域，数量不超过每次运行的目标上限（其余会列为已跳过）。artifacts-<scope>.md 会列出每种工件类型，并包含 已收集 / 未收集及原因 一列：已收集（含数量）、达到上限、未经验证（此处无法读取该表）、无此表、当前用户无法读取、软件包已关闭，或此作用域中没有记录。每次读取都会像其他生成器一样遵循相同的策略、脱敏、能力预检和写入日志。未指定 depth 时，工具行为与之前相同。

插件技能

Claude Code 插件（/plugin install servicenow-mcp-ai）在 skills/ 下提供八项技能。每项技能都只负责协调此服务器的工具；没有任何一项会保存凭据或自行调用 ServiceNow。

测试（test/plugin-skills.test.js）会检查技能中每个 servicenow_* 名称是否都存在于工具清单中。这些技能不属于 npm 包的一部分。

子 Agent

agents/ 下提供两个只读子 Agent。它们的 tools 允许列表仅包含此服务器的只读工具（readOnlyHint），因此都无法计划、应用、还原或切换实例；test/plugin-agents.test.js 会强制执行此限制。

变更审查 Agent 没有 servicenow_check_code_health（它会写入本地报告）；当更改涉及 ACL 时，它会建议执行扫描。

钩子

hooks/hooks.json 注册了三个纯 Node 脚本（无依赖）：

在其他 Agent 中使用这些技能

这八项技能是可移植的 Agent Skills：它们的 SKILL.md frontmatter 仅使用 name 和 description，并使用裸 MCP 名称 （servicenow_query_table）指称工具，因此任何配置了此服务的客户端都可以运行它们。将 skills/ 下的文件夹复制或创建符号链接到客户端会扫描的目录中：

.agents/skills/ 适用于以上三种客户端。例如，在克隆此 存储库后：

mkdir -p ~/.agents/skills
cp -R skills/sn-* ~/.agents/skills/   # or: ln -s "$PWD"/skills/sn-* ~/.agents/skills/

在 VS Code 中，扩展的 ServiceNow MCP: Add Agent Skills to Workspace 命令会将八项技能复制到上述某个项目文件夹中（如果目标位置已存在某项技能，它会先征求是否替换）。

子 Agent 和钩子是 Claude Code 的插件功能，无法移植。

Service Portal 树

servicenow_explain_portal（ui，选择启用）以树形结构说明 Service Portal（portal： url_suffix 或 sys_id）或单个页面（page：页面 id 或 sys_id）。 树的层级为：页面 → 容器 → 行 → 列 → 小组件实例 → 小组件。实例的 widget_parameters 会映射到小组件的 option_schema，并且每个小组件都会列出其依赖项、 JS / CSS 引入文件、Angular 提供程序和模板。主题、菜单、页眉 / 页脚和路由映射也会包含在内。 嵌套行会递归到 depth（默认值为 3，最大值为 6），并读取前 5 个页面的布局。 format 可以是 json、markdown、mermaid（布局树）或 file。无法读取的 Service Portal 表会作为注意事项报告，而不会导致失败。

UI Builder 体验地图

servicenow_explain_ui_experience（ui，选择启用）会将 UI Builder 体验或工作区（sys_ux_page_registry 的 sys_id 或 path）说明为页面地图。它会读取页面属性、应用配置、路由、屏幕（及其适用性）和每个屏幕的宏组件。它通过 uib-composition 解码器解析宏组件的构成、数据资源、客户端状态和事件连接，并列出其客户端脚本以及转换 / 脚本片段数据代理，各自附带对应的 ux_data_broker ACL。它还涵盖工作区着陆页、仪表板、列表菜单（类别、列表、适用性）和表单操作布局。读取范围有限，调用会报告进度，也可以取消。format 可以是 json、markdown、mermaid（页面地图）或 file。所有 UI Builder 表名和字段名，以及所有宏组件 JSON 结构，在实时实例上检查之前均未经验证（U），因此结果会带有 verified: false。无法读取的表会作为注意事项报告，而不会导致失败。

cmdb 包还提供 servicenow_list_ci_relations（CI 的 cmdb_rel_ci 关系，支持两个方向，并包含相关 CI 的名称和类别）和 servicenow_identify_reconcile，后者会发送包含项目和关系的 IRE 负载。在计划模式下，servicenow_identify_reconcile 会调用仅识别端点，并显示 IRE 会匹配哪些内容；如果缺少该端点，计划会标记为 degraded。应用操作会记录在日志中，但无法撤销，因为 IRE 会逐项决定处理方式。

servicenow_run_atf（单个测试，或 kind: "suite" 的测试套件）接受 wait_seconds（0–300）。该工具会轮询 CI/CD 进度端点并发送进度通知，取消请求会停止等待。如果到达等待时限时运行仍在进行中，则会返回 wait.state: "running"，并提供一个用于 servicenow_get_atf_result 的 tracker。

servicenow_insert_import_set_row 还会返回 import_set_run（该导入集的 sys_import_set_run 行）和 transform_maps（临时表的映射，其中标出此行使用的映射，标记为 used: true）。如果任一后续读取失败，工具会返回 warnings，而不是错误。

通用工件读取

选择启用的 artifacts 包可读取工件注册表中的任意类型（servicenow://artifact-types 资源会列出这些类型及其表、键字段和子表）：

• servicenow_list_artifacts — artifactType，以及可选的 scope（命名空间或 sys_id）、active、query 和 limit → 摘要：sys_id、名称、自然键、范围、活动标志、是否由 SDK 管理的判定结果，以及该类型的元数据。不包含脚本正文。
• servicenow_get_artifact — artifactType，以及 sys_id 或自然 key → 完整记录、按注册表顺序排列的子记录（UI 策略的操作；门户页面的容器、行、列和小组件实例；流程的操作实例）、其范围，以及该范围是否由 SDK 管理。
• servicenow_explain_artifact — 相同的标识参数 → 结构化说明：一行 summary、运行时机 when（已设置的触发器字段）、非空的 fields、作为精简 items 列出的子记录、其引用的记录 references，以及解码后的 JSON 字段 decoded（小组件参数、UI Builder 属性和数据、流程标签缓存）。无法解码的值会以原始内容返回，并带有 decoded: false 和 reason — 单个字段出错不会导致调用失败。长值会按 SN_MAX_RESULT_CHARS 限制（单个值最多占其二十分之一，整份说明最多占五分之四）；truncatedFields、truncated / preview 和子项的 omitted 计数会说明哪些内容被截断。流程操作值和 UI Builder 组合在专用解码器发布前，会使用普通 JSON 解码器读取（via: "json"）。 部分类型还会提供包含说明文字 lines 的 explanation：状态模型会列出其状态和带条件的 from -> to 转换；选项集或表格会按顺序列出每个元素的选项；UI 策略或数据策略会说明条件成立时对每个字段的影响（如果启用了反向条件，也会说明条件不成立时的影响）。
• servicenow_get_artifact_dependencies — 相同的标识参数，以及 direction（outbound / inbound / both，默认值）、depth（1–3，默认值为 1）、limit（每个入站来源 1–100 行）和 format（json 或 mermaid）→ 依赖关系图，包含 nodes 和 edges（from 依赖 to，并带有 via 和 field）。出站边来自记录及其子记录中的注册表引用字段、已解码的 JSON（流程步骤值、小组件选项、UI Builder 数据）和脚本文本（脚本包含调用、GlideAjax 类、字面值 GlideRecord 表）。入站边来自反向引用查询；对于脚本包含，还包括脚本调用者、值调用它的流程步骤，以及 where-used 图的结构化扫描。遍历每个节点仅一次（可安全处理循环），达到 150 个节点时停止（truncated），并将无法读取的来源转换为 unavailable 条目，而非报错。

每次表读取都遵守 SN_TABLES_ALLOW / SN_TABLES_DENY；被拒绝的子表会以 redacted: true 返回，而不会导致读取失败；SN_REDACT_FIELDS / SN_REDACT_PII 也会像其他情况一样生效。尚未在实时实例上确认其表的类型会带有 verified: false 和 caveat；如果实例拒绝此类表，结果将为空，并提供 degraded 原因而非报错；如果 sys_db_object 显示该实例上不存在此表，还会包含 available: false。

Artifact 写入

servicenow_upsert_artifact({artifactType, key, fields, children?}) 将一条主记录及其子记录作为一个整体进行规划（每条记录对应 S-8 create / update / noop），然后先应用父记录，再应用子记录；所有记录都使用同一个 artifact_write id 记录日志，因此 servicenow_revert_write 可以撤销每一行。H-11 表策略、P-22 SDK 防护和 H-3 计划令牌适用于计划中的每条记录。

• 嵌套子记录。 从属于另一条子记录的子记录通过 parent 按位置指定父记录（即 children 中更早的索引）：例如门户页面的 sp_container → sp_row → sp_column → sp_instance 树、目录变量的 question_choice 行、目录 UI 策略的操作。子记录键可以是 {sys_id}，因此 servicenow_get_artifact 的结果可以原样往返。parent 错误或缺失时会返回 CHILD_PARENT_INVALID。
• SDK 预检。 门户小组件、页面、模板、依赖项、提供程序、页眉 / 页脚和门户，以及目录项、记录生成器、变量、变量集和类别，都会在计划阶段按照 ServiceNow SDK 的方式进行检查：sp_widget.id（涵盖所有扩展该表的表）、sp_page.id、sp_portal.url_suffix、sp_dependency 名称 / 模块以及 sp_ng_template.id 在实例中及计划内都必须唯一（DUPLICATE_UNIQUE_FIELD，409）；目录变量名称必须是有效标识符（PREFLIGHT_INVALID）；在 id 缺少 <scope>_ 前缀的范围应用中创建记录时，会发出 SCOPE_PREFIX 警告。
• 流。 对现有流，flow 只接受 {active}；任何其他字段、子记录或创建操作都会触发 FLOW_ACTIVE_ONLY。O-5 前未经验证：尚未在实时实例上确认通过 Table API 切换 active 会保持 master_snapshot 不变，并且每个流计划都会带有 UNVERIFIED 警告。

门户和目录写入字段在 O-5 前均未经验证（注册表中为 verified: false）。

示例

查询最近 5 条处于活动状态的事件：

// servicenow_query_table
{
  "table": "incident",
  "query": "active=true^ORDERBYDESCsys_created_on",
  "fields": ["number", "short_description", "priority", "state"],
  "limit": 5,
}

创建事件：

// servicenow_create_record
{
  "table": "incident",
  "values": {
    "short_description": "Printer on 3rd floor is down",
    "urgency": "2",
    "impact": "2",
  },
}

在运行时更新凭据：

// servicenow_set_credentials
{
  "instance": "dev98765.service-now.com",
  "user": "admin",
  "password": "••••••",
}

资源

只读元数据也会作为 MCP 资源公开，因此客户端可以通过声明式方式附加这些元数据，而无需调用工具：

资源与工具一样受包控制：status、capabilities 和工具参考始终启用；encoded-query 和记录模板随 table 包提供，tables/schema 随 schema 包提供，instances/每个配置对应的 schema 随 instance 包提供，docs 随 docs 包提供。除非拒绝启用 docs（SN_PACKAGES_DENY=docs），否则 exports 会启用。

三个模板都支持补全和列出：{table} 从架构缓存中已有的表以及一小组常见表种子列表补全，{profile} 从已配置的连接配置中补全，{path} 根据前缀从 docs 清单（index.json）中补全，并限定在当前配置的文件夹内。resources/list 会显示缓存的表和文档（生成的文档优先，标题取自清单；每个模板最多 100 个，docs 的 index.md 始终列在最后）。列出和补全操作绝不会调用实例。

提示词

现成的工作流以 MCP 提示词的形式提供；它们会编排工具，并要求从实例中读取真实值。table 和 profile 参数的自动补全方式与资源模板相同。参数（最多 200 个字符）会以不可信内容块的形式传给模型，每个提示词都会告诉模型，将实例数据视为数据，而非指令。只有在其工具所属的软件包已启用时，提示词才会列出（分类：table；变更影响：change 或 table；文档表：docs 和 scripts；为何速度慢：ops；安全态势：codecheck；UIB 页面审查：ui；安全写入：table；漂移审查：instance；架构影响：scripts；发现实例：docs；实例概览仅使用管理工具，始终列出）。安全写入、漂移审查、架构影响和发现实例提示词分别对应插件技能 sn-safe-write、sn-drift、sn-impact 和 sn-discover（分类、UIB 审查、升级审查和安全态势分别对应 sn-triage、sn-uib、sn-upgrade 和 sn-security）。该列表会实时响应 servicenow_enable_package / servicenow_disable_package，并通过 notifications/prompts/list_changed 更新：

项目结构

.
├── .env                   # credentials (git-ignored; or ~/.config/servicenow-mcp-ai/.env)
├── .env.example           # template
├── .github/workflows/     # CI matrix, CodeQL, npm / MCP Registry / Marketplace publishing
├── .vscode/mcp.json       # VS Code MCP server registration
├── bin/                   # CLI launcher (servicenow-mcp-ai.cjs, incl. the doctor command)
├── extension/             # VS Code extension (thin wrapper that registers the server)
├── docs/                  # GitHub Pages site
├── scripts/               # generators + guards (README tools table, tool manifest, coverage guard)
├── src/
│   ├── index.ts           # bootstrap: load env, register, connect transport
│   ├── core/              # HTTP client (auth, retry, SSRF guard), OAuth/JWT/mTLS, policy,
│   │                      # settings, logging, config store, write journal, request
│   │                      # context (profiles)
│   ├── api/               # one module per REST area: table, aggregate, attachment,
│   │                      # importset, batch, catalog, change, knowledge, cmdb, scripts,
│   │                      # flows, codecheck, atf, email, docs, diagrams, meta, doctor,
│   │                      # history, properties, directory, portal…
│   ├── mcp/               # MCP surface: package registry/manifest, tool definition,
│   │                      # resources, prompts, result envelopes, redaction, write mode
│   │                      # (plan/apply), CSV export, stdio + HTTP transports
│   └── tools/             # tool registrations, one file per package (28 packages)
├── test/                  # node:test suite (406 tests): unit, mock-fetch api, MCP smoke, doc guards
└── build/                 # compiled output (after npm run build)

名称说明： npm 包和 GitHub 仓库都叫 servicenow-mcp-ai（ npm 上不带作用域的 servicenow-mcp 已被占用）；本地工作目录 名为 servicenow-mcp。这一区别仅为表面差异，不影响构建 或运行时。

安全说明

• 环境文件已加入 Git 忽略规则——切勿提交真实凭据。
• 环境文件仅允许所有者访问（0600）——其中存有明文密码。
• 服务使用 stdio 传输，且只向 stderr 写入日志；不会记录密钥或原始编码查询。
• 任何工具都不会返回密码或令牌。
• 密钥列始终会被掩码处理。 字典类型为 password、password2 或 glide_encrypted（列级加密）的列，在所有返回记录的工具（query_table、get_record、批处理、比较、导出等）中都会显示为 [redacted]，且绝不会存入写入日志，无论 SN_REDACT_FIELDS 设置为何值。每个配置文件的类型只会从 sys_dictionary 读取一次，并像其他架构信息一样缓存（SN_SCHEMA_CACHE_TTL_SEC）；如果无法读取字典，则改用一份 OOTB 密钥列名称列表（password、user_password、client_secret 等），读取操作仍会继续。无法关闭此掩码处理。
• 主机受到限制：未设置 SN_ALLOWED_HOSTS 时，只会连接 *.service-now.com 实例（除非允许列表中的条目明确指定该主机，否则会阻止内部主机和环回地址），因此拼错主机名不会导致凭据被悄然发送。不会跟随重定向（REDIRECT_BLOCKED），响应正文大小上限为 SN_MAX_BODY_BYTES。设置 SN_ALLOWED_HOSTS 可选择使用自定义域名或主权云域名。只有当允许列表中的条目明确指定该主机时，实例值中才允许使用显式的非 443 端口或 IPv6 字面地址（host:8443、[2001:db8::1]）。
• 每个请求（包括 OAuth 令牌请求）都会携带标识用的 User-Agent: servicenow-mcp-ai/<version> (node/<major>; <transport>; <client>)，以便实例的事务日志归属该流量；可通过 SN_USER_AGENT_SUFFIX 扩展此值。每个请求都会使用代理 URL（SN_HTTPS_PROXY、HTTPS_PROXY），但绝不会记录代理凭据。
• 在可行时，优先使用 OAuth 2.0，而非 Basic（SN_OAUTH_CLIENT_ID）。
• 对只读部署，请使用 SN_TABLES_ALLOW / SN_TABLES_DENY 和 SN_READONLY=true 落实最小权限原则。
• 表策略不适用于插件 API。 SN_TABLES_DENY=change_request 会阻止 Table API 路径，但 Change Management API（sn_chg_rest）仍可读取或写入变更。若要限制由插件提供的接口，可使用 SN_PACKAGES_DENY（移除整个包）或 SN_PACKAGES_READONLY（仅注册其读取工具）。Batch API 同样遵循这两类策略：会拒绝发往被拒绝包路径的子请求，并阻止对只读包的写入——无法通过批处理绕过包策略。

项目文档

支持

这个项目由我利用业余时间构建和维护。如果它为你或你的团队节省了时间， 请考虑支持项目持续开发 — 赞助资金将直接用于开发新工具、修复 bug，以及跟上 ServiceNow REST 接口的变化。

• GitHub Sponsors — 一次性或 定期赞助，平台不收取费用（首选方式）。
• Ko-fi — 快速的一次性支持；它也 支持 PayPal，因此没有 GitHub 账户的用户可以选择此方式。
• 捐赠（Donatree） — 无需账户的捐赠 页面（支持银行卡、PayPal 等），可用于一次性打赏。

商标

servicenow-mcp-ai 是一个独立的社区项目。它与 ServiceNow, Inc. 无关联，也未获得其认可或赞助。

“ServiceNow”、ServiceNow 徽标、“Now”及相关标志均为 ServiceNow, Inc. 在美国及其他国家/地区的商标或注册商标。它们仅以指称性用途用于本项目的名称和文档中，以标识本软件可互操作的平台，并不表示存在任何关联或认可。所有其他产品名称和标志均为其各自所有者的财产。

Copyright (C) 2026 Ivan Baev。本项目根据GNU GPL v3.0 or later授权；该许可证适用于源代码，不授予使用 ServiceNow 商标的任何权利。3.0.0-beta.1 及之前的版本均根据 MIT License 发布。