MCP-сервер для IT-документации SuperOps

MCP-сервер для поиска, чтения и обновления IT-документации SuperOps с помощью естественного языка. Предназначен для работы вместе с WYRE-AI SuperOps MCP server (который обрабатывает тикеты, активы и клиентов).

Инструменты

Related MCP server: superops-mcp

Предварительные требования

• Node.js 18+ (для встроенного fetch)

• Ваш API-токен SuperOps (Settings > My Profile > API Token)

Установка

# 1. Clone or copy this folder to your machine
git clone <this-repo> superops-docs-mcp
cd superops-docs-mcp

# 2. Install dependencies
npm install

# 3. Build
npm run build

Конфигурация

Задайте эти переменные окружения (или поместите их в файл .env):

export SUPEROPS_API_TOKEN="your-api-token-here"
export SUPEROPS_SUBDOMAIN="superopssubdomainhere"    # your SuperOps subdomain
export SUPEROPS_REGION="us"                      # "us" or "eu"

Запуск

# Compiled
npm start

# Or dev mode (no build needed)
npm run dev

Конфигурация Onyx

В настройках Onyx MCP добавьте этот сервер вместе с сервером WYRE-AI:

{
  "mcpServers": {
    "superops-docs": {
      "command": "node",
      "args": ["/path/to/superops-docs-mcp/dist/index.js"],
      "env": {
        "SUPEROPS_API_TOKEN": "your-api-token-here",
        "SUPEROPS_SUBDOMAIN": "subdomain",
        "SUPEROPS_REGION": "us"
      }
    },
    "superops": {
      "command": "npx",
      "args": ["@wyre-ai/superops-mcp"],
      "env": {
        "SUPEROPS_API_TOKEN": "your-api-token-here",
        "SUPEROPS_SUBDOMAIN": "subdomain",
        "SUPEROPS_REGION": "us"
      }
    }
  }
}

Примеры использования (в Onyx или любом MCP-клиенте)

• "Перечислить все документы для CUSTOMER NAME"

• "Получить документацию WireGuard VPN"

• "Искать документы по бэкапам"

• "Обновить документ CUSTOMER — добавить примечание: установлен новый файрвол 2026-08-26"

• "Найти документы о принтерах для CLIENT A"

Как это работает

• Использует GraphQL API SuperOps (getItDocumentationList, getItDocumentation, updateItDocumentation)

• Содержимое IT-документации хранится в пользовательском поле udf2rtxt в виде HTML

• Обновления содержимого используют формат JSON-обёртки {"content": "..."} (проверено, работает)

• Изображения встраиваются в HTML-содержимое как data URI в кодировке base64