MCP-Server

Labelixa betreibt einen Remote-MCP-Server (Model Context Protocol): MCP-kompatible KI-Clients können Etikettencode als vollwertige Werkzeuge previewen, validieren, diagnostizieren und Barcodes erzeugen. Verifiziert mit Claude Desktop und Claude Code; jeder MCP-kompatible Client kann sich verbinden.

Verfügbare Werkzeuge

Die Werkzeuge, die der Server HEUTE anbietet — die Liste wird aus der Live-Registrierung erzeugt, nicht von Hand gepflegt:

zpl_preview — Render ZPL label code and return the label as a PNG image.
zpl_validate — Lint ZPL code and return structured diagnostics: unknown commands, missing ^FS, out-of-range parameters, fields outside the label boundary.
zpl_command_help — Explain a single ZPL command: syntax, parameters with types/ranges/options, a fragment example and whether the Labelixa renderer draws it.
barcode_png — Generate a single barcode as a PNG image (Code 128, QR, DataMatrix, EAN-13, UPC-A, PDF417 and more).
language_detect — Detect which printer language raw label code is written in (ZPL, EPL, TSPL or CPCL).
epl_validate — Lint EPL/EPL2 label code; returns positioned findings with severity as JSON.
tspl_validate — Lint TSPL/TSPL2 label code; returns positioned findings with severity as JSON.
cpcl_validate — Lint CPCL label code; returns positioned findings with severity as JSON.
explain_zpl — Full health report for a ZPL label: sectioned findings (syntax, size/DPI, orientation, barcodes, fonts, graphics memory, job behaviour) with an honest score — sections that cannot be assessed say so and are excluded from the score.
convert_zpl_dpi — Rescale ZPL between printer resolutions (203/300/600 DPI): coordinates, fonts, barcode module width and label size are scaled.
zpl_compatibility — Compatibility RISK analysis of ZPL code against a specific printer model (e.g.

Endpunkt

Streamable HTTP (JSON-RPC): https://api.labelixa.com/mcp. GET liefert diese Seite; das Protokoll spricht über POST.

Authentifizierung und Kontingente

Kein Schlüssel nötig: anonyme Aufrufe teilen die kostenlose, pro IP ratenbegrenzte Stufe. Senden Sie Ihren Schlüssel im X-API-Key-Header (oder als Bearer-Token), um das Tageskontingent Ihres Tarifs zu nutzen. MCP-Aufrufe durchlaufen dieselben Raten- und Kontingent-Tore wie die REST-API — MCP ist kein Kontingent-Bypass.

Konfiguration

Fügen Sie den Server Ihrem MCP-kompatiblen Client hinzu (Claude-Desktop-Format gezeigt). Lokale stdio-Alternative auf npm: labelixa-mcp.

{
  "mcpServers": {
    "labelixa": {
      "type": "http",
      "url": "https://api.labelixa.com/mcp"
    }
  }
}

Sicherheit und Datenschutz

Werkzeugaufrufe folgen demselben zustandslosen Pfad wie die REST-API: gesendeter Etikettencode wird im Speicher verarbeitet und zurückgegeben, nicht gespeichert. Details auf der Sicherheitsseite.