microtech Agent Skills

Dieses Repository enthält Agent Skills für die microtech ERP. Die Skills ermöglichen es, mit natürlicher Sprache direkt auf ERP-Daten zuzugreifen und Geschäftsprozesse auszuführen.

Agent Skills sind ein offener Standard für KI-gestützte Werkzeuge und werden von über 25 Produkten unterstützt, darunter Claude Code, OpenAI Codex CLI, Cursor, VS Code Copilot, Gemini CLI und viele mehr.

microtech-graphql

Übersetzt natürliche Sprache in korrekte GraphQL-Queries für das microtech ERP. Der Skill enthält:

• SKILL.md - Kompakte Referenz mit allen Regeln, Patterns und Troubleshooting
• references/ - 13 Detail-Dokumente:

Datei	Inhalt
adressen-verwaltung.md	Adressen, Anschriften, Ansprechpartner: CRUD, verschachtelte Links, assign-Parameter
parametertabellen.md	30 ERP-Parametertabellen (Vorgangsarten, Steuerschlüssel, Zahlungsbedingungen, ...)
feldkatalog-adressen.md	Felder für Adressen, Anschriften, Ansprechpartner, Kontakte
feldkatalog-artikel.md	Felder für Artikel, Warengruppen, Lieferanten
feldkatalog-vorgaenge.md	Felder für Vorgänge und Positionen
feldkatalog-weitere.md	Felder für 19 weitere Tabellen (Projekte, Lager, FiBu, ...)
erweiterte-query-patterns.md	keyFilter, fastFilter, slowFilter, Arithmetik
introspection-guide.md	Schema-Typ-Namenskonventionen, Introspection-Beispiele
mutation-patterns.md	Optimistic Locking, rowCopy, ifNotExists, Deep Nesting
vorgaenge-erweitert.md	Archiv, externe Bearbeitung, Berechtigungen
workflow-beispiele.md	17 vollständige Szenarien (Rechnung, Wandlung, Storno, ...)
vorgangsarten.md	Alle Standard-Vorgangsarten mit Nummern
betragsgruppen.md	Betragsgruppen (aco...) lesen und schreiben

Was der Skill kann:

• Artikel, Adressen, Vorgänge und weitere ERP-Daten abfragen und filtern
• Belege anlegen, buchen, stornieren und wandeln
• Adressen mit Anschriften und Ansprechpartnern verschachtelt verwalten
• Lagerbestände, offene Posten, Kontenplan abfragen
• ERP-Parametertabellen auslesen (Vorgangsarten, Steuerschlüssel, Einheiten, ...)
• Schema-Felder dynamisch per Introspection nachschlagen

Voraussetzungen

In microtech ERP

• GraphQL-Server ist eingerichtet und läuft (siehe GraphQL Entwickler Dokumentation)
• OAuth-Anwendung ist angelegt (siehe OAuth 2.0 API-Dokumentation)
• Bearer Token wurde generiert (siehe Bearer Token Generator)
• Der Benutzer hat das Kennzeichen "Zugriff über GraphQL erlaubt" aktiviert

Auf Ihrem Computer

• Node.js (LTS-Version)
• Ein KI-Tool mit Agent-Skills-Unterstützung (z.B. Claude Code, Codex CLI, Cursor, Gemini CLI)

MCP-Server einrichten

Die Skills benötigen eine Verbindung zur microtech ERP GraphQL-Schnittstelle über das npm-Paket mcp-graphql. Die Schritt-für-Schritt-Anleitung finden Sie hier: Claude mit microtech GraphQL verbinden (MCP)

Installation

Empfohlen: Mit Skills CLI (alle Tools)

Der schnellste Weg ist der Skills CLI von Vercel. Er erkennt automatisch, welche KI-Tools installiert sind (Claude Code, Codex, Cursor, OpenCode) und kopiert den Skill an den richtigen Ort.

npx skills add microtech-GmbH/microtech-skills

Weitere Optionen:

Verfügbare Skills auflisten:

npx skills add microtech-GmbH/microtech-skills --list

Nur einen bestimmten Skill installieren:

npx skills add microtech-GmbH/microtech-skills --skill microtech-graphql

Global installieren (für alle Projekte):

npx skills add microtech-GmbH/microtech-skills -g

Für alle erkannten Agents, ohne Rückfragen:

npx skills add microtech-GmbH/microtech-skills --all

Alternativ: Manuell

1. Auf dieser GitHub-Seite oben auf den grünen Button Code klicken
2. Download ZIP wählen und entpacken
3. Den Skill-Ordner (z.B. microtech-graphql/) in das Skills-Verzeichnis Ihres KI-Tools kopieren:

Tool	Projektpfad
Claude Code	.claude/skills/microtech-graphql/
Codex CLI	.codex/skills/microtech-graphql/
Cursor	.cursor/skills/microtech-graphql/
OpenCode	.opencode/skill/microtech-graphql/

Die meisten Tools erkennen den Skill automatisch beim nächsten Start.

Schnelltest

Nach der Einrichtung testen:

Zeig mir alle microtech Adressen aus PLZ 555xx mit Hilfe des GraphQL MCP auf und zeige mir die Daten in Tabellenform an.

Wenn alles korrekt eingerichtet ist, erhält man eine Tabelle mit Adressdaten aus microtech ERP.

Lizenz

Dieses Projekt steht unter der MIT-Lizenz.