SuperOps IT Documentation MCP Server

MCP-Server zum Durchsuchen, Lesen und Aktualisieren der SuperOps IT Documentation über natürliche Sprache. Entwickelt für den Betrieb neben dem WYRE-AI SuperOps MCP server (der Tickets, Assets und Clients verwaltet).

Tools

Related MCP server: Jamf Docs MCP Server

Voraussetzungen

• Node.js 18+ (für integriertes fetch)

• Ihr SuperOps-API-Token (Einstellungen > Mein Profil > API-Token)

Installation

# 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

Konfiguration

Setzen Sie diese Umgebungsvariablen (oder hinterlegen Sie sie in einer .env-Datei):

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

Ausführen

# Compiled
npm start

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

Onyx-Konfiguration

Fügen Sie in Ihren Onyx-MCP-Einstellungen diesen Server neben dem von WYRE-AI hinzu:

{
  "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"
      }
    }
  }
}

Verwendungsbeispiele (in Onyx oder einem beliebigen MCP-Client)

• "Liste alle Dokumente für KUNDENNAME auf"

• "Rufe die WireGuard-VPN-Dokumentation ab"

• "Suche nach Backup-Dokumenten"

• "Aktualisiere das KUNDEN-Dokument — füge Notiz hinzu: neue Firewall am 2026-08-26 installiert"

• "Finde Dokumente über Drucker für KUNDE A"

So funktioniert es

• Verwendet die SuperOps-GraphQL-API (getItDocumentationList, getItDocumentation, updateItDocumentation)

• Der Inhalt der IT Documentation wird im benutzerdefinierten Feld udf2rtxt als HTML gespeichert

• Inhaltsaktualisierungen verwenden das JSON-Wrapper-Format {"content": "..."} (nachweislich funktionsfähig)

• Bilder werden als base64-Daten-URIs in den HTML-Inhalt eingebettet