# servicenow-mcp-ai

Подключает ИИ-ассистентов к REST API ServiceNow: чтение и правка записей, анализ бизнес-правил, аудит расхождений и трейсинг цепочек исполнения.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: IvanBBaev
- Лицензия: GPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/IvanBBaev/servicenow-mcp-ai
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/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` и параметры аутентификации пользователя.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `SN_INSTANCE`, `SN_USER`, `SN_PASSWORD`, `SN_AUTH`, `SN_API_KEY`, `SN_TOOL_PACKAGES` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: ServiceNow

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 сервера

## Когда брать
- Найти использование поля или скрипта во всех бизнес-правилах и макетах
- Проверить цепочку триггеров и потоков перед сохранением записи в таблицу
- Сравнить структуру таблиц и скрипты между dev и prod через CLI drift
- Выполнять пакетные запросы и выгружать вложения через REST API ServiceNow

## Примеры запросов агенту
- Покажи, в каких бизнес-правилах и клиентских скриптах задействовано поле `u_cost_center`.
- Вызови `servicenow_trace_table_event` для операции обновления в таблице `incident`.
- Найди все вызовы функции `getDisplayValue` через инструмент `servicenow_search_code`.

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16730
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24271
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7548

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md