MCP-Server

Notory stellt einen MCP-Server bereit (Model Context Protocol). Damit verbindest du jeden KI-Assistenten, der MCP unterstützt, direkt mit deiner Notory-Instanz: Der Assistent kann dann deinen Bestand lesen und - mit passendem Token - auch pflegen, indem er im Hintergrund die Notory-REST-API aufruft. Der Server ist client-neutral; es ist egal, welche MCP-fähige Anwendung du einsetzt.

Was der Assistent kann

Der Server stellt diese Werkzeuge bereit:

Werkzeug	Zweck
`notory_list_endpoints`	Verfügbare API-Endpunkte aus der Live-OpenAPI-Spec auflisten (optional gefiltert).
`notory_get`	Beliebigen Endpunkt lesen (nur `GET`).
`notory_request`	Beliebigen Endpunkt mit beliebiger Methode aufrufen (Schreiben braucht `write`-Scope).
`notory_list_assets`	Assets mit Filtern und Seitenblätterung auflisten.
`notory_get_asset`	Ein einzelnes Asset per ID holen.

Da notory_list_endpoints und notory_request zusammen die gesamte API abdecken (200+ Endpunkte), kann der Assistent mit Assets, Netzwerk, Software, Lizenzen, Zertifikaten, Compliance und mehr arbeiten - nicht nur mit den Komfort-Werkzeugen.

Voraussetzungen

Node.js 18+ auf dem Rechner, auf dem der Assistent läuft.
Ein Notory-API-Token. Lege ihn in der Weboberfläche unter Einstellungen → API-Tokens an (siehe API-Tokens). Der Token wird nur einmal im Klartext angezeigt und beginnt mit inv_. Vergib den read-Scope, um den Assistenten nur lesen zu lassen, oder write für Änderungen.

Einrichten

1. Server holen und bauen:

# aus dem Notory-MCP-Repository
npm install
npm run build

2. Server beim MCP-Client eintragen. Nahezu alle MCP-fähigen Clients lesen eine JSON-Konfiguration mit einem mcpServers-Abschnitt. Trage den Server dort so ein (Pfad, Basis-URL und Token anpassen):

{
  "mcpServers": {
    "notory": {
      "command": "node",
      "args": ["/absoluter/pfad/zu/notory_mcp/dist/index.js"],
      "env": {
        "NOTORY_BASE_URL": "https://demo.notory.io",
        "NOTORY_API_TOKEN": "inv_dein_token_hier"
      }
    }
  }
}

Wo genau diese Konfiguration liegt, hängt vom Client ab (meist eine JSON-Datei in dessen Einstellungen). Der Start-Befehl bleibt derselbe: node .../dist/index.js mit den beiden Umgebungsvariablen.

3. Client neu starten. Danach kannst du z. B. fragen: “Liste die Assets in Wartung” oder “Zeig mir Asset SN-001”.

Konfiguration

Variable	Pflicht	Beschreibung
`NOTORY_BASE_URL`	ja	Basis-URL der Instanz, z. B. `https://demo.notory.io` (ohne `/api` am Ende).
`NOTORY_API_TOKEN`	ja	Notory-API-Token (`inv_...`). Der Scope entscheidet über Nur-Lesen vs. Lesen/Schreiben.

Gut zu wissen

Bevorzuge einen read-Token, solange der Assistent nichts ändern muss.
Der Server ist ein dünner, zustandsloser Proxy über HTTPS - es werden keine Daten gespeichert.
Die maschinenlesbare Spec liegt unter OpenAPI-Spezifikation (JSON); die durchsuchbare Referenz unter API-Referenz.

Verwandt

API-Einstieg - Authentifizierung, Basis-URL, Fehlercodes.
API-Tokens verwalten - Token erstellen und widerrufen.