PBToolboxAI v4 ← Site

13. Asistente de IA: el servidor MCP de la documentación #

← Notas de la versión · Índice

Un asistente de IA (Claude Code, Claude Desktop, Cursor, VS Code…) que escribe PowerScript para PBToolboxAI no conoce la biblioteca: adivina nombres de métodos, argumentos, eventos — y se equivoca con aplomo. El servidor MCP de la documentación le da la API exacta de su versión: la consulta en lugar de inventarla, y verifica el código que le propone.

13.1 Qué es #

13.2 Instalarlo #

Se entrega en el paquete de demostración, en la carpeta mcp\: el servidor (server\server.js), la documentación que sirve (index\) y un README.md. Nada que descargar, nada más que instalar salvo Node.js 18 o posterior (nodejs.org) — node --version le indica la suya.

Descomprima el paquete y deje la carpeta mcp\ donde vaya a quedarse — por ejemplo C:\PBToolboxAI\mcp\, la ruta de los ejemplos siguientes: la configuración del asistente indica la ruta completa de server\server.js.

13.3 Declararlo en su asistente #

En todos los casos, el comando es node y su argumento, la ruta completa de server\server.js. En un archivo JSON, cada barra invertida de la ruta se duplica.

Claude Code — una línea de comandos. Las opciones van antes del nombre del servidor; --scope user lo pone a disposición de todos sus proyectos (sin ella, solo del proyecto actual):

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

Una ruta que contiene espacios va entre comillas dobles:

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

O bien, para todo el equipo de un proyecto, el archivo .mcp.json en su raíz (es lo que escribe claude mcp add --scope project) — Claude Desktop y Cursor aceptan el mismo contenido:

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

VS Code — .vscode/mcp.json en el proyecto, o el comando MCP: Open User Configuration para todos sus espacios de trabajo; la clave es servers y el tipo stdio:

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

13.4 Las herramientas #

El asistente elige por sí mismo la herramienta que responde a su pregunta:

HerramientaLo que responde
list_componentsLos componentes: clase, visual o no, versión de aparición, gratuito o de pago, sección
get_componentToda la API de un componente: propiedades, métodos, eventos, constantes, handles de elemento, miembros heredados; dll da las funciones externas de la DLL que hay que declarar
get_memberUn miembro: firma exacta y sobrecargas, códigos de retorno, descripción, un ejemplo, lo que cambió de una versión a otra; también la declaración exacta de una función PBT_*
get_topicUna página general o una de sus secciones entera: instalación, temas, texto enriquecido, idioma, licencia…
searchUna búsqueda de texto libre en toda la documentación, resultados ordenados
get_examplesLos ejemplos PowerScript completos de un componente
check_codeVerifica PowerScript: método o propiedad desconocidos, un of_set_*/of_get_* inventado en lugar de una propiedad, evento desconocido o escrito con sus argumentos anteriores, número de argumentos incorrecto, miembro retirado, handle al que se pide construir, anotación /*name*/ errónea, vocabulario antiguo, argumento de evento inexistente, el código que devuelve una adición tomado por un handle o llamado como un objeto
get_migrationLas guías de migración, de cada versión a la siguiente (la última por defecto), para un componente o para todos

13.5 Sacarle el máximo partido #