Conectar Claude a tus instancias de ServiceNow

Óptimo MCP le da a Claude cientos de herramientas para consultar, diagnosticar y administrar tus instancias de ServiceNow: consultar y cambiar registros, la CMDB, el catálogo, los flujos, las pruebas automatizadas, la base de conocimiento, los usuarios y sus permisos, los MID Server y lo que desarrollas, y recuerda lo trabajado entre una conversación y otra. Cada persona registra sus propias instancias y sus credenciales quedan cifradas en el servidor.

1. Requisitos

• Una instancia de ServiceNow (PDI, desarrollo o producción) accesible por HTTPS.
• Un usuario técnico en esa instancia con rol admin o, como mínimo, rest_api_explorer más los roles x_mcp_bridge.executor y x_mcp_bridge.script_runner una vez instalado el bridge.
• Una cuenta en el panel de https://mcp.optimotech.co. Las cuentas se crean por invitación del operador del servicio.
• Claude (web, escritorio o Claude Code) con soporte de conectores personalizados.

2. Crear la cuenta y registrar una instancia

1. Abre el enlace de invitación que recibiste, elige tu correo y tu contraseña, y configura la verificación en dos pasos.
2. Entra al panel y ve a Mis instancias > Nueva.
3. Arriba del formulario, escribe un nombre (por ejemplo Acme desarrollo) y la dirección de la instancia (basta el subdominio, por ejemplo acme). No hace falta escribir un identificador: se genera del nombre (acme-desarrollo) y puedes cambiarlo en Opciones avanzadas. En Claude basta con nombrar la instancia por su nombre o por su identificador.
4. En Credenciales, elige el método de autenticación (Usuario y contraseña para empezar) y escribe el usuario técnico y su contraseña. Cómo prepararlo, junto al método, explica qué crear en ServiceNow.
5. En Uso, elige Consultas y cambios si Claude va a crear o modificar registros; por defecto queda en Solo consultas. Marca Es una instancia de producción si aplica: pedirá confirmar la instancia antes de cada cambio y bloquea los despliegues directos de aplicaciones.
6. Si quieres comprobar los datos antes, pulsa Probar antes de guardar: el panel valida las credenciales sin guardar nada.
7. Pulsa Crear. Al guardar, el panel prueba la conexión y te dice con qué usuario entró o qué falló; la contraseña se cifra en ese momento y no vuelve a mostrarse.

3. Conectar desde Claude

Antes de empezar: necesitas Claude Pro, Max, Team o Enterprise. En Team o Enterprise, pide al propietario de la organización que añada el conector.

1. En Claude ve a Configuración > Conectores y pulsa Agregar conector personalizado.
2. Escribe un nombre (por ejemplo "ServiceNow MCP") y la URL https://mcp.optimotech.co/mcp. No hace falta client ID ni secreto.
3. Al pulsar Conectar se abre la pantalla de autorización de https://mcp.optimotech.co. Inicia sesión con tu cuenta del panel y pulsa Autorizar conexión.
4. Vuelves a Claude con el conector añadido. En un chat nuevo, abre el menú de herramientas y activa «ServiceNow MCP».

Otros clientes MCP

Todos usan la misma URL y se registran solos por OAuth: al conectar se abre la pantalla de autorización de https://mcp.optimotech.co. Después de editar un archivo de configuración, cierra y vuelve a abrir el cliente.

claude mcp add --transport http servicenow https://mcp.optimotech.co/mcp

{
  "mcpServers": {
    "servicenow": { "type": "http", "url": "https://mcp.optimotech.co/mcp" }
  }
}

{
  "mcpServers": {
    "servicenow": { "url": "https://mcp.optimotech.co/mcp" }
  }
}

{
  "servers": {
    "servicenow": { "type": "http", "url": "https://mcp.optimotech.co/mcp" }
  }
}

codex mcp add servicenow --url https://mcp.optimotech.co/mcp
codex mcp login servicenow

[mcp_servers.servicenow]
url = "https://mcp.optimotech.co/mcp"

{
  "mcpServers": {
    "servicenow": { "httpUrl": "https://mcp.optimotech.co/mcp" }
  }
}

Con un token del operador

Si el operador te entregó un token de acceso en vez de usar OAuth, agrega la cabecera Authorization: Bearer <tu-token> en la configuración del cliente. En Claude Code: --header "Authorization: Bearer <tu-token>".

Si el operador activó la lista de IP permitidas y el cliente responde 403, tu red no está autorizada: pide a un administrador del panel que la agregue (en «Conectar mi cliente» verás tu IP).

4. Primeras consultas

Escribe lo que necesitas como se lo pedirías a una persona. Antes de responder, Claude activa la instancia que nombres y repasa lo que ya se sabe de ella; no hace falta que lo pidas.

• Usa mi instancia «Acme desarrollo» y dime cuántos incidentes abiertos hay. La primera consulta para comprobar que todo funciona.
• Revisa la calidad de la CMDB de Acme desarrollo y dime qué servidores parecen duplicados. Revisa la calidad de la CMDB y busca duplicados.
• Describe la tabla incident: campos obligatorios, referencias y choices del campo state. Lee la estructura de la tabla y la recuerda para la próxima vez.
• Diagnostica el item de catálogo "Solicitud de acceso" y proponme mejoras en sus variables y políticas UI. Revisa el item, sus variables y sus políticas.
• Crea una assignment rule en incident que asigne el grupo según la categoría; primero muéstrame el plan. Te enseña el plan y crea la regla dentro de un update set.
• Recuerda que en esta instancia el grupo por defecto es "Service Desk". Lo guarda como preferencia de esa instancia.
• ¿Dónde se usa getUserGroups en el código de la instancia? Dame la línea de cada uso. Busca en business rules, script includes, client scripts, widgets, UI pages y más.
• ¿Qué cambió en el update set "STRY0012 alta" frente a la versión anterior de cada artefacto? Compara cada artefacto; los secretos no se muestran.
• Revisa la calidad de los scripts y de las ACL de la aplicación x_acme y ordena los hallazgos por severidad. Solo lectura; cada hallazgo trae su recomendación.
• Dame el MTTR y el backlog de incidentes de los últimos 30 días por grupo de asignación. También hay estadísticas y pendientes de CSM y HR.

5. Seguridad y permisos

Verificación en dos pasos

1. La primera vez que inicies sesión eliges el método: una app de autenticación (recomendado), una llave de acceso (la huella o el rostro de tu equipo o teléfono, 1Password o una llave física) o un código a tu correo.
2. Con la llave de acceso no escribes códigos: tu navegador te pide confirmar con la huella, el rostro o la llave. Puedes registrar varias en Mi perfil.
3. Con la app, el panel te muestra un código QR: escanéalo con cualquier app de códigos (Google Authenticator, Microsoft Authenticator, 1Password, Authy u otra) y escribe el código de 6 dígitos que te muestra. Te damos 10 códigos de respaldo de un solo uso (también con la llave de acceso): guárdalos en un lugar seguro, porque no se vuelven a mostrar. Puedes descargarlos en un PDF protegido con la contraseña de tu cuenta.
4. Con el correo, te enviamos un código de 6 dígitos cada vez que inicias sesión. Puedes pasarte a la app cuando quieras desde Mi perfil.
5. Después de escribir el código, ese navegador no lo vuelve a pedir durante 8 horas, aunque cierres sesión (solo la contraseña). Pasado ese plazo se pide de nuevo; tu organización puede ajustarlo.

No se puede desactivar desde la cuenta. Cada activación o restablecimiento te llega por correo; si no fuiste tú, escríbenos de inmediato.

6. Óptimo Chat dentro de ServiceNow

Óptimo Chat es un asistente que se instala dentro de tu instancia desde el panel. Cada persona lo usa con su propio usuario de ServiceNow: solo ve y hace lo que sus roles le permiten, y todo cambio (crear, actualizar, cerrar) le pide confirmación antes de hacerse. El modelo de IA lo eliges tú y se paga con tu propia llave: API de Claude (por defecto), Claude en Azure AI Foundry, OpenAI, Azure OpenAI o un servicio compatible con OpenAI.

Instalarlo

1. La instancia debe estar registrada con usuario y contraseña u OAuth de instancia (no con clave de API ni con la cuenta de cada persona), y ese usuario necesita el rol admin.
2. En el panel abre la ficha de la instancia y la pestaña Óptimo Chat. Revisa el resultado de la revisión previa.
3. Elige proveedor, modelos sugeridos, perfiles y topes de consumo, y pulsa Instalar. La instalación corre en segundo plano y muestra su avance; puedes cerrar la página.
4. En ServiceNow entra a Workflow Studio > Integraciones > Conexiones, abre Óptimo Chat - Proveedor de IA y pega la llave de tu proveedor (el panel te deja el enlace directo a la credencial). Con Azure OpenAI o un servicio compatible escribe también el endpoint y los modelos. La llave nunca se escribe en el panel.
5. Vuelve al panel y pulsa Probar conexión: prueba el modelo de cada perfil y, si responden, el estado pasa a activo.
6. Da a cada persona el rol x_<prefijo>_mcpchat.chat_user (sus incidentes, pedidos, catálogo, conocimiento y aprobaciones) o x_<prefijo>_mcpchat.chat_admin (consultas y cambios administrativos). El chat aparece en el menú Óptimo Chat y en el portal: como botón flotante en todas sus páginas o incrustado en la página de inicio, según lo que elijas al instalar. La página Estado del chat muestra el estado de Óptimo MCP y el consumo del mes a quien tenga chat_admin; para ver la conexión de IA necesita además connection_admin y credential_admin.

Límites que conviene conocer

7. Licencias y marca

Al conectar una instancia, Óptimo MCP lee sus suscripciones en Subscription Management (solo lectura) y la marca con la que se ve: nombre, logo, colores del tema y portales. Con eso Claude sabe qué módulos tiene licenciados tu instancia, te avisa antes de usar uno que podría generar costos de true-up y arma los informes con tus colores y tu logo.

8. Módulos por producto

Productos de ServiceNow sobre los que puedes preguntarle a Claude. Si tu instancia no tiene el producto instalado, Claude te dice cuál falta y qué usar en su lugar. Si no figura en tus licencias, funciona igual y te avisa del posible costo adicional (true-up).

9. Soporte

• Correo: [email protected]
• Diagnóstico rápido: pídele a Claude «prueba la conexión con mi instancia» o «revisa el componente de Óptimo MCP en mi instancia». Te explica si conecta, cuánto tarda, qué roles faltan y si el componente está al día.
• Error 403 al conectar: tu red no está en la lista de IP permitidas o el token caducó. Pide a un administrador que autorice tu IP o reconecta el conector.
• Claude dice «plugin no instalado»: tu instancia no tiene esa aplicación de ServiceNow; la respuesta dice cuál.