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	31	~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	33	~8.2K	⚠️ Agentes de mesa de servicio que necesitan actualizar/cerrar incidentes y cambios
portal_developer	50	~10.6K	⚠️ Desarrolladores de portal que despliegan widgets, changesets y script includes
platform_developer	44	~10.8K	⚠️ Ingenieros de plataforma que gestionan flujos de trabajo, Flow Designer y scripts
full	61	~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.