servicenow-devtools-mcp

Plataforma ServiceNow MCP

Usa tu aplicación de IA para trabajar con tickets de ServiceNow, comprender tu instancia y preparar cambios en registros o scripts.

MCP (Protocolo de Contexto de Modelo) permite que una aplicación de IA use herramientas de otro sistema. Este servidor conecta esas herramientas a tu instancia de ServiceNow. Describes el trabajo en lenguaje natural, y la aplicación llama a las herramientas que necesita.

Inicias sesión con tu cuenta de ServiceNow. Tus roles, políticas de acceso a la API y reglas de control de acceso (ACLs) siguen determinando lo que puedes leer o cambiar.

Comienza aquí

• ¿Trabajas con tickets y solicitudes? Comienza con Trabajo de ITSM.
• ¿Administras o desarrollas una instancia? Comienza con administración y desarrollo de instancias.
• ¿Te conectas por primera vez? Sigue la configuración de conexión, o pregunta a tu administrador por la configuración.

Si tu aplicación de IA ya tiene este servidor configurado, prueba:

Usa ServiceNow para mostrar 5 incidentes activos a los que pueda acceder. Incluye el número de incidente, descripción breve, prioridad y persona asignada. No cambies nada.

La primera solicitud que necesite ServiceNow abrirá tu navegador para iniciar sesión y otorgar permiso de conexión. Usa el navegador en la computadora que ejecuta el servidor MCP.

Trabajo de ITSM

Lee registros de incidentes, problemas, cambios y solicitudes. Revisa el historial de tickets, inspecciona adjuntos o cuenta registros para una actualización de estado. Puedes pedir el resultado como lista, tabla o resumen.

Por ejemplo:

• "Muestra 10 incidentes activos asignados al grupo Service Desk, ordenados por prioridad."
• "Resume INC0012345, incluyendo comentarios y notas de trabajo de los últimos 30 días."
• "Cuenta incidentes abiertos por grupo de asignación. Incluye los filtros que usaste."
• "Muestra las respuestas enviadas con RITM0012345."

Reemplaza los números de ejemplo y nombres de grupos con valores de tu instancia. Indica un período de tiempo y un límite cuando pidas una lista o historial. Pide a la aplicación que incluya números de registro para que puedas verificar su respuesta en ServiceNow.

Crear tickets, actualizar notas de trabajo y cambiar asignaciones requieren herramientas de escritura y permisos de ServiceNow. Consulta realizar cambios.

Administración y desarrollo de instancias

Usa el MCP para inspeccionar cómo funciona tu instancia, investigar problemas y preparar cambios en la configuración de ServiceNow. Puedes comenzar con un nombre de registro o una pregunta. No necesitas escribir solicitudes de API ni conocer los nombres de las herramientas MCP.

Por ejemplo:

• "Lee la regla de negocio llamada 'Validar prioridad'. Explica cuándo se ejecuta y qué hace su script."
• "Encuentra scripts que llamen a gs.eventQueue. Muestra los registros coincidentes."
• "Inspecciona el flujo 'Nuevo empleado'. Explica su disparador y pasos configurados."
• "Investiga errores de script de las últimas 24 horas. Muestra la evidencia de cada hallazgo."

Reemplaza los nombres de reglas y flujos de ejemplo con registros de tu instancia.

Los hallazgos de diagnóstico te ayudan a investigar una causa. No establecen una causa raíz ni reparan automáticamente la instancia. Las herramientas de Flow Designer inspeccionan la configuración almacenada. No editan, publican ni ejecutan flujos.

Con las herramientas de escritura habilitadas, puedes crear o actualizar registros de configuración, incluidos campos de script. Sigue el flujo de trabajo de cambios antes de aplicar un cambio de script.

Configuración de conexión

Un administrador prepara la conexión de ServiceNow. Cada usuario luego autoriza el acceso con su propia cuenta de ServiceNow.

La conexión compatible se ejecuta localmente en tu computadora. Tu aplicación de IA inicia el servidor usando stdio, una conexión local entre los dos programas. Necesitas Python 3.14 o posterior, uv, y una aplicación de IA que pueda iniciar servidores MCP locales.

1. Preparar OAuth en ServiceNow

OAuth permite que los usuarios autoricen la conexión a través de su navegador. El ID de cliente público identifica la aplicación. No es una contraseña ni un secreto de cliente.

Abre System OAuth > Application Registry. Selecciona New, luego Create an OAuth API endpoint for external clients, o selecciona una aplicación entrante existente. Configura la aplicación para cumplir estos requisitos:

Guarda la aplicación. Copia su ID de cliente público para el siguiente paso. Si no puedes configurar OAuth, pide a tu administrador de ServiceNow que proporcione ese ID y la URL de la instancia.

Los usuarios necesitan acceso a la API para los registros requeridos en su trabajo. OAuth no otorga permisos adicionales de tablas o campos.

2. Agregar la conexión a tu aplicación de IA

Reemplaza https://your-instance.service-now.com y your-public-client-id con los valores de tu administrador. Usa la dirección HTTPS de la instancia sin una ruta de página como /nav_to.do.

Estos ejemplos seleccionan explícitamente readonly y bloquean escrituras con SERVICENOW_ENV=prod. La configuración de entorno controla la protección de escritura. No selecciona una instancia ni detecta si esa instancia es de producción.

Mantén las entradas de servidor existentes al agregar esta configuración. No agregues contraseñas, claves de API, secretos de cliente ni tokens.

VS Code con GitHub Copilot, o Claude Code

Guarda esta configuración como .mcp.json en la carpeta de nivel superior que abras en tu aplicación de IA:

{
  "mcpServers": {
    "servicenow-platform": {
      "command": "uvx",
      "args": [
        "servicenow-platform-mcp"
      ],
      "env": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_OAUTH_CLIENT_ID": "your-public-client-id",
        "MCP_TOOL_PACKAGE": "readonly",
        "SERVICENOW_ENV": "prod"
      }
    }
  }
}

En VS Code, abre Chat y habilita las herramientas de ServiceNow. En Claude Code, aprueba el servidor MCP del proyecto cuando se te solicite. Para configuración a nivel de usuario y controles de conexión, consulta la guía de VS Code o la guía de Claude Code.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servicenow-platform": {
      "type": "local",
      "command": [
        "uvx",
        "servicenow-platform-mcp"
      ],
      "enabled": true,
      "environment": {
        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
        "SERVICENOW_OAUTH_CLIENT_ID": "your-public-client-id",
        "MCP_TOOL_PACKAGE": "readonly",
        "SERVICENOW_ENV": "prod"
      }
    }
  }
}

Para otra aplicación MCP local, usa el comando uvx servicenow-platform-mcp con las mismas cuatro variables de entorno. Su formato de configuración puede diferir. La guía de instalación incluye una entrada de servidor que puedes adaptar.

3. Inicia sesión y verifica el acceso

1. Reinicia tu aplicación de IA o su servidor MCP de ServiceNow después de guardar la configuración.
2. Pregunta: "Lista las herramientas de ServiceNow disponibles."
3. Pregunta: "Usa ServiceNow para mostrar un incidente activo. Incluye su número y descripción breve."
4. Completa la autorización en el navegador con la cuenta de ServiceNow prevista.

Un registro devuelto confirma que la conexión puede leer esa tabla. Si no puedes leer incidentes, usa una tabla a la que tu cuenta pueda acceder. El descubrimiento de herramientas por sí solo no confirma una conexión funcional a ServiceNow.

Los tokens permanecen en la memoria del servidor. El servidor renueva un token de acceso expirado cuando puede. Reiniciar el servidor requiere autorización del navegador nuevamente.

Realizar cambios

Comienza con una instancia de desarrollo o prueba. Pide a tu administrador que habilite solo las herramientas de escritura necesarias para tu trabajo y otorgue los permisos correspondientes de ServiceNow.

Por ejemplo, MCP_TOOL_PACKAGE=query,describe,record_read,record_write habilita la inspección y cambios de registros. Establece SERVICENOW_ENV=dev para esa instancia que no es de producción. Reinicia el servidor después de cambiar la configuración.

Cada mutación de registro, adjunto y catálogo requiere una vista previa seguida de mutation_apply. El servidor no impone aprobación humana. Usa este proceso de revisión:

1. Pide a la aplicación que lea el registro actual.
2. Solicita una vista previa del cambio propuesto.
3. Revisa la instancia de destino, el registro, los valores de campo y las diferencias de script.
4. Dile a la aplicación que aplique esa vista previa solo cuando la apruebes.
5. Verifica el resultado en ServiceNow. Prueba cualquier comportamiento cambiado en la instancia.

Para una actualización de ticket:

Vista previa de agregar esta nota de trabajo a INC0012345: "Esperando que la persona que llama confirme la solución." Muestra el cambio propuesto y espera mi aprobación.

Para una actualización de script:

Lee la regla de negocio llamada 'Validar prioridad'. Sugiere una corrección y explícala. Muestra una vista previa con el script de reemplazo completo. Espera mi aprobación antes de aplicarlo.

record_preview, attachment_preview y service_catalog_preview devuelven tokens de un solo uso. mutation_apply consume un token revisado y verifica políticas, autorización y cambios de estado detectables. Los tokens expiran después de 300 segundos y desaparecen al reiniciar. Si un resultado remoto es desconocido, verifica en ServiceNow antes de crear otra vista previa.

La navegación de catálogo está disponible en readonly a través de service_catalog. Las vistas previas de mutación de catálogo requieren el grupo service_catalog_write. La vista previa no simula el cumplimiento ni garantiza precios.

Las actualizaciones de script reemplazan el valor completo del campo. El servidor no verifica la sintaxis de JavaScript. Revisa y prueba el script antes de confiar en su comportamiento.

Establece SERVICENOW_ENV=prod o production para conexiones de producción y bloquear escrituras a través de este servidor. Los permisos de ServiceNow siguen siendo la autoridad para el acceso a registros. La selección de herramientas y la configuración de entorno son controles locales adicionales.

Elegir las herramientas disponibles

MCP_TOOL_PACKAGE controla qué herramientas puede llamar tu aplicación de IA:

El paquete predeterminado es readonly y el entorno predeterminado es prod. Un paquete habilita herramientas. No otorga permisos de ServiceNow. list_tool_packages lista los paquetes y grupos disponibles, no el paquete activo. Para el inventario completo y las entradas de herramientas, consulta la referencia de herramientas.

Si algo no funciona

Para una solicitud fallida, incluye la acción, el registro o tabla, y el error saneado en tu informe. Excluye contraseñas, tokens, encabezados sin procesar y URL de devolución de llamada del navegador. Consulta solución de problemas de instalación para verificaciones más detalladas.

Los datos de ServiceNow devueltos por las herramientas están disponibles para tu aplicación de IA. Usa una aplicación aprobada para los datos que manejas.

Más ayuda

• Trabajo de ITSM: colas de tickets, historial, respuestas de solicitudes y cambios de tickets.
• Administración y desarrollo de instancias: tablas, scripts, flujos, investigaciones y cambios revisados.
• Instalación y configuración: configuración de conexión, instalación desde fuente y solución de problemas.
• Wiki completa: configuración, referencia de herramientas, límites de seguridad y diagnósticos.
• Contribuir a este servidor MCP: desarrollo local, pruebas y versiones.

Reportar un problema · Paquete PyPI · Licencia MIT