uvx es la opción predeterminada en Windows, igual que en el resto de plataformas. Hay una situación propia de Windows que puede obligarte a abandonarlo:
Smart App Control bloquea uvx → cambia a pip (Paso 1b). Es con diferencia el fallo más habitual en Windows, y suele aparecer de golpe justo después de una actualización de Windows.
Si PyPI es inaccesible —una red corporativa que bloquea el índice de paquetes por completo—, ninguna de las dos vías podrá descargar nada. Pide a tu departamento de IT que ponga pypi.org y files.pythonhosted.org en la lista de permitidos, o que replique el paquete en un índice interno al que puedas apuntar con pip install --index-url.
Eso instala uv, descarga y verifica el servidor, y descarga Chromium. Luego añade el servidor al archivo de configuración de tu cliente MCP (sin comando de instalación):
uvx reutiliza un Chromium compatible que ya esté en la caché estándar de Playwright; si falta Chromium, ejecuta primero el comando de instalación anterior.
Actualizar:uvx guarda en caché la versión que descargó y la sigue reutilizando, así que hay que traer explícitamente cada nueva versión:
uvx deja de funcionar sin ningún error útil. El cliente MCP informa de que el servidor no arrancó, o PowerShell indica que el programa fue bloqueado por tu administrador / por una directiva del sistema. Nada ha cambiado en tu configuración. Muy a menudo esto empieza justo después de una actualización de Windows, lo que hace parecer que se ha roto el servidor y no el lanzador.
Smart App Control (SAC) es una característica de Windows 11 que solo permite ejecutar programas firmados o reconocidos como fiables. uvx no ejecuta un programa instalado de forma permanente: en cada ejecución descomprime un ejecutable temporal nuevo y sin firmar y lo lanza. Eso es exactamente lo que SAC existe para impedir, así que lo bloquea siempre. Por más que reintentes o reinstales uv, no cambia nada: por diseño, el archivo es nuevo y no está firmado en cada ejecución.
SAC viene en modo de evaluación en los equipos nuevos con Windows 11 y puede activarse solo más adelante, por su cuenta. Por eso aparece de la nada en una máquina donde uvx llevaba meses funcionando.
Para comprobarlo: Seguridad de Windows → Control de aplicaciones y navegador → Configuración de Smart App Control.
No desactives Smart App Control para resolver esto. Desactivarlo es un cambio sin retorno: una vez desactivado, Windows no te dejará volver a activarlo. Recuperarlo exige reinstalar Windows. No compensa degradar permanentemente la seguridad del sistema operativo por un lanzador de paquetes. Usa pip: resuelve el problema por completo y deja SAC activado.
pip instala el servidor como archivos Python normales que ejecuta un intérprete de Python firmado, así que SAC no tiene nada que objetar.
Instala Python 3.10 o superior desde el instalador de python.org: esa compilación está firmada y pasa SAC tal cual. (El Python de Microsoft Store también sirve.) Marca «Add python.exe to PATH» durante la instalación. Después:
Instala Chromium de antemano, como se muestra. Dejarlo para la primera llamada a una herramienta supone una descarga de ~150 MB compitiendo con el plazo de handshake de tu cliente MCP, lo que se manifiesta como connection closed.
Lánzalo siempre como módulo, nunca con el script de consola
pip también deja un shim servicenow-mcp.exe en tu carpeta Scripts. Ese shim es un .exe sin firmar que pip genera en tu máquina, así que SAC lo bloquea igual que bloqueaba uvx. Evítalo por completo llamando al módulo:
Solo cambian command y args. El bloque env es idéntico al de la forma con uvx: copia cualquier configuración del Paso 2 y sustituye las dos primeras líneas:
Para el TOML de Codex, el equivalente es command = "python" / args = ["-m", "servicenow_mcp"].
Si tu cliente MCP no encuentra python, indica la ruta absoluta (por ejemplo C:/Users/you/AppData/Local/Programs/Python/Python312/python.exe). Los clientes MCP no siempre heredan el PATH que tiene tu shell.
Copia la configuración para tu cliente MCP que aparece a continuación.
Reemplaza your-instance por la dirección real de tu instancia de ServiceNow.
Estos ejemplos usan la instalación predeterminada con uvx. En la vía de pip (Paso 1b), reemplaza command por python y args por ["-m", "servicenow_mcp"], conservando los flags --instance-url / --auth-type que vengan a continuación y dejando el bloque env exactamente como está.
Las Skills son planos de ejecución de IA: canalizaciones verificadas con controles de seguridad que convierten las herramientas MCP en bruto en flujos de trabajo fiables. 4 skills en 3 categorías.
Terminal window
# Claude Code
servicenow-mcp-skills claude
# OpenAI Codex
servicenow-mcp-skills codex
# OpenCode
servicenow-mcp-skills opencode
# O con uvx (sin necesidad de instalar)
uvx --from mfa-servicenow-mcp servicenow-mcp-skills claude
En la vía de pip (Paso 1b), llama al módulo en su lugar: servicenow-mcp-skills es el mismo tipo de shim .exe sin firmar generado por pip que Smart App Control bloquea:
Terminal window
python -m servicenow_mcp.setup_skills claude
python -m servicenow_mcp.setup_skills codex
python -m servicenow_mcp.setup_skills opencode
Cliente
Ruta de instalación
Descubrimiento automático
Claude Code
.claude\commands\servicenow\
Los comandos slash /servicenow aparecen en el siguiente arranque
OpenAI Codex
.codex\skills\servicenow\
Las skills se cargan en la siguiente sesión del agente
OpenCode
.opencode\skills\servicenow\
Las skills se cargan en la siguiente sesión
Categoría
Skills
Propósito
analyze/
6
Análisis de widgets, diagnóstico de portal, mapeo de dependencias, detección de código
fix/
3
Parcheo de widgets (controles de seguridad por etapas), depuración, revisión de código
manage/
8
Diseño de página, script includes, exportación de fuentes, descarga de fuentes de la aplicación, flujo de trabajo de changeset, sincronización local, gestión de flujos de trabajo, gestión de skills
deploy/
2
Ciclo de vida de change request, triaje de incidentes
explore/
5
Comprobación de estado, descubrimiento de esquema, rastreo de rutas, rastreo de disparadores de flujo, flujo del catálogo ESC
Actualizar: Vuelve a ejecutar el mismo comando de instalación para reemplazar todos los archivos de skills existentes.
Eliminar solo las skills: elimina manualmente el directorio de skills (por ejemplo Remove-Item -Recurse .claude\commands\servicenow\).
→ Esto es Smart App Control, no una instalación rota. uvx descomprime un ejecutable temporal sin firmar en cada ejecución y SAC se niega a ejecutarlo. Cambia a la vía de pip del Paso 1b. No desactives SAC: es un cambio sin retorno que solo puedes deshacer reinstalando Windows.
La instalación con pip funcionó, pero servicenow-mcp sigue sin arrancar
→ Estás topándote con el shim servicenow-mcp.exe generado por pip, que no está firmado y SAC bloquea igual que hacía con uvx. Llama al módulo en su lugar: python -m servicenow_mcp. Actualiza también la configuración de tu cliente MCP a "command": "python", "args": ["-m", "servicenow_mcp"].
→ En la vía de uvx, uv descarga automáticamente Python 3.11+: no se necesita ninguna instalación manual. Si hay un conflicto con el Python del sistema, desinstala y reinstala uv.
→ En la vía de pip eres tú quien aporta Python: instala 3.10+ desde el instalador de python.org (está firmado, así que pasa Smart App Control) y marca «Add python.exe to PATH». El Python de Microsoft Store también sirve.
→ Comprueba la sintaxis del archivo de configuración:
JSON: comas, comillas, llaves coincidentes
TOML: corchetes, comillas, comas
→ Verifica que instance-url comience con https://.
→ Claude Desktop requiere un cierre completo y reinicio tras los cambios de configuración (cierra también el icono de la bandeja).
uvx reutiliza la última versión que descargó en caché. No se actualiza automáticamente a una versión más reciente en cada ejecución. Para traer la última versión publicada a la caché:
