# IT Glue

Даёт ИИ-ассистенту доступ к документации IT Glue: читать, искать и аккуратно править документы и гибкие активы.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: mspstack
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mspstack/mcp-itglue
- Обновлён: 2026-09-16
- HTML: https://affpapa.org/nevibecode/mcp/mspstack-it-glue

## Что делает

Сервер оборачивает API IT Glue в инструменты MCP. Ассистент перечисляет организации, документы и их разделы, читает гибкие активы вместе с их полями, загружает картинки внутрь документа и прикрепляет файлы к панели Attachments. Семантический поиск по векторам находит нужный регламент, даже когда формулировка в запросе не совпадает с текстом — индекс лежит локально в JSON, а эмбеддинги считает OpenAI или Azure OpenAI.

Доступ разграничен ролевыми токенами: viewer, editor и admin. Инструменты, недоступные роли, в сессии вообще не регистрируются, поэтому viewer не увидит в списке создание документа, а на каждом вызове роль проверяется заново. Клиент может передать свой ключ IT Glue в заголовке `x-itglue-api-key` — тогда действуют права этого ключа. Политику задаёт `CLIENT_ITGLUE_KEYS`: значение `with-token` требует ещё и bearer-токен, `open` пускает по одному ключу IT Glue, `disabled` отклоняет заголовок.

Заранее нужен ключ API IT Glue (Account → Settings → API Keys). Для аккаунтов вне США выставьте `ITGLUE_REGION` в `eu` или `au`. Если ролевые токены не заданы, сервер уходит в dev-режим и выдаёт всем права admin — в продакшене так делать не стоит. Сессии живут в памяти, поэтому за балансировщиком держите один экземпляр или включайте sticky sessions.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ITGLUE_API_KEY`, `ITGLUE_REGION`, `ITGLUE_BASE_URL`, `OPENAI_API_KEY`, `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_ENDPOINT`, `EMBEDDING_MODEL`, `ITGLUE_ADVANCED_TOOLSET`, `VECTOR_INDEX_PATH`, `UPLOAD_STAGING` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env ITGLUE_API_KEY=<ITGLUE_API_KEY> --env ITGLUE_REGION=<ITGLUE_REGION> --env ITGLUE_BASE_URL=<ITGLUE_BASE_URL> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env AZURE_OPENAI_API_KEY=<AZURE_OPENAI_API_KEY> --transport stdio mspstack-it-glue -- npx -y mcp-itglue
```
Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add mspstack-it-glue --env ITGLUE_API_KEY=<ITGLUE_API_KEY> --env ITGLUE_REGION=<ITGLUE_REGION> --env ITGLUE_BASE_URL=<ITGLUE_BASE_URL> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env AZURE_OPENAI_API_KEY=<AZURE_OPENAI_API_KEY> -- npx -y mcp-itglue
```
Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mspstack-it-glue": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-itglue"
            ],
            "env": {
                "ITGLUE_API_KEY": "<ITGLUE_API_KEY>",
                "ITGLUE_REGION": "<ITGLUE_REGION>",
                "ITGLUE_BASE_URL": "<ITGLUE_BASE_URL>",
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mspstack-it-glue": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-itglue"
            ],
            "env": {
                "ITGLUE_API_KEY": "<ITGLUE_API_KEY>",
                "ITGLUE_REGION": "<ITGLUE_REGION>",
                "ITGLUE_BASE_URL": "<ITGLUE_BASE_URL>",
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "AZURE_OPENAI_API_KEY": "<AZURE_OPENAI_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ITGLUE_API_KEY=<ITGLUE_API_KEY> -e ITGLUE_REGION=<ITGLUE_REGION> -e ITGLUE_BASE_URL=<ITGLUE_BASE_URL> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e AZURE_OPENAI_API_KEY=<AZURE_OPENAI_API_KEY> mspstack-it-glue npx -y mcp-itglue
```
Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера

## Когда брать
- найти регламент по смыслу, а не по точному слову
- дописать раздел в существующий документ
- загрузить скриншот в галерею документа
- прикрепить файл к карточке конфигурации
- выдать подрядчику доступ только на чтение

## Примеры запросов агенту
- Найди в IT Glue инструкцию по выводу из эксплуатации бэкап-агента
- Создай документ «Порядок онбординга» в организации Acme
- Прикрепи `network-diagram.png` к карточке этого гибкого актива

## Похожие
- [developer-portal-design](https://affpapa.org/nevibecode/skills/developer-portal-design.md) — скилл · 8100 установок
- [ThreatLocker MCP](https://affpapa.org/nevibecode/mcp/threatlocker-mcp.md) — MCP-сервер · ★ 63
- [Tactical RMM MCP](https://affpapa.org/nevibecode/mcp/tactical-rmm-mcp.md) — MCP-сервер · ★ 63

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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