      ](https://nodejs.org)
现在AIKit
最全面的ServiceNow人工智能工具包
400+工具·31+ServiceNow模块·5分钟设置·免费使用·适用于任何AI
现在AIKit 是ServiceNow最全面、最适合生产的人工智能工具包,也是唯一一个真正做到这一切的工具包。
连接 克劳德, ChatGPT, 双子座, 光标, GitHub Copilot,或任何兼容MCP的AI在5分钟内。然后让你的AI在每个ServiceNow模块中读取、构建、部署和自动化——事件、更改、脚本、流、门户、集成、HRSD、CSM等等。
用简单的英语问。从聊天中部署业务规则。按需运行ATF套件。同时查询dev、staging和prod。跨多个客户租户实现自动化,无需切换选项卡。 你的AI,你的实例,你的规则。
任何AI,任何实例。任何规模。免费使用。
关键词: ServiceNow MCP服务器·模型上下文协议·ServiceNow AI·ITSM自动化·ServiceNow Claude·ServiceNow ChatGPT·ServiceNow Cursor·ServiceNow Copilot·ServiceNow LLM·ServiceNow代理·MCP工具·ServiceNow API·代理AI·ServiceNow开发工具
| 初学者 | 需要零ServiceNow API知识。5分钟后连接。用简单的英语问。免费PDI请访问developer.servicenow.com |
| 开发者 | 以AI速度编写、部署、测试和管理脚本、流、小部件和集成,速度提高了10倍。 |
| 建筑师和MSP | 协调多步骤的自主工作流程。比较环境。在一个会话中管理多个客户租户。 |
______________________________________________________________________
这是给谁的?
初学者
需要零ServiceNow API知识。
在5分钟内将Claude Desktop或Cursor连接到您的免费PDI。用简单的英语提问、浏览事件、搜索知识库文章、下目录订单、监控SLA——所有这些都可以在您的AI聊天窗口中完成。没有代码。没有邮递员。没有文件潜水。问吧。
*从这里开始→ 5分钟快速入门*
开发者
将AI作为您的开发合作伙伴,速度提高10倍。
编写业务规则、部署客户端脚本、管理UI策略和ACL、创建服务门户小部件、配置REST消息、管理转换映射和更新变更集——所有这些都是用简单的英语编写的。内置完整的TypeScript类型、ATF集成和基于角色的包。
*探索→ 平台开发包*
建筑师、管理员和MSP
自主工作流程。多实例。多客户。
触发代理剧本,编排多步骤ITSM/HRSD/CSM流程,并排比较环境,在一个会话中管理数十个客户租户,并在整个ServiceNow资产中以AI速度运行完整的数据质量审计。
*深潜→ 现在协助和代理指南*
______________________________________________________________________
为什么现在AIKit
完全自主的人工智能操作
你的AI不只是回答问题——它 *行为*.创建事件、编写和部署脚本、触发流、触发事件、上传附件、管理变更集和运行完整的ATF套件——端到端,无需手动步骤。Native Now Assist Agent Playbook支持下一代ServiceNow AI自动化。
与所有AI协同工作,开箱即用
Claude、ChatGPT、Gemini、Grok、Cursor、Windsurf、GitHub Copilot、Amazon Q、JetBrains、Continue.dev、Cline、Zed、Google AI Studio、Ollama --所有这些都是开箱即用的。任何兼容MCP的客户端。任何自定义Python或TypeScript代理。一个工具包,每个AI平台,零锁定。
无与伦比的平台覆盖范围
400+生产就绪工具 跨每个ServiceNow域——ITSM、ITOM、HRSD、CSM、SecOps、GRC、敏捷、ATF、流设计器、脚本、Now Assist、服务门户、集成中心、性能分析、系统属性、更新集、虚拟代理、ITAM、DevOps、机器学习、工作区/UIB、移动和部署。没有什么比这更接近了。
基于角色的工具智能
14个预构建的角色包——服务台、平台开发人员、门户开发人员、集成工程师、ITOM工程师、AI开发人员、ITAM分析师、DevOps工程师等等。每个都为该角色提供了正确的工具。减少噪音,强制最低权限,每个团队配置一次。
默认安全,需要时功能强大
五层权限模型可以保护您的实例。 阅读始终处于打开状态。 写、CMDB、脚本、Now Assist和ATF功能都需要一个明确的选择加入标志。没有人工智能可以意外修改您的生产数据。随着信心的增长而扩展权限,而无需接触代码。
真正的多实例和多客户
连接到 无限ServiceNow实例 从一个会话开始——开发、暂存、生产, *和* 同时拥有多个客户租户。通过 instance: "acme_prod" 在任何工具调用中,或 switch_instance 全球地。MSP、顾问和企业团队可以同时在每个环境中进行比较、查询和自动化。没有其他ServiceNow AI工具包能做到这一点。
______________________________________________________________________
快速链接
| 资源 | 链接 |
|---|---|
| 所有工具参考 | docs/TOOLS.md |
| 客户端设置(所有AI工具,初级+高级) | docs/CLIENT_SETUP.md |
| 基于角色的工具包 | |
| 现在辅助和人工智能集成 | docs/NOW_ASSIST.md |
| ATF测试指南 | docs/ATF.md |
| 脚本管理 | docs/SCRIPTING.md |
| 报告和分析 | 文档/报告.md |
| 多实例设置 | docs/MULTI_INSTANCE.md |
| 120+真实世界示例 | 示例.md |
| 变更日志 | 更改日志.md |
______________________________________________________________________
模块覆盖范围
涵盖完整ServiceNow平台的域模块:
| 模块 | 关键能力 |
|---|---|
| 核心和CMDB | 记录查询、架构发现、CMDB CI、ITOM发现、MID服务器、多实例管理 |
| 事件管理 | 创建、更新、解决、关闭、工作笔记、评论 |
| 问题管理 | 问题记录、根本原因分析、已知错误 |
| 变更管理 | 创建、获取、更新、提交审批、关闭变更请求 |
| 任务管理 | 通用任务、我的任务列表、完成情况 |
| 知识库 | 搜索、创建、更新、发布知识库文章 |
| 服务目录和审批 | 目录浏览、创建/更新项目、订单项目、SLA跟踪、审批工作流、审批规则 |
| 用户和组管理 | 用户、组、成员资格、角色分配 |
| 报告和分析 | 聚合查询、趋势分析、创建/更新报告、计划作业CRUD、运行历史记录 |
| ATF测试 | 测试套件、测试执行、ATF故障洞察 |
| Now Assist/AI | NLQ、AI搜索、摘要、解决方案建议、代理剧本 |
| 脚本 | 业务规则、脚本包括、客户端脚本CRUD、UI策略、UI操作、ACL管理、变更集 |
| 敏捷/Scrum | 故事、史诗、冲刺、Scrum任务 |
| 人力资源服务交付(HRSD) | 人力资源案例、人力资源服务、员工档案、入职/离职 |
| 客户服务管理(CSM) | 客户案例、账户、联系人、产品、SLA |
| 安全运营和GRC | 安全运营事件、漏洞、GRC风险、控制、威胁情报 |
| 流程设计器和流程自动化 | 流程、子流程、触发器、执行、流程自动化剧本 |
| 服务门户和UI生成器 | 创建/列出门户和页面、小部件(创建/更新/部署)、Next Experience应用程序/页面、主题 |
| 集成中心 | REST消息、转换映射、导入集、事件注册表、OAuth应用程序、凭据别名 |
| 通知和附件 | 电子邮件通知、电子邮件日志、文件附件(上传/列表/删除)、模板、订阅 |
| 性能分析 | PA指标/记分卡、时间序列、创建/更新仪表板、PA作业、数据质量检查 |
| 系统属性 | 获取、设置、批量操作、验证、导出/导入、审核历史记录 |
| 更新集管理 | 创建、切换、预览、完成、导出、自动确保活动集 |
| 虚拟代理(VA) | 主题创作、对话历史、类别、主题列表 |
| IT资产管理(ITAM) | 资产、软件许可证、合同、合规性报告 |
| DevOps和管道跟踪 | 管道、部署、变更治理、DORA指标 |
| 范围应用程序(App Studio) | 列出、获取、创建和更新范围应用程序记录 |
______________________________________________________________________
认证
支持两种身份验证方法:
| 方法 | 最适合 |
|---|---|
| 基本认证 | 开发、个人实例、快速设置 |
| OAuth 2.0 (客户端凭据/密码授予) | 生产部署、服务帐户 |
SSO/OIDC身份验证(Okta、Azure AD/Entra、Ping Identity)在企业版中可用——请参阅 nowaikit.com/#定价.
有关ServiceNow中的OAuth设置,请参阅 docs/SERVICENOW_OAUTH_SETUP.md.
______________________________________________________________________
权限系统
默认情况下,四层权限模型可以保护您的实例安全:
| 层级 | 环境变量 | 覆盖范围 |
|---|---|---|
| 0--读取 | *(始终打开)* | 所有查询和读取操作 |
| 1--写 | WRITE_ENABLED=true | 跨ITSM、HRSD、CSM、敏捷创建/更新 |
| 2-CMDB写入 | CMDB_WRITE_ENABLED=true | 在CMDB中创建/更新CI |
| 3--脚本编写 | SCRIPTING_ENABLED=true | 业务规则、脚本、变更集 |
| 4--现在协助 | NOW_ASSIST_ENABLED=true | AI代理剧本、NLQ、AI搜索 |
______________________________________________________________________
基于角色的工具包
集 MCP_TOOL_PACKAGE 仅公开与每个角色相关的工具:
| 套装 | 人物角色 | 附带工具 |
|---|---|---|
full | 管理员 | 所有工具(400+) |
service_desk | L1/L2代理 | 事件、任务、批准、知识库、SLA |
change_coordinator | 变更经理 | 变更(创建/批准/关闭)、CAB、CMDB、批准 |
knowledge_author | 知识库作者 | 知识库创建/发布 |
catalog_builder | 目录管理员 | 目录、用户、组 |
system_administrator | 系统管理员 | 用户、组、报告、日志、通知、附件、ACL、PA |
platform_developer | 开发人员 | 脚本、UI策略、UI操作、ACL、客户端脚本、ATF、变更集 |
portal_developer | 门户/UX开发 | 门户、页面、小部件(创建/更新)、UI策略、UI操作、客户端脚本 |
integration_engineer | 集成开发 | REST消息、转换映射、导入集、事件、OAuth、凭据 |
itom_engineer | ITOM工程师 | CMDB、发现、MID服务器、事件 |
agile_manager | Scrum大师 | 故事、史诗、冲刺 |
ai_developer | AI建设者 | 现在辅助,NLQ,代理剧本 |
______________________________________________________________________
入门指南
选项A--交互式安装向导(推荐)
# Install globally (Node.js 20+ required)
npm install -g nowaikit
# Run the wizard — detects your AI clients and writes config automatically
npx nowaikit setup向导将:
- 请求您的ServiceNow实例URL+凭据
- 测试连接
- 允许您选择工具包和权限级别
- 在您的计算机上检测克劳德桌面、光标、VS代码、Windsurf、Continue.dev、克劳德代码
- 直接编写配置——无需复制粘贴,无需手动编辑JSON
# Add a second instance later
nowaikit setup --add
# Manage instances
nowaikit instances list选项B--Web仪表板(一个命令)
npx nowaikit web打开NowAIKit仪表板 http://localhost:4175 --包括实例管理、设置和审核日志查看器。
# Custom port
npx nowaikit web --port 3000
# Expose to network (use with caution)
npx nowaikit web --host 0.0.0.0
# Don't auto-open browser
npx nowaikit web --no-open选项C——桌面应用程序
从以下网址下载本机桌面应用程序(macOS、Windows、Linux) 。包括可视化设置向导、工具浏览器和审核日志查看器。
选项D——手动设置
git clone https://github.com/aartiq/nowaikit.git && cd nowaikit
npm install && npm run build
cp .env.example .env # fill in your ServiceNow credentials然后将您的AI客户端指向 dist/server.js --看 支持的AI客户端 在......下面
没有ServiceNow实例? 获取免费的个人开发者实例 developer.servicenow.com --几分钟内准备好。
完整安装指南→ docs/INSTALLATION.md
______________________________________________________________________
客户端设置指南
为每个主要的AI客户端逐步设置——Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Zed、GitHub Copilot、Continue.dev、Cline、JetBrains、Amazon Q、Google AI Studio、ChatGPT、Grok、Ollama等等。
完整指南→ docs/CLIENT_SETUP.md
有关快速设置片段,请参阅 支持的AI客户端 下面的部分。
交互示例
连接后,用简单的语言问你的人工智能助手:
ITSM和变更管理:
Show me all open P1 incidents assigned to the Network Operations group.Create a normal change request for deploying the new API gateway — implementation planned for Saturday midnight.What CMDB CIs does the ERP application depend on?脚本编写与开发:
List all client scripts on the incident table and show me the ones that fire on form load.Create a UI action button "Escalate to L3" on the incident form that assigns the ticket to the L3-Support group.Show me all ACL rules for the change_request table that restrict the "delete" operation.服务门户和UI生成器:
List all widgets in the Service Portal that contain "catalog" in their name.Get the full source code of the "Stock Ticker" widget so I can update its server script.Create a new portal widget called "My Approvals Widget" with a simple Angular template that lists pending approvals.集成和事件:
List all REST Message definitions that connect to external APIs.Show me all transform maps that target the incident table.Fire the custom event "myapp.ticket.escalated" on incident INC0012345.通知和附件:
List all email notifications that trigger on the incident table when a comment is added.Upload a screenshot of the error (base64) as an attachment to incident INC0012345.Show me all failed email log entries from the last 24 hours.性能分析和数据质量:
Get the current scorecard for the "Mean Time to Resolve" PA indicator with a 30-day trend.Check the data completeness of the incident table — how many incidents are missing assignment_group or category?Compare record counts across incident, change_request, and problem tables.ATF、报告和计划作业:
Run the Regression Test Suite and show me any failures with ATF Failure Insight details.Summarise the last 30 days of incident trends by category.Create a scheduled job that runs daily at 3am to archive closed incidents older than 90 days.有关120多个具有输入、输出和高级工作流的真实示例,请参阅 示例.md.
______________________________________________________________________
删除命令和@提及
连接后,键入 / 在Claude Desktop或Cursor中查看内置的ServiceNow快捷方式:
| 命令 | 它的作用 |
|---|---|
/morning-standup | P1/P2未结事件、今天到期的变更、SLA违规 |
/my-tickets | 分配给您的所有未完成任务/事件 |
/p1-alerts | 具有开放时间和受让人的主动P1事件 |
/my-changes | 您的待处理变更请求和审批状态 |
/create-incident | 引导事件创建 |
/sla-breaches | 当前违反SLA的记录 |
/ci-health | CMDB CI健康检查 |
/run-atf | 触发ATF测试套件 |
/switch-instance | 交互式实例选择器 |
/knowledge-search | 搜索知识库文章 |
/deploy-updateset | 引导更新集提交 |
类型 @ 将实时ServiceNow数据拉入您的AI环境:
| 提及 | 退货 |
|---|---|
@my-incidents | 您的公开事件 |
@open-changes | 待处理的变更请求 |
@sla-breaches | 立即违反SLA的记录 |
@instance:info | 当前实例元数据 |
@ci: | 按名称列出CMDB CI |
@kb: | 按标题分类的知识文章 |
在中添加您自己的命令 nowaikit.commands.json:
[
{
"name": "my-p1-runbook",
"description": "P1 runbook for my team",
"template": "List all P1 incidents in the Network category. For each: number, description, assignee, time open. Flag SLA breaches."
}
]高级配置
| 主题 | 指南 |
|---|---|
| OAuth 2.0设置(ServiceNow OAuth应用程序创建) | docs/SERVICENOW_OAUTH_SETUP.md |
| 多实例/多客户(开发、暂存、生产、租户) | docs/MULTI_INSTANCE.md |
| 基于角色的工具包 | |
| 所有环境变量引用 | docs/INSTALLATION.md |
专业版/企业版功能
以下功能在中可用 NowAIKit Pro 和 企业 版本:
| 功能 | 版本 |
|---|---|
| HTTP API服务器和web仪表板 | 专业版 |
| 桌面应用程序(macOS、Windows、Linux) | 专业版 |
| SSO/OIDC(Okta、Azure AD/Entra、Ping身份) | 企业 |
| 审计日志记录(JSONL+SIEM webhooks) | 企业 |
| 组织策略治理(MDM/GPO部署) | 企业 |
了解更多信息,请访问 nowaikit.com/#定价.
______________________________________________________________________
在行动中看到它
一旦NowAIKit连接,您就可以与您的AI进行真正的交互:
操作——简明英语:
You: "Show me all P1 incidents opened this week that are still unresolved"
You: "Which assignment groups have the most open incidents right now?"
You: "Find all change requests scheduled for this weekend"
You: "Is any SLA about to breach in the next 2 hours?"开发——AI为您编写和部署:
You: "Create a business rule that auto-assigns high-priority incidents to the NOC group"
You: "Write a client script that validates email format on the contact form"
You: "Create a Service Portal widget that shows my team's open tasks"
You: "Set up a REST Message integration to send alerts to our Slack channel"人工智能驱动的智能:
You: "Summarise this incident and suggest a resolution based on similar past cases"
You: "Use Predictive Intelligence to categorise this new incident description"
You: "Trigger the SOC Agentic Playbook for this security incident"
You: "What's the trend in P2 incidents over the last 6 months?"先进的自动化:
You: "Compare record counts between prod and dev for the incident table"
You: "Check data completeness on the cmdb_ci_server table — which fields are mostly empty?"
You: "Run the nightly sync transform map on the latest import set"
You: "Create a scheduled job that emails the on-call team daily at 7am"多实例和多客户:
You: "List all configured instances"
You: "Switch to customer_acme and show me their open P1 incidents"
You: "Compare open change counts between prod and staging"
You: "Get SLA breach risk from customer_globex prod instance"看 示例.md 所有ServiceNow模块中的120多个真实示例。
______________________________________________________________________
支持的AI客户端
任何兼容MCP的AI都可以工作。 现在,AIKit已经在每个主要的人工智能助手、编辑器和代理框架上进行了测试。选择你的,并按照下面的3步设置进行操作。
人工智能助理和聊天
Claude Desktop — Anthropic (Mac / Windows / Linux)
- 从以下位置安装Claude Desktop claude.ai/下载
- 编辑配置:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json
- 添加此块-- 单一实例 (替换路径和凭据):
{
"mcpServers": {
"nowaikit": {
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password",
"WRITE_ENABLED": "false"
}
}
}
}或使用 多实例 (dev+staging+prod,或多个客户租户):
{
"mcpServers": {
"nowaikit": {
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SN_INSTANCES_CONFIG": "/absolute/path/to/instances.json"
}
}
}
}复制 instances.example.json → instances.json,填写您的实例,然后问:
*“列出实例”* → *“切换到prod”* → *“显示所有P1事件”* *“从customer_acme获取打开的更改”* (使用 instance 每次调用的参数)- 重新启动克劳德桌面。锤子图标确认连接。
完整指南→ 客户端/克劳德桌面/SETUP.md | docs/MULTI_INSTANCE.md
ChatGPT / OpenAI (API)
OpenAI通过以下方式支持MCP 响应API (mcp 最新SDK(v1.50+)中的工具类型:
from openai import OpenAI
import os, subprocess
# Start NowAIKit as a subprocess MCP server
proc = subprocess.Popen(
["node", "/path/to/nowaikit/dist/server.js"],
stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
env={**os.environ,
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"}
)
client = OpenAI()
# Use with Responses API tool type "mcp" or via function calling
response = client.responses.create(
model="gpt-4o",
tools=[{"type": "mcp", "server_label": "nowaikit"}],
input="Show me all open P1 incidents"
)完整指南→ docs/CLIENT_SETUP.md
Google Gemini / Vertex AI (API)
- 立即安装AIKit:
npm install -g nowaikit - 使用Python客户端
clients/gemini/:
pip install google-generativeai
python clients/gemini/servicenow_gemini_client.py完整指南→ 客户/双子座/SETUP.md
Google AI Studio — Gemini 2.5 Flash / Pro / Gemini 3 (MCP Preview)
Google AI Studio通过其代理执行环境(目前处于预览阶段)支持MCP服务器。
- 首选 aistudio.google.com 并打开 构建→ Agent
- 在 工具 面板中,添加一个MCP服务器并将其指向您的NowAIKit实例:
{
"name": "nowaikit",
"transport": "stdio",
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password",
"WRITE_ENABLED": "false"
}
}- 或者,使用 API双子星 通过映射NowAIKit工具定义直接使用函数调用:
import google.generativeai as genai
import subprocess, json, os
# Start NowAIKit MCP server
proc = subprocess.Popen(
["node", "/path/to/nowaikit/dist/server.js"],
stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
env={**os.environ,
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"}
)
genai.configure(api_key=os.environ["GOOGLE_API_KEY"])
model = genai.GenerativeModel("gemini-3.1-pro") # or gemini-3-flash, gemini-2.5-flash
# Use model.generate_content() with tools= mapped from NowAIKit definitions完整指南→ docs/CLIENT_SETUP.md
Grok (xAI) — via OpenAI-compatible API
- Grok使用与OpenAI兼容的API格式。遵循上面的OpenAI设置
- 集
base_url="https://api.x.ai/v1"和你的XAI_API_KEY
完整指南→ docs/CLIENT_SETUP.md
______________________________________________________________________
AI代码编辑器
Cursor — AI-first code editor
- 打开的游标→ 设置→ MCP
- 添加服务器配置:
{
"mcpServers": {
"nowaikit": {
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password",
"WRITE_ENABLED": "true",
"SCRIPTING_ENABLED": "true"
}
}
}
}- 重新启动游标。在聊天中提问: *“列出所有未解决的P1事件”*
多实例: 将env块替换为 "SN_INSTANCES_CONFIG": "/path/to/instances.json" 连接到多个租户。
完整指南→ 客户端/光标/SETUP.md
Windsurf (Codeium) — AI-native editor
- 开放式风帆→ 级联→ 配置MCP
- 添加与上面的Cursor相同的JSON块
- 重新加载Windsurf窗口
完整指南→ docs/CLIENT_SETUP.md
Zed Editor — collaborative AI editor
- 打开Zed→
~/.config/zed/settings.json - 添加到下面
"context_servers":
{
"context_servers": {
"nowaikit": {
"command": { "path": "node", "args": ["/path/to/nowaikit/dist/server.js"] },
"settings": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
}
}完整指南→ docs/CLIENT_SETUP.md
______________________________________________________________________
IDE扩展
VS Code — Native MCP (v1.99+, no subscription required)
VS Code 1.99及更高版本包含内置的MCP支持,无需扩展或订阅。
- 安装 VS代码1.99+
- 创建
.vscode/mcp.json在您的工作区中(或编辑用户设置):
{
"servers": {
"nowaikit": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password",
"WRITE_ENABLED": "true",
"SCRIPTING_ENABLED": "true"
}
}
}
}- 打开命令选项板(
Cmd/Ctrl+Shift+P) → MCP:列出服务器 验证连接 - 打开Copilot Chat(或VS Code中的任何AI助手)并使用
@nowaikit或者自然地问
提示: 添加.vscode/mcp.json到.gitignore如果它包含凭据,或使用来自.env文件。
完整指南→ 客户端/vcode/SETUP.md
VS Code — GitHub Copilot (agent mode)
- 安装VS Code+GitHub Copilot扩展
- 创建
.vscode/mcp.json在您的项目中:
{
"servers": {
"nowaikit": {
"type": "stdio",
"command": "node",
"args": ["${workspaceFolder}/../../nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
}
}- 打开Copilot聊天→ 代理模式→
@nowaikit
完整指南→ 客户端/vcode/SETUP.md
VS Code — Continue.dev (open-source Copilot alternative)
- 安装 继续 来自VS代码市场
- 编辑
~/.continue/config.json:
{
"mcpServers": [
{
"name": "nowaikit",
"command": "node",
"args": ["/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
]
}完整指南→ docs/CLIENT_SETUP.md
VS Code — Cline (autonomous AI agent)
- 安装 克莱恩 来自VS代码市场
- 开放式诊所→ MCP服务器→ 添加服务器
- 输入路径
nowaikit/dist/server.js以及您的环境变量
完整指南→ docs/CLIENT_SETUP.md
JetBrains AI Assistant (IntelliJ IDEA, PyCharm, WebStorm, etc.)
- 安装JetBrains AI助手插件
- 前往设置→ 工具→ AI助手→ MCP服务器
- 添加一个新服务器,路径为
nowaikit/dist/server.js - 在服务器配置对话框中设置环境变量
完整指南→ docs/CLIENT_SETUP.md
Amazon Q Developer (AWS CLI + IDE)
- 为VS Code或IntelliJ安装Amazon Q Developer扩展
- 通过配置MCP
~/.aws/amazonq/mcp.json:
{
"mcpServers": {
"nowaikit": {
"command": "node",
"args": ["/path/to/nowaikit/dist/server.js"],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"
}
}
}
}完整指南→ docs/CLIENT_SETUP.md
______________________________________________________________________
CLI和终端代理
Claude Code / Claude CLI — Anthropic's official CLI
# Install Claude Code
npm install -g @anthropic-ai/claude-code
# Register NowAIKit as an MCP server
claude mcp add nowaikit node /absolute/path/to/nowaikit/dist/server.js \
--env SERVICENOW_INSTANCE_URL=https://yourinstance.service-now.com \
--env SERVICENOW_AUTH_METHOD=basic \
--env SERVICENOW_BASIC_USERNAME=admin \
--env SERVICENOW_BASIC_PASSWORD=your_password
# Verify
claude mcp list
# Use it
claude "Show me all unresolved P1 incidents"完整指南→ 客户端/claude代码/SETUP.md
Ollama — run AI locally (Llama, Mistral, Phi, etc.)
- 安装 奥拉玛 并拉取一个模型:
ollama pull llama3 - 使用配置为使用Ollama作为模型的MCP兼容客户端(例如Cline或Continue)
- 将MCP服务器指向
nowaikit/dist/server.js
完整指南→ docs/CLIENT_SETUP.md
______________________________________________________________________
程序化/代理SDK
OpenAI Codex / Custom Python Agent
cd clients/codex
pip install -r requirements.txt
cp .env.basic.example .env # fill in your credentials
python servicenow_openai_client.py完整指南→ 客户端/codex/SETUP.md
Anthropic Agent SDK (Claude API)
import anthropic, subprocess, json
# Start NowAIKit subprocess
proc = subprocess.Popen(
["node", "/path/to/nowaikit/dist/server.js"],
stdin=subprocess.PIPE, stdout=subprocess.PIPE,
env={**os.environ,
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com",
"SERVICENOW_AUTH_METHOD": "basic",
"SERVICENOW_BASIC_USERNAME": "admin",
"SERVICENOW_BASIC_PASSWORD": "your_password"}
)
# Then use with the Anthropic MCP client SDK看 拟人化MCP Python SDK 为了实现全面整合。
______________________________________________________________________
快速参考
| 客户端 | 类型 | 身份验证 | 指南 |
|---|---|---|---|
| Claude Desktop | 桌面应用程序 | 基本版,OAuth | 设置 |
| Claude Code CLI | 终端 | 基本版,OAuth | 设置 |
| 光标 | 人工智能编辑器 | 基本,OAuth | 设置 |
| Windsurf | 人工智能编辑器 | 基本版,OAuth | 设置 |
| Zed | 人工智能编辑器 | 基本版,OAuth | 设置 |
| VS代码 (原生MCP 1.99+) | 集成开发环境 | 基本版,OAuth | 设置 |
| VS代码+GitHub副本 | 集成开发环境 | 基础,OAuth | 设置 |
| VS代码+继续开发 | 集成开发环境 | 基本,OAuth | 设置 |
| VS代码+临床 | 集成开发环境 | 基础,OAuth | 设置 |
| JetBrains AI | IDE | 基础版,OAuth | 设置 |
| Amazon Q开发人员 | IDE/CLI | 基本版,OAuth | 设置 |
| ChatGPT/OpenAI | API | 基本,OAuth | 设置 |
| 谷歌AI工作室 | API/Agent | 基本,OAuth | 设置 |
| Google Gemini API | API | 基本,OAuth | 设置 |
| Grok(xAI) | API | 基础,OAuth | 设置 |
| Ollama(当地) | 当地 | 基础 | 设置 |
| Anthropic Agent SDK | Python | Basic,OAuth | 设置 |
______________________________________________________________________
v2.5的新增功能
桌面应用程序和Web仪表板中的多提供商AI聊天
nowaikit桌面和Web仪表板支持 5家人工智能提供商 并排——所有提供者都可以使用完整的代理工具。所有型号列表都与每个提供商的最新版本保持一致。
- 提供商切换器 --在聊天标题中单击一下即可在提供商之间切换;每个提供者模型下拉列表会自动更新
- 克劳德(人类学) --作品4.6·十四行诗4.6·俳句4.5
- ChatGPT/OpenAI --GPT-5.2·GPT-5.2 Pro·GPT-5.1·GPT-5 mini·GPT-五nano·GPT-4.1·GPT-4o·o3·o4 mini
- 双子座(谷歌人工智能) --双子座3.1专业版·双子座3专业版·双子3 Flash·2.5专业版·2.5 Flash·2.5 Flash精简版
- Groq(免费) --《骆驼4》Maverick·《骆驼4:童子军》·《骆驼3.3》70B·《骆驼3.1》8B——超快速推理,无需信用卡
- OpenRouter(200多种型号) --OpenAI o1 Pro、xAI Grok 4、Claude Opus 4.6、Gemini 2.5 Flash、DeepSeek R1、Llama 4 Maverick等的统一网关——提供许多免费等级
- o3/o4推理模型支持 --自动检测跳过系统消息并切换到
max_completion_tokens;工具未发送到不支持它们的模型
应用内提供商登录
设置→ AI提供商现在展示了一个统一的 “登录到{Provider}” 每个提供者的流量:
- 点击 登录到Claude/ChatGPT/Gemini/Groq/OpenRouter -提供商的API密钥门户在系统浏览器中打开
- 登录您的帐户并创建/复制API密钥
- 将其直接粘贴到显示的焦点输入中
- 点击 验证密钥 --在保存之前,轻量级验证调用会确认密钥有效
每个提供者面板都显示一个清晰的 订阅说明 解释API访问与消费者订阅是分开的(Claude.ai Pro、ChatGPT Plus、Gemini Advanced)。Groq和OpenRouter提供慷慨的免费等级,无需信用卡。
聊天中的Slash命令工具选择器
类型 / 在聊天输入中打开所有400多个ServiceNow工具的浮动选择器:
- 键入时按工具名称或描述筛选
↑/↓导航· 选项卡 或 进入 选择· 退出键 关闭- 插入
/toolname在你的信息中——人工智能知道调用那个特定的工具
其他桌面改进
- 测试键按钮 -在API键输入上内联;调用提供者的模型列表端点进行验证,而不发送聊天消息
- 服务器健康自动恢复 --每8秒轮询一次;“离线”状态会自动恢复,无需重新启动应用程序
- 仪表板URL截断 --长实例URL被截断为
…(悬停时显示完整URL) - Bug修复:ChatGPT和Gemini响应现在显示正确 --由于提供者响应转换和呈现器之间的内容格式不匹配,响应被默默地丢弃;现在对于提供程序和HTTP API服务器都已完全修复
v2.4的新增功能
零配置设置和桌面体验
npx nowaikit setup--交互式向导自动检测并写入每个AI客户端的配置。没有JSON编辑。- nowaikit桌面 --跨平台Electron应用程序(macOS、Windows、Linux),具有8步可视化向导、仪表板、工具浏览器和审计日志。无需单独安装服务器。
- Web仪表板 --服务于
http://localhost:3100通过HTTP服务器。浏览工具、查看运行状况、尾部审计日志。
删除命令和@提及
- 11内置
/斜杠命令 —/morning-standup,/p1-alerts,/my-tickets,/create-incident,/sla-breaches,/ci-health,/run-atf,/switch-instance,/deploy-updateset,以及更多 - 6
@提及资源 —@my-incidents,@open-changes,@sla-breaches,@instance:info,@ci:,@kb: - 通过自定义命令
nowaikit.commands.json
企业功能
- 审核日志记录 --每个工具调用都记录到JSONL文件+webhook(SIEM集成)。连接到MCP和HTTP服务器。
- SSO/OIDC --Okta/Entra/Ping IdP→ ServiceNow代币交换。
GET /auth/login+/auth/callbackHTTP服务器中的路由。 - 组织/团队政策 (
nowaikit.org.json)--admin部署配置:允许的实例、锁定的工具包、SSO强制、写控制。通过MDM或GPO进行部署。 - 每用户执行上下文 --身份验证模式:
service-account,per-user(OAuth授权码),impersonation查询尊重每个用户的ServiceNow ACL。
应用构建器集成
- HTTP API服务器 (
npm run serve)--Lovable、Bolt、v0、Replit应用程序的REST代理。在服务器端保留凭据。 - Smithery登记处 —
smithery install nowaikit一个命令安装。
v2.3的新增功能
- 作用域应用程序(App Studio)模块 —
list_scoped_apps,get_scoped_app,create_scoped_app,update_scoped_app - 创建/更新报告 —
create_report,update_report添加到报告模块 - 创建/更新仪表板 —
create_dashboard,update_dashboard添加到性能分析 - 创建门户和页面 —
create_portal,create_portal_page添加到服务门户模块 - 创建/更新目录项 —
create_catalog_item,update_catalog_item添加到目录模块 - 审批规则 —
create_approval_rule用于自动审批工作流设置
v2.2的新增功能
- 5个新模块:系统属性、更新集管理、虚拟代理创作、IT资产管理、DevOps和管道跟踪
- 真正的多实例和多客户支持 --从一个会话同时连接到无限个实例(开发、暂存、生产、客户租户)
- 每个呼叫实例路由 --通行证
instance: "name"任何工具,或switch_instance全球范围内 - 2个新的角色包 —
devops_engineer,itam_analyst system_administrator包扩展了系统属性和更新集工具
v2.1亮点
- 4个新模块:服务门户和UI生成器、集成中心、通知和附件、性能分析
- 脚本功能增强 --UI策略、UI操作、ACL管理
- 报告功能增强 --计划作业CRUD+运行历史记录
- 现在协助 —
generate_work_notes人工智能为任何记录起草工作笔记 - 2个新的角色包 —
portal_developer,integration_engineer - 二进制文件上传 —
uploadAttachment()通过ServiceNow附件API
v2.0中的新增功能
- HRSD模块 --人力资源案例、服务、简介、入职/离职工作流程
- CSM模块 --客户案例、账户、联系人、产品、SLA跟踪
- 安全运营和GRC --SecOps事件、漏洞、风险、控制、威胁情报
- 流程设计器 --列出、检查、触发和监控流和子流
- OAuth 2.0 适用于所有AI客户端
- 基于角色的工具包 --特定于角色的包
- 现在辅助代理播放手册 --人工智能自动化
- ATF故障洞察 --测试故障诊断
- 61个单元测试 涵盖所有权限层、路由和域处理程序
- 完整的文件 --参考指南
docs/
______________________________________________________________________
文档
| 指南 | 说明 |
|---|---|
| docs/TOOLS.md | 所有工具的完整参考,包括参数、返回类型和权限要求 |
| docs/CLIENT_SETUP.md | 所有AI客户端(Claude、ChatGPT、Gemini、Cursor、VS Code、Windsurf、Continue、Cline、Codex、JetBrains、Ollama)的初学者+高级设置 |
| 基于角色的包参考——14个角色包中的每一个都包括哪些工具 | |
| docs/NOW_ASSIST.md | Now Assist和AI集成指南——NLQ、AI搜索、Agent Playbook |
| docs/ATF.md | ATF测试指南——套件、试运行、ATF故障洞察 |
| docs/SCRIPTING.md | 脚本管理——业务规则、脚本包含、UI策略、UI操作、ACL、变更集 |
| 文档/报告.md | 报告和分析——聚合查询、性能分析、计划作业 |
| docs/MULTI_INSTANCE.md | 通过以下方式进行多实例配置 instances.json 或环境变量 |
| docs/SERVICENOW_OAUTH_SETUP.md | 在ServiceNow中创建OAuth应用程序以进行安全的API访问 |
| docs/INSTALLATION.md | 完整的安装指南,包括向导、企业配置、SSO和审核日志记录 |
| 客户/可爱/SETUP.md | HTTP API服务器-与Lovable、Bolt、v0、Replit应用程序集成 |
| 桌面/BUIDING.md | 构建Electron桌面应用程序并对其进行代码签名 |
| 示例.md | 120多个具有输入、输出和高级工作流的真实示例 |
______________________________________________________________________
发展
npm install # install dependencies
npm run build # compile TypeScript → dist/
npm test # run unit tests
npm run dev # watch mode (hot reload)
npm run type-check # TypeScript type check only
npm run lint # lint项目结构
src/
server.ts — MCP server entry point (stdio)
http-server.ts — HTTP API server (REST proxy for web apps)
servicenow/
client.ts — ServiceNow REST API client (Basic / OAuth / per-user)
instances.ts — Multi-instance manager
types.ts — TypeScript type definitions + AuthMode
tools/
index.ts — Tool router & role-based package system
core.ts, incident.ts, change.ts, problem.ts, task.ts
knowledge.ts, catalog.ts, user.ts, reporting.ts, atf.ts
now-assist.ts, script.ts, agile.ts, hrsd.ts, csm.ts
security.ts, flow.ts, portal.ts, integration.ts, notification.ts
performance.ts, sys-properties.ts, updateset.ts, va.ts, itam.ts, devops.ts
prompts/
index.ts — MCP prompts registry (/ slash commands)
itsm.ts — 11 built-in slash commands
user-prompts.ts — Custom commands from nowaikit.commands.json
resources/
index.ts — MCP resources (@ mentions)
auth/
sso.ts — OIDC/SSO module (IdP → ServiceNow token exchange)
dashboard/
html.ts — Web dashboard (served at GET /)
cli/
index.ts — CLI entry point (commander.js)
setup.ts — Interactive setup wizard
detect-clients.ts — Auto-detect installed AI clients
config-store.ts — ~/.config/nowaikit/instances.json
auth.ts — nowaikit auth login/logout/whoami
writers/index.ts — Write configs to AI client config files
utils/
permissions.ts — Five-tier permission gate functions
audit.ts — Structured JSONL audit logger + webhook
org-config.ts — Org/team policy loader (nowaikit.org.json)
errors.ts — Typed error classes
logging.ts — Structured logger
desktop/
main/ — Electron main process (Node.js)
renderer/src/ — React 18 UI (Vite)
electron-builder.yml — Cross-platform packaging config
BUILDING.md — Desktop build & code-signing guide
tests/
tools/ — Unit tests
docs/ — Reference documentation
clients/
claude-desktop/ — Claude Desktop setup guide
cursor/ — Cursor setup guide
vscode/ — VS Code setup guide
claude-code/ — Claude Code setup guide
lovable/ — Lovable/Bolt/v0/Replit HTTP proxy guide
codex/ — OpenAI Codex Python client
gemini/ — Google Gemini Python client
smithery.yaml — Smithery registry config______________________________________________________________________
贡献
欢迎捐款。请阅读 贡献.md 在打开pull请求之前。
- Bug报告和功能请求: 打开一个问题
- 特别感谢新的工具域、额外的测试或文档改进
- 所有PR都需要
npm test通过
______________________________________________________________________
安全
如果您发现安全漏洞,请按照 安全.md。不要公开问题。
______________________________________________________________________
常见问题
我需要了解ServiceNow API才能使用它吗? 不需要。对于初学者来说,你只需连接你的人工智能,用简单的英语提问。该套件自动处理所有API调用。
支持哪些ServiceNow版本? 所有积极支持的ServiceNow版本。该工具包针对最新可用的API,并在最近的三个版本上进行了测试-- 苏黎世, 横滨,以及 上都 --并适用于当前支持的任何实例。
我可以在免费的个人开发人员实例(PDI)上使用它吗? 对。在以下网址获取免费PDI developer.servicenow.com 并在5分钟内连接。
在生产中使用安全吗? 对。默认情况下,权限系统是只读的。必须使用环境变量显式启用写入、脚本和Now Assist功能。使用角色包来限制工具表面。
我可以同时使用多个AI提供商吗? 对。每个AI客户端都有自己的MCP配置,指向相同(或不同)的NowAIKit实例。在相同的ServiceNow环境中并行运行Claude Desktop和Cursor。在nowaikit Desktop应用程序中,您可以在聊天页面内单击一下,在Claude、ChatGPT和Gemini之间切换。
它是否支持多实例/多客户? 对。通过以下方式配置任意数量的实例(prod、staging、dev或多个客户租户) instances.json 或环境变量。使用 list_instances, switch_instance,以及 get_current_instance 管理或传递它们的工具 instance: "name" 任何单独的工具调用。看 docs/MULTI_INSTANCE.md.
免费吗? 完全免费用于个人和商业目的。看 许可证 了解详情。
______________________________________________________________________
许可证
来源可用 --免费用于个人和商业目的。有关详细信息,请参阅许可证。
______________________________________________________________________
您唯一需要的ServiceNow AI工具包。
400多种工具。31+模块。每一个AI平台。真正的多实例。免费使用。
现在AIKit •ServiceNow MCP服务器•ServiceNow AI代理•ServiceNow克劳德集成•ServiceNow ChatGPT•ServiceNow游标•ServiceNow Gemini•ServiceNow自动化•ServiceNow开发工具•ServiceNow多实例•ServiceNow MSP
如果NowAIKit为您节省时间,请⭐ 启动存储库——它可以帮助其他人找到项目。
](../../stargazers)
由Hardik Benani建造· 阿尔提克。
