PBToolboxAI v4 ← Site

13. Assistente IA: il server MCP della documentazione #

← Note di versione · Sommario

Un assistente IA (Claude Code, Claude Desktop, Cursor, VS Code…) che scrive PowerScript per PBToolboxAI non conosce la libreria: indovina nomi di metodi, argomenti, eventi — e sbaglia con sicurezza. Il server MCP della documentazione gli fornisce l'API esatta della Sua versione: la consulta invece di inventarla, e verifica il codice che Le propone.

13.1 Che cos'è #

13.2 Installarlo #

È fornito nel pacchetto dimostrativo, nella cartella mcp\: il server (server\server.js), la documentazione che serve (index\) e un README.md. Niente da scaricare, niente altro da installare se non Node.js 18 o successivo (nodejs.org) — node --version Le indica la Sua versione.

Decomprima il pacchetto, poi tenga la cartella mcp\ dove resterà — per esempio C:\PBToolboxAI\mcp\, il percorso degli esempi qui sotto: la configurazione dell'assistente indica il percorso completo di server\server.js.

13.3 Dichiararlo al proprio assistente #

Ovunque il comando è node e il suo argomento il percorso completo di server\server.js. In un file JSON ogni barra rovesciata del percorso si raddoppia.

Claude Code — una riga di comando. Le opzioni vanno prima del nome del server; --scope user lo rende disponibile in tutti i Suoi progetti (senza, solo nel progetto corrente):

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

Un percorso che contiene spazi va tra virgolette doppie:

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

Oppure, per tutto il team di un progetto, il file .mcp.json nella sua radice (è ciò che scrive claude mcp add --scope project) — Claude Desktop e Cursor accettano lo stesso contenuto:

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

VS Code — .vscode/mcp.json nel progetto, oppure il comando MCP: Open User Configuration per tutte le Sue aree di lavoro; la chiave è servers e il tipo stdio:

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

13.4 Gli strumenti #

L'assistente sceglie da sé lo strumento che risponde alla sua domanda:

StrumentoCosa risponde
list_componentsI componenti: classe, visivo o no, versione di introduzione, gratuito o a pagamento, rubrica
get_componentL'intera API di un componente: proprietà, metodi, eventi, costanti, handle degli elementi, membri ereditati; dll fornisce le funzioni esterne della DLL da dichiarare
get_memberUn membro: firma esatta e overload, codici di ritorno, descrizione, un esempio, cosa è cambiato da una versione all'altra; anche la dichiarazione esatta di una funzione PBT_*
get_topicUna pagina generale o una delle sue sezioni per intero: installazione, temi, testo formattato, lingua, licenza…
searchUna ricerca a testo libero in tutta la documentazione, risultati ordinati
get_examplesGli esempi PowerScript completi di un componente
check_codeVerifica PowerScript: metodo o proprietà sconosciuti, un of_set_*/of_get_* inventato al posto di una proprietà, evento sconosciuto o scritto con i suoi argomenti precedenti, numero di argomenti errato, membro rimosso, handle a cui si chiede di costruire, annotazione /*name*/ errata, vecchio vocabolario, argomento di evento inesistente, il codice restituito da un'aggiunta scambiato per un handle o chiamato come un oggetto
get_migrationLe guide di migrazione, da ogni versione alla successiva (l'ultima per impostazione predefinita), per un componente o per tutti

13.5 Trarne il meglio #