Paquetes de herramientas — Referencia avanzada¶

La mayoría de los usuarios no necesitan esta página. El paquete predeterminado es standard — de solo lectura, seguro para cualquier entorno. Continúa leyendo solo si necesitas herramientas de escritura más allá de lo que ofrece standard.

Elegir un paquete¶

Empieza con el paquete más reducido que cubra tu trabajo. Cada nivel superior añade acceso de escritura a más dominios:

Solo lectura — seguro para cualquier entorno, sin herramientas de escritura:

Paquete	Herramientas	~Tokens	Cuándo usarlo
`core`	12	~3.0K	Solo lectura mínima: salud, esquema, descubrimiento y consultas de artefactos clave únicamente
`standard`	30	~7.3K	(Predeterminado) Solo lectura en incidentes, cambios, portal, registros y análisis de código fuente
`none`	0	0	Deshabilitar intencionadamente todas las herramientas (pruebas, entornos restringidos)

⚠️ Con capacidad de escritura — opciones avanzadas que conceden crear/actualizar/eliminar:

Paquete	Herramientas	~Tokens	Cuándo usarlo
`service_desk`	32	~8.2K	⚠️ Agentes de mesa de servicio que necesitan actualizar/cerrar incidentes y cambios
`portal_developer`	45	~10.6K	⚠️ Desarrolladores de portal que despliegan widgets, changesets y script includes
`platform_developer`	42	~10.8K	⚠️ Ingenieros de plataforma que gestionan flujos de trabajo, Flow Designer y scripts
`full`	56	~13.8K	⚠️ El más avanzado — todas las herramientas de escritura en todos los dominios a la vez (consulta la advertencia más abajo)

~Tokens = la huella aproximada que las tool schemas de cada paquete añaden al contexto del modelo por solicitud (medido con tiktoken cl100k_base; el conteo real de Claude varía ligeramente). Usar el paquete más reducido ahorra contexto y costo.

Todos los paquetes excepto core y none heredan las herramientas de solo lectura de standard mediante _extends. Consulta config/tool_packages.yaml para ver el árbol de herencia completo.

⚠️ Cualquier paquete por encima de standard es una opción avanzada con capacidad de escritura

service_desk, portal_developer, platform_developer y full activan herramientas de escritura — un agente de IA que se ejecute con ellos puede crear, actualizar y eliminar registros de ServiceNow. full lo hace en todos los dominios simultáneamente (incidentes, cambios, portal, Flow Designer, flujos de trabajo, scripts y más), de modo que un solo prompt mal entendido o una alucinación pueden desencadenar cambios destructivos en varias áreas a la vez.

No subas de nivel desde standard a menos que: - Comprendas cada herramienta de escritura que activa el paquete (consulta Inventario de herramientas) - Estés trabajando en una instancia no productiva o de pruebas (sandbox), o tengas activado el control allow_writes - Seas un desarrollador de ServiceNow con experiencia que sepa cómo recuperarse de cambios no deseados

Si tienes dudas, quédate en el predeterminado de solo lectura standard y elige el paquete de escritura más reducido solo cuando una tarea realmente lo necesite.

Establecer el paquete¶

Mediante variable de entorno (recomendado):

MCP_TOOL_PACKAGE=standard

Mediante opción de la CLI:

servicenow-mcp --tool-package standard --instance-url ...

En la configuración de tu cliente MCP:

{
  "env": {
    "MCP_TOOL_PACKAGE": "standard"
  }
}

Qué ocurre cuando una herramienta no está en tu paquete¶

Si llamas a una herramienta que no está activa en tu paquete actual, el servidor devuelve un error claro:

Tool 'manage_widget' is not available in package 'standard'.
Enable package 'portal_developer' or higher to use this tool.

Sin fallos silenciosos — el LLM sabe exactamente qué paquete solicitar.

Lista completa de herramientas¶

Para ver la lista completa de las 73 herramientas por categoría y pertenencia a paquete, consulta Inventario de herramientas.