servicenow-mcp-ai — MCP-сервер для Claude Code: запуск и обзор
Подключает ИИ-ассистентов к REST API ServiceNow: чтение и правка записей, анализ бизнес-правил, аудит расхождений и трейсинг цепочек исполнения.
claude mcp add --env SN_INSTANCE=<SN_INSTANCE> --env SN_USER=<SN_USER> --env SN_PASSWORD=<SN_PASSWORD> --env SN_AUTH=<SN_AUTH> --env SN_API_KEY=<SN_API_KEY> --transport stdio servicenow-mcp-ai -- npx -y servicenow-mcp-aiЧто делает servicenow-mcp-ai
Сервер открывает ассистенту доступ к REST API экземпляра ServiceNow: Table API, Batch, Import Set, Aggregate и Attachment. В состав входят инструменты для CMDB с выверкой IRE, каталога услуг Service Catalog, инцидентов Change Management и базы знаний. Сервер запускается через Node.js вызовом npx -y servicenow-mcp-ai.
Инструменты servicenow_where_used и servicenow_search_code сканируют код инстанса — бизнес-правила, клиентские скрипты, политики интерфейса и списки контроля доступа. Функция servicenow_trace_table_event воспроизводит последовательность триггеров на таблице от синхронных правил до оповещений без фактического запуска логики.
Мутации защищены: операции изменения записей по умолчанию работают в режиме предварительного плана и не применяют правки без явного подтверждения apply: true. Для работы с приватным инстансом потребуются сетевой адрес в переменной SN_INSTANCE и параметры аутентификации пользователя.
Какие задачи решает
- Найти использование поля или скрипта во всех бизнес-правилах и макетах
- Проверить цепочку триггеров и потоков перед сохранением записи в таблицу
- Сравнить структуру таблиц и скрипты между dev и prod через CLI drift
- Выполнять пакетные запросы и выгружать вложения через REST API ServiceNow
Примеры запросов агенту
- Покажи, в каких бизнес-правилах и клиентских скриптах задействовано поле
u_cost_center. - Вызови
servicenow_trace_table_eventдля операции обновления в таблицеincident. - Найди все вызовы функции
getDisplayValueчерез инструментservicenow_search_code.
Как установить servicenow-mcp-ai
Командой платформы
claude mcp add --env SN_INSTANCE=<SN_INSTANCE> --env SN_USER=<SN_USER> --env SN_PASSWORD=<SN_PASSWORD> --env SN_AUTH=<SN_AUTH> --env SN_API_KEY=<SN_API_KEY> --transport stdio servicenow-mcp-ai -- npx -y servicenow-mcp-aiВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add servicenow-mcp-ai --env SN_INSTANCE=<SN_INSTANCE> --env SN_USER=<SN_USER> --env SN_PASSWORD=<SN_PASSWORD> --env SN_AUTH=<SN_AUTH> --env SN_API_KEY=<SN_API_KEY> -- npx -y servicenow-mcp-aiВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"servicenow-mcp-ai": {
"command": "npx",
"args": [
"-y",
"servicenow-mcp-ai"
],
"env": {
"SN_INSTANCE": "<SN_INSTANCE>",
"SN_USER": "<SN_USER>",
"SN_PASSWORD": "<SN_PASSWORD>",
"SN_AUTH": "<SN_AUTH>",
"SN_API_KEY": "<SN_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"servicenow-mcp-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"servicenow-mcp-ai"
],
"env": {
"SN_INSTANCE": "<SN_INSTANCE>",
"SN_USER": "<SN_USER>",
"SN_PASSWORD": "<SN_PASSWORD>",
"SN_AUTH": "<SN_AUTH>",
"SN_API_KEY": "<SN_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e SN_INSTANCE=<SN_INSTANCE> -e SN_USER=<SN_USER> -e SN_PASSWORD=<SN_PASSWORD> -e SN_AUTH=<SN_AUTH> -e SN_API_KEY=<SN_API_KEY> servicenow-mcp-ai npx -y servicenow-mcp-aiВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о servicenow-mcp-ai
Как установить servicenow-mcp-ai в Claude Code?
Выполните команду `claude mcp add --env SN_INSTANCE=<SN_INSTANCE> --env SN_USER=<SN_USER> --env SN_PASSWORD=<SN_PASSWORD> --env SN_AUTH=<SN_AUTH> --env SN_API_KEY=<SN_API_KEY> --transport stdio servicenow-mcp-ai -- npx -y servicenow-mcp-ai`. Подставьте адрес инстанса и ваши учётные данные вместо плейсхолдеров.
Что делает servicenow-mcp-ai?
Сервер транслирует команды ассистента к REST API ServiceNow, позволяя читать таблицы, управлять записями CMDB, искать зависимости скриптов и отслеживать логику автоматизации.
Как работает защита от случайного изменения данных?
Вызовы создания, редактирования и удаления записей по умолчанию возвращают предварительный план действий. Для реального выполнения мутации требуется передать флаг apply: true.
