SuperOps IT Documentation MCP Server

Servidor MCP para buscar, leer y actualizar la documentación de TI de SuperOps mediante lenguaje natural. Diseñado para ejecutarse junto al servidor MCP de WYRE-AI para SuperOps (que gestiona tickets, activos y clientes).

Herramientas

Related MCP server: Jamf Docs MCP Server

Requisitos previos

• Node.js 18+ (para el fetch integrado)

• Tu token de API de SuperOps (Configuración > Mi perfil > Token de API)

Instalación

# 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

Configuración

Establece estas variables de entorno (o ponlas en un archivo .env):

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

Ejecución

# Compiled
npm start

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

Configuración de Onyx

En los ajustes de MCP de Onyx, añade este servidor junto al de 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"
      }
    }
  }
}

Ejemplos de uso (en Onyx o en cualquier cliente MCP)

• "Enumera todos los documentos de NOMBRE DEL CLIENTE"

• "Obtén la documentación de WireGuard VPN"

• "Busca documentos sobre copias de seguridad"

• "Actualiza el documento de CLIENTE — añade una nota: nuevo firewall instalado 2026-08-26"

• "Encuentra documentos sobre impresoras para CLIENTE A"

Cómo funciona

• Utiliza la API GraphQL de SuperOps (getItDocumentationList, getItDocumentation, updateItDocumentation)

• El contenido de la documentación de TI se almacena en el campo personalizado udf2rtxt como HTML

• Las actualizaciones de contenido utilizan el formato de envoltorio JSON {"content": "..."} (probado y funcionando)

• Las imágenes se incrustan como URIs de datos base64 en el contenido HTML