13. KI-Assistent: der MCP-Server der Dokumentation #

← Versionshinweise · Inhalt

Ein KI-Assistent (Claude Code, Claude Desktop, Cursor, VS Code…), der PowerScript für PBToolboxAI schreibt, kennt die Bibliothek nicht: Er rät Methodennamen, Argumente, Ereignisse — und irrt sich mit Überzeugung. Der MCP-Server der Dokumentation gibt ihm die genaue API Ihrer Version: Er schlägt sie nach, statt sie zu erfinden, und prüft den Code, den er Ihnen vorschlägt.

13.1 Was es ist #

Ein MCP-Server (Model Context Protocol, das offene Protokoll, über das ein KI-Assistent Werkzeuge aufruft), vom Assistenten selbst gestartet.
Kostenlos, ohne Lizenz: Er liefert nur die öffentliche Dokumentation, die ihm beiliegt. Er arbeitet offline und liest oder sendet nichts von Ihrem Rechner.
Eine Dokumentationsversion je Bibliotheksversion: Der mit 4.0 gelieferte Server beschreibt 4.0.

13.2 Installation #

Er wird im Demopaket geliefert, im Ordner mcp\: der Server (server\server.js), die Dokumentation, die er liefert (index\), und eine README.md. Nichts herunterzuladen, nichts anderes zu installieren als Node.js 18 oder neuer (nodejs.org) — node --version zeigt Ihre Version.

Entpacken Sie das Paket und legen Sie den Ordner mcp\ dort ab, wo er bleiben soll — zum Beispiel C:\PBToolboxAI\mcp\, der Pfad der Beispiele unten: Die Konfiguration des Assistenten nennt den vollständigen Pfad von server\server.js.

13.3 Beim Assistenten anmelden #

Überall ist der Befehl node und sein Argument der vollständige Pfad von server\server.js. In einer JSON-Datei wird jeder Backslash des Pfads verdoppelt.

Claude Code — eine Befehlszeile. Die Optionen stehen vor dem Servernamen; --scope user macht ihn in all Ihren Projekten verfügbar (ohne diese Option nur im aktuellen Projekt):

claude mcp add --scope user pbtoolboxai-docs -- node C:\PBToolboxAI\mcp\server\server.js

Ein Pfad mit Leerzeichen steht in doppelten Anführungszeichen:

claude mcp add --scope user pbtoolboxai-docs -- node "C:\Program Files\PBToolboxAI\mcp\server\server.js"

Oder, für das ganze Team eines Projekts, die Datei .mcp.json in seinem Stammverzeichnis (das schreibt claude mcp add --scope project) — Claude Desktop und Cursor übernehmen denselben Inhalt:

{
  "mcpServers": {
    "pbtoolboxai-docs": {
      "command": "node",
      "args": ["C:\\PBToolboxAI\\mcp\\server\\server.js"]
    }
  }
}

Claude Desktop: Settings › Developer › Edit Config öffnet claude_desktop_config.json (%APPDATA%\Claude\ unter Windows). Speichern, dann Claude Desktop vollständig beenden und neu starten.
Cursor: .cursor/mcp.json im Stammverzeichnis des Projekts oder ~/.cursor/mcp.json für all Ihre Projekte.

VS Code — .vscode/mcp.json im Projekt oder der Befehl MCP: Open User Configuration für all Ihre Arbeitsbereiche; der Schlüssel heißt servers, der Typ stdio:

{
  "servers": {
    "pbtoolboxai-docs": {
      "type": "stdio",
      "command": "node",
      "args": ["C:\\PBToolboxAI\\mcp\\server\\server.js"]
    }
  }
}

13.4 Die Werkzeuge #

Der Assistent wählt selbst das Werkzeug, das seine Frage beantwortet:

Werkzeug	Was es beantwortet
`list_components`	Die Komponenten: Klasse, visuell oder nicht, Einführungsversion, kostenlos oder kostenpflichtig, Rubrik
`get_component`	Die gesamte API einer Komponente: Eigenschaften, Methoden, Ereignisse, Konstanten, Element-Handles, geerbte Mitglieder; `dll` liefert die zu deklarierenden externen Funktionen der DLL
`get_member`	Ein Mitglied: genaue Signatur und Überladungen, Rückgabecodes, Beschreibung, ein Beispiel, was sich von Version zu Version geändert hat; auch die genaue Deklaration einer `PBT_*`-Funktion
`get_topic`	Eine allgemeine Seite oder einer ihrer Abschnitte vollständig: Installation, Themes, Rich-Text-Auszeichnung, Sprache, Lizenz…
`search`	Eine Freitextsuche in der gesamten Dokumentation, sortierte Ergebnisse
`get_examples`	Die vollständigen PowerScript-Beispiele einer Komponente
`check_code`	Prüft PowerScript: unbekannte Methode oder Eigenschaft, ein anstelle einer Eigenschaft erfundenes `of_set_`/`of_get_`, unbekanntes Ereignis oder eines mit seinen früheren Argumenten, falsche Argumentanzahl, entferntes Mitglied, ein Handle, das etwas aufbauen soll, falsche Annotation `/name/`, altes Vokabular, nicht vorhandenes Ereignisargument, der Code einer Hinzufügung, der für ein Handle gehalten oder wie ein Objekt aufgerufen wird
`get_migration`	Die Migrationsleitfäden, von jeder Version zur nächsten (standardmäßig der neueste), für eine Komponente oder für alle

13.5 Das Beste daraus machen #

Bitten Sie den Assistenten, seinen Code durch check_code zu prüfen, bevor er ihn vorschlägt.
check_code prüft ein Objekt vollständig, dessen Typ im Auszug deklariert ist (u_pbt_ribbon uo_ribbon); ohne Deklaration prüft es nur den Namen und die Anzahl der Argumente.
Aktualisieren Sie nach einem Update der Bibliothek auch den Server — ersetzen Sie den Ordner mcp\ durch den des neuen Demopakets: Er beschreibt die Version, mit der er geliefert wurde.