Iru MCP

Introducción

El Model Context Protocol (MCP) es un estándar abierto para conectar aplicaciones cliente (hosts) con servidores MCP. Los servidores exponen herramientas, recursos y prompts para que los asistentes de IA puedan realizar acciones permitidas en tu entorno mediante un patrón coherente, en lugar de crear y mantener una integración personalizada independiente para cada asistente o flujo de trabajo que agregues. El servidor Model Context Protocol (MCP) de Iru expone la superficie de la Enterprise API de Iru, estructurada como herramientas MCP para asistentes de IA. Conecta Cursor, Claude Desktop, OpenAI Codex u otros clientes compatibles con MCP para consultar dispositivos, Blueprints y Library Items, y realizar acciones permitidas en lenguaje natural, sin crear tu propia integración con la API de Iru. También puedes combinar las herramientas de Iru con herramientas de otros proveedores (por ejemplo, de tickets, chat o IAM) para crear flujos de trabajo de extremo a extremo orquestados en lenguaje natural. Cuando Iru agrega nuevas funciones a la Enterprise API, esas funciones pasan a estar disponibles a través de MCP con el mismo modelo de permisos.

La Enterprise API (y el MCP que se basa en ella) se aplica a todas las áreas de Iru que exponen esa API, incluidos Endpoint y otros productos como Gestión de vulnerabilidades y Endpoint Detection and Response, según tu tenant y tus derechos de uso.

Para el uso de REST (API HTTP y tokens de portador fuera de MCP), consulta la Iru API Overview.

Antes de comenzar

Necesitas una cuenta de administrador de Iru con permiso para crear y administrar Tokens de API en Acceso, como se describe en la Iru API Overview.
Necesitas un cliente MCP compatible (como Claude Desktop, Cursor o Codex).

Crear un token de API con MCP

Usa Generate an API Token en la Iru API Overview para ver el recorrido completo por la interfaz (capturas de pantalla, Copy Token, Siguiente, Configurar / Skip, cuadrículas de permisos). Los pasos de esta página coinciden con ese artículo; debes activar Enable MCP antes de Crear para que Iru emita la configuración de MCP para este token.

Abre Access

En la barra lateral, selecciona el Botón del menú de la cuenta y, a continuación, selecciona Acceso.

Abre la pestaña Tokens de API

En Acceso, selecciona la pestaña Tokens de API.

Crea un nuevo token de API

Selecciona Add Token para crear un nuevo token de API.

Configura los detalles del token

Proporciona un Nombre y una Descripción para tu token de API.

Habilita MCP

Activa Enable MCP antes de seleccionar Create. Para MCP, este paso es obligatorio; si Enable MCP está desactivado, obtendrás un token de la Enterprise API sin acceso a MCP ni configuración de MCP.

Crea el token

Selecciona Create.

Límites de velocidad de la API: la Iru Endpoint Management API aplica un límite de 10.000 solicitudes por hora por cliente. Las llamadas MCP se autentican con el valor X-API-Key de headers en la Configuración de MCP de ese token y cuentan para el mismo límite por hora del tenant que el uso directo de REST y otras integraciones. Todos los tokens de API de tu tenant comparten ese límite. Para obtener contexto y solucionar problemas, consulta Considerations en la Iru API Overview y la documentación de la Iru Endpoint Management API.

Copiar tu token y la configuración de MCP

Después de crear el token, Iru muestra una pantalla de confirmación que solo aparece una vez: El token se ha creado correctamente. Copia lo que necesites, guárdalo de forma segura y recuerda que no volverás a verlo. Sigue los pasos siguientes en orden; Configuración de MCP hace referencia al JSON de Copy Configuración de MCP del paso 2.

Copia el token de API (opcional para el uso de la API sin MCP)

Para REST o scripts personalizados, usa Copiar junto al API token en la pantalla de confirmación. Ese valor no se usa para MCP.

Copia la configuración de MCP

En Configuración de MCP, revisa el JSON y, a continuación, usa Copy Configuración de MCP. El fragmento de Iru se basa en url, type y headers:

URL: el campo url (el endpoint de MCP que te proporciona Iru).
X-API-Key: la entrada X-API-Key dentro de headers. Cópiala exactamente como la muestra Iru, incluido el prefijo sk_live: que ya figura en el fragmento; los clientes MCP la envían como encabezado HTTP X-API-Key en cada solicitud.
X-MCP-Profile: la entrada X-MCP-Profile dentro de headers, que se envía como encabezado HTTP X-MCP-Profile.

Copy Configuración de MCP es el JSON para MCP. Usa los valores de headers exactamente como los muestra Iru. El valor de X-API-Key incluye el prefijo sk_live: que ya figura en el fragmento.

Solo un ejemplo con marcadores de posición:

mcp.json

{
  "mcpServers": {
    "iru": {
      "url": "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
      "type": "http",
      "headers": {
        "X-API-Key": "sk_live:YOUR_API_KEY",
        "X-MCP-Profile": "YOUR_PROFILE_ID"
      }
    }
  }
}

Marca la casilla de confirmación

Marca la casilla de confirmación: I have copied the token and Configuración de MCP and understand that I will not be able to see these details again.

Selecciona Next

Selecciona Siguiente.

Si pierdes el token o la configuración, revoca el token y crea uno nuevo.

Configurar los permisos de la API

Después de seleccionar Siguiente, verás la pantalla Manage API Permissions. Estos permisos controlan a qué endpoints de la Enterprise API puede acceder el MCP.

Configura ahora u omite

Elige una de las siguientes opciones:

Configurar para establecer los permisos ahora (recomendado).
Skip para establecer los permisos más adelante.

Selecciona los endpoints (si elegiste Configure)

Si seleccionaste Configurar, usa la lista de permisos para seleccionar lo que puede hacer este token:

Expande una categoría (por ejemplo, Blueprints) para ver los endpoints individuales.
Marca las casillas de los endpoints que quieras permitir.

Guarda

Cuando termines, selecciona Guardar.

Verifica

Verifica que el token muestre MCP enabled: Yes si activaste MCP al crearlo y que los permisos que seleccionaste estén habilitados.

Configura los permisos más tarde (si los omitiste)

Si omitiste la configuración de permisos, puedes configurarlos más adelante abriendo el token, seleccionando Editar, eligiendo los permisos y seleccionando Guardar.

Revocar un token de API

Revoca el token en Acceso como cualquier otro token de API. Usa Revoke a Token en la Iru API Overview para ver los pasos y las notas sobre Actividad.

Consideraciones

Visualización única de los secretos

El token de la API REST de Copiar y el JSON de Configuración de MCP se muestran solo una vez en la pantalla de confirmación en el momento de la creación.

La revocación es total

Revocar el token detiene el acceso a la API y a MCP que dependía de él.

Acciones destructivas

Para operaciones destructivas (por ejemplo, borrar, eliminar o bloquear), tu asistente debe resumir el impacto y exigir tu aprobación explícita antes de ejecutarlas, a menos que hayas agregado esa acción a una lista de permitidos del MCP. Sigue las normas de gestión de cambios de tu organización.

Paginación

Las respuestas de listas grandes se paginan. Pide al asistente que refine los filtros, pase a la página siguiente o exporte los datos cuando necesites el conjunto completo sin incluir todas las filas en el chat.

Configuración específica del cliente

Configuración de MCP es un JSON con url, type y headers. headers contiene X-API-Key y X-MCP-Profile, que en conjunto son lo que Iru espera en cada solicitud MCP. Dirige tu cliente a url y reenvía esos dos valores de encabezado sin cambios. El valor de X-API-Key incluye el prefijo sk_live: que ya figura en el fragmento.

Prácticas recomendadas

Usa el mínimo privilegio

Crea un token solo con los ámbitos de la Enterprise API que necesita tu automatización y, a continuación, habilita MCP en ese token.

Separa los tokens por equipo o caso de uso

Por ejemplo, usa un token orientado a lectura para los asistentes de informes y un token operativo más restringido para los flujos de trabajo de remediación.

Rota ante cualquier sospecha

Si la Configuración de MCP se filtró, revoca el token en Iru y emite uno nuevo; actualiza todos los clientes MCP que aún tengan los valores antiguos de url o headers.

Protege los archivos de configuración locales

claude_desktop_config.json contiene tus valores de url y de los encabezados. No lo confirmes en el control de código fuente ni lo compartas en registros de chat.

Protege los secretos de MCP y de la API

Trata la Configuración de MCP y cualquier token REST que copies con Copiar para uso sin MCP como secretos. Guárdalos en un gestor de contraseñas o en un almacén seguro, no en registros de chat ni en capturas de pantalla.

Agregar el Iru MCP a tu cliente MCP

Elige un cliente y sigue los pasos para ese host.

Claude Desktop
Cursor
OpenAI Codex

Agregar el Iru MCP a Claude Desktop

Claude Desktop es la aplicación de escritorio de Anthropic para chatear con Claude. Registra Iru editando claude_desktop_config.json con los valores de url y headers de tu Configuración de MCP.

Requisitos previos

En Iru, completa Copiar tu token y la configuración de MCP para tener url y headers (X-API-Key, X-MCP-Profile).
Instala Node.js 20+ desde nodejs.org. El instalador incluye npx, que Claude Desktop usa para ejecutar la conexión con el Iru MCP.

Usa mcp-remote@latest en args para que Claude Desktop ejecute el paquete mcp-remote actual. Si la conexión MCP falla con latest, fija temporalmente una versión anterior (por ejemplo, mcp-remote@0.1.13). Cuando se produce ese fallo, el problema está en mcp-remote, no en Iru.

macOS
Windows

Descarga e instala Claude Desktop

Descarga Claude Desktop para macOS, instala la app e inicia sesión: Download Claude.

Abre la configuración de Claude Desktop

Abre Claude Desktop y, a continuación, selecciona Claude → Settings en la barra de menús.

Abre la configuración de Developer

En Configuración, selecciona Developer.

Abre el archivo de configuración

En Developer, selecciona Edit Config. Claude Desktop abre la carpeta de configuración en Finder.

Abre claude_desktop_config.json

Abre claude_desktop_config.json desde esa carpeta en tu editor de texto preferido.

Un archivo nuevo puede mostrar {}. Un archivo existente puede incluir ya mcpServers, preferences u otros ajustes. En ese caso, agrega solo el bloque "iru" dentro de mcpServers y deja el resto sin cambios. Después de la } de cierre de mcpServers, agrega una coma antes de la siguiente sección de nivel superior (por ejemplo, "preferences").

Agrega la entrada del servidor Iru MCP

Pega en claude_desktop_config.json. Las tres líneas resaltadas son donde agregas tus valores de Configuración de MCP. Coloca tus valores de X-API-Key y X-MCP-Profile en env; cuando se inicia Claude Desktop, mcp-remote usa esos valores para los marcadores de posición ${IRU_X_API_KEY} y ${IRU_X_MCP_PROFILE} de args.

claude_desktop_config.json

{
  "mcpServers": {
    "iru": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
        "--header",
        "X-API-Key:${IRU_X_API_KEY}",
        "--header",
        "X-MCP-Profile:${IRU_X_MCP_PROFILE}"
      ],
      "env": {
        "IRU_X_API_KEY": "sk_live:YOUR_API_KEY",
        "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
      }
    }
  }
}

Reemplaza los marcadores de posición resaltados:

https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools por url de Configuración de MCP
sk_live:YOUR_API_KEY por X-API-Key de Configuración de MCP
YOUR_PROFILE_ID por X-MCP-Profile de Configuración de MCP

Combina con un archivo existente

Omite este paso si empezaste con un archivo vacío. Cuando preferences u otros ajustes ya se encuentran debajo de mcpServers, tu archivo debe conectar las secciones de esta forma. La línea resaltada es la coma entre mcpServers y la siguiente clave de nivel superior:

claude_desktop_config.json

        "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
      }
    }
  },
  "preferences": {
    "remoteToolsDeviceName": "your-device-name",
    "coworkWebSearchEnabled": true
  }
}

Guarda el archivo y reinicia Claude Desktop

Guarda claude_desktop_config.json y, a continuación, cierra Claude Desktop por completo. No basta con cerrar la ventana; selecciona Claude → Quit Claude en la barra de menús y vuelve a abrir Claude Desktop.Claude Desktop carga la configuración de MCP al iniciarse.

Verifica la conexión

Cuando Claude Desktop se vuelva a abrir, inicia un chat nuevo y pregunta:

List my Iru devices

Si la conexión funciona, Claude llama al servidor Iru MCP y devuelve una lista de tus dispositivos inscritos. Si ves un error, consulta Solución de problemas más abajo.

Aprueba el acceso cuando se te solicite

Claude solicita confirmación antes de cada uso de una herramienta del Iru MCP. Elige Allow once solo para esa ejecución o Always allow si quieres menos solicitudes para acciones similares. Aprueba cuando quieras realizar lecturas o cambios permitidos en Iru; rechaza si no quieres que se ejecute la herramienta.

Si algo sigue fallando

En Claude Desktop, abre Settings → Developer para revisar la entrada iru, si el servidor se está ejecutando y cualquier error que informe el host. Consulta Solución de problemas más abajo.

Descarga e instala Claude Desktop

Descarga Claude Desktop para Windows, instala la app e inicia sesión: Download Claude.

Abre la configuración de Claude Desktop

Abre Claude Desktop y, a continuación, selecciona el menú de hamburguesa, File y luego Configuración.

Abre la configuración de Developer

En Configuración, selecciona Developer.

Abre el archivo de configuración

En Developer, selecciona Edit Config. Claude Desktop abre la carpeta de configuración en el Explorador de archivos.

Abre claude_desktop_config.json

Abre claude_desktop_config.json desde esa carpeta en tu editor de texto preferido.

Agrega la entrada del servidor Iru MCP

claude_desktop_config.json

{
  "mcpServers": {
    "iru": {
      "command": "C:\\Program Files\\nodejs\\npx.cmd",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
        "--header",
        "X-API-Key:${IRU_X_API_KEY}",
        "--header",
        "X-MCP-Profile:${IRU_X_MCP_PROFILE}"
      ],
      "env": {
        "IRU_X_API_KEY": "sk_live:YOUR_API_KEY",
        "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
      }
    }
  }
}

Reemplaza los marcadores de posición resaltados:

https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools por url de Configuración de MCP
sk_live:YOUR_API_KEY por X-API-Key de Configuración de MCP
YOUR_PROFILE_ID por X-MCP-Profile de Configuración de MCP

Combina con un archivo existente

claude_desktop_config.json

        "IRU_X_MCP_PROFILE": "YOUR_PROFILE_ID"
      }
    }
  },
  "preferences": {
    "remoteToolsDeviceName": "your-device-name",
    "coworkWebSearchEnabled": true
  }
}

Guarda el archivo y reinicia Claude Desktop

Guarda claude_desktop_config.json y, a continuación, cierra Claude Desktop por completo. No basta con cerrar la ventana; haz clic con el botón derecho en el icono de Claude en la bandeja del sistema, selecciona Quit y vuelve a abrir Claude Desktop.Claude Desktop carga la configuración de MCP al iniciarse.

Verifica la conexión

Cuando Claude Desktop se vuelva a abrir, inicia un chat nuevo y pregunta:

List my Iru devices

Si la conexión funciona, Claude llama al servidor Iru MCP y devuelve una lista de tus dispositivos inscritos. Si ves un error, consulta Solución de problemas más abajo.

Aprueba el acceso cuando se te solicite

Si algo sigue fallando

En Claude Desktop, abre Settings → Developer para revisar la entrada iru, si el servidor se está ejecutando y cualquier error que informe el host. Cuando el servidor MCP se ejecuta, Claude también puede escribir logs\mcp-server-iru.log junto a claude_desktop_config.json en la carpeta de datos de la app Claude Desktop de tu instalación. Consulta Solución de problemas más abajo.

Agregar el Iru MCP a Cursor

Cursor es un editor de código nativo de IA para escribir y editar software con asistencia integrada. La app de escritorio de Cursor está disponible para macOS, Windows y Linux. Agrega Iru en Tools & MCP para poder usar las herramientas de tu tenant desde el editor.

Prepara los valores de Iru

En Iru, completa Copiar tu token y la configuración de MCP para tener url y headers (X-API-Key, X-MCP-Profile).

Descarga e instala Cursor

Descarga Cursor para tu plataforma, instala la app e inicia sesión: Download Cursor.

Abre la configuración de MCP

Abre la MCP Settings de Cursor:

macOS: Cursor → Settings → Cursor Settings y, a continuación, Tools & MCP.
Windows/Linux: File → Preferences → Cursor Settings y, a continuación, Tools & MCP.

Agrega un MCP personalizado

Selecciona Add Custom MCP.

Pega la configuración de MCP

El archivo mcp.json se abre en el editor. La forma de pegar depende de si ya hay otros servidores MCP definidos. Cursor empieza con un marcador de posición como este:

mcp.json

{
  "mcpServers": {}
}

Configuración nueva

Reemplaza todo el contenido de mcp.json por la Configuración de MCP completa que copiaste en Copiar la configuración de MCP al crear el token. Selecciona todo el contenido del archivo (incluido el marcador de posición de Cursor), pega y deja solo el JSON de Iru en mcp.json. No quites el prefijo sk_live: de X-API-Key en headers.

Servidores MCP existentes

Si mcpServers ya incluye otros servidores que quieres conservar, no reemplaces todo el archivo mcp.json. Agrega solo el bloque iru de Configuración de MCP. Copia desde "iru": { hasta la } de cierre de ese servidor (la segunda } después de headers). Agrega una coma después de la } de cierre de la entrada del servidor que aparece inmediatamente antes de iru. Mantén X-API-Key exactamente como lo muestra Iru, incluido el prefijo sk_live: que ya figura en el fragmento.Ejemplo cuando ya hay otro servidor configurado (las líneas resaltadas muestran la coma final y el bloque iru que debes copiar y pegar en el archivo mcp.json):

mcp.json

{
  "mcpServers": {
    "previous-mcp-server": {
      "url": "https://example.com/mcp",
      "type": "http",
      "headers": {
        "X-API-Key": "sk_live:YOUR_OTHER_KEY",
        "X-MCP-Profile": "YOUR_OTHER_PROFILE"
      }
    },
    "iru": {
      "url": "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools",
      "type": "http",
      "headers": {
        "X-API-Key": "sk_live:YOUR_API_KEY",
        "X-MCP-Profile": "YOUR_PROFILE_ID"
      }
    }
  }
}

Guarda la configuración

Cursor no guarda mcp.json automáticamente después de pegar. Guarda el archivo manualmente antes de salir o reiniciar:

macOS: Command+S
Windows/Linux: Ctrl+S o File → Save

Reinicia Cursor

Cierra Cursor por completo y vuelve a abrirlo. Cursor carga MCP al iniciarse.

Confirma

Vuelve a Tools & MCP. Confirma que aparece iru y que el interruptor se muestra habilitado.

Para obtener más información sobre el uso de MCP en Cursor, consulta Model Context Protocol (MCP) in Cursor.

Agregar el Iru MCP a OpenAI Codex

OpenAI Codex es el agente de programación de OpenAI para crear y modificar software con IA. Usa la Codex Desktop App o la extensión Codex en VS Code para registrar Iru como servidor MCP y trabajar con tu tenant desde el chat.

Desktop App
IDE extension

Codex Desktop App

La Codex Desktop App está disponible para macOS y Windows. Para conocer la compatibilidad de plataformas, las opciones de instalación (incluidas las compilaciones para Mac con Intel) y otros requisitos de la app, consulta la documentación de la app Codex en OpenAI Developers.

Prepara los valores de Iru

En Iru, completa Copiar tu token y la configuración de MCP para tener url y headers (X-API-Key, X-MCP-Profile).

Descarga e instala Codex

Descarga la Codex Desktop App e instálala: Codex.

Inicia sesión en Codex

Abre Codex e inicia sesión con tu cuenta de ChatGPT o una clave de API de OpenAI. Codex está incluido en los planes de ChatGPT aptos. Consulta Open Codex and sign in en la documentación de la app Codex.

Abre Settings

En Codex, ve a Configuración.

Abre MCP servers

Selecciona MCP servers.

Agrega un servidor

Selecciona + Add server.

Nombre

Introduce Iru MCP en Nombre.

Transporte

Selecciona Streamable HTTP.

URL

Introduce el valor de url de Configuración de MCP en URL.

Encabezado para X-API-Key

En Headers, establece Key en X-API-Key y Valor en la entrada X-API-Key de headers en Configuración de MCP, copiada exactamente como la muestra Iru, incluido el prefijo sk_live: que ya figura en el fragmento.

Encabezado para X-MCP-Profile

Selecciona + Add header. Establece Key en X-MCP-Profile y Valor en la entrada X-MCP-Profile de headers en Configuración de MCP.

Guarda

Selecciona Guardar.

Reinicia Codex

Cierra Codex por completo y vuelve a abrirlo para que recargue la configuración de MCP.

Prueba Iru en el chat

Inicia un chat nuevo y haz a Codex una pregunta sobre un área de la Enterprise API que tu token tenga permiso para usar (por ejemplo, dispositivos o Blueprints).

Extensión de Codex para IDE

La extensión de Codex para IDE ejecuta el agente de programación de OpenAI en tu editor. Agrega Iru mediante la configuración de MCP de la extensión.

Prepara los valores de Iru

En Iru, completa Copiar tu token y la configuración de MCP para tener url y headers (X-API-Key, X-MCP-Profile).

Instala Visual Studio Code

Instala Visual Studio Code si es necesario. VS Code es compatible con macOS, Windows y Linux.

Instala la extensión de Codex

Instala la extensión de Codex desde Visual Studio Marketplace. La extensión también funciona en otros editores compatibles con VS Code (por ejemplo, Cursor); los menús y la compatibilidad de plataformas pueden variar. Consulta la documentación de la Codex IDE extension para conocer las opciones de instalación.

Abre la barra lateral de Codex

Abre la barra lateral de Codex con el logotipo de OpenAI de la barra de actividades, con Open Codex Sidebar o mostrando la barra lateral secundaria y seleccionando la pestaña Codex.

Inicia sesión y completa la configuración

Selecciona Sign in with ChatGPT y autentícate. Codex está incluido en los planes de ChatGPT aptos. Sigue las indicaciones para terminar la configuración.

Abre la configuración de Codex

En la barra lateral de Codex, selecciona el icono de engranaje y, a continuación, Codex settings.

Abre MCP servers

Selecciona MCP servers.

Agrega un servidor

Selecciona + Add server.

Nombre

Introduce Iru MCP en Nombre.

Transporte

Selecciona Streamable HTTP.

URL

Introduce el valor de url de Configuración de MCP en URL.

Encabezado para X-API-Key

Encabezado para X-MCP-Profile

Selecciona + Add header. Establece Key en X-MCP-Profile y Valor en la entrada X-MCP-Profile de headers en Configuración de MCP.

Guarda

Selecciona Guardar.

Reinicia la extensión

Si Codex muestra Restart extension, selecciónalo para que se recargue la configuración de MCP.

Prueba Iru en el chat

En la barra lateral de Codex, inicia una conversación y pregunta sobre un área de la Enterprise API que tu token tenga permiso para usar (por ejemplo, dispositivos o Blueprints).

Solución de problemas

Para obtener ayuda general sobre MCP (ubicación de los registros, comprobaciones de configuración, MCP Inspector y depuración de clientes más allá de las notas específicas de Iru siguientes), consulta la guía de depuración de Model Context Protocol.

Iru MCP en general

El asistente indica que el token no es válido o que la autenticación falló

Vuelve a comprobar url y headers (X-API-Key, X-MCP-Profile) en Configuración de MCP. Elimina los espacios sobrantes. X-API-Key debe coincidir con el valor completo de Iru, incluido el prefijo sk_live: que ya figura en el fragmento. Si el token subyacente se rotó o revocó, crea uno nuevo y actualiza todos los clientes.

Faltan herramientas o el asistente informa de que se denegó el permiso

Los ámbitos de la Enterprise API del token pueden bloquear esas operaciones. Edita los permisos de API del token en Acceso o crea un nuevo token con los ámbitos que necesitas.

La configuración parece correcta en Iru, pero el cliente sigue fallando

Confirma que la Configuración de MCP del cliente coincide con url y headers de Iru y, a continuación, cierra por completo y reinicia la app host para que recargue la configuración de MCP. Si el problema persiste, usa la guía de depuración de Model Context Protocol para revisar los registros del host, validar el JSON y realizar pruebas con MCP Inspector.

Claude Desktop

Error de conector remoto o de red (URL de MCP personalizada)

Los conectores personalizados acceden a tu servidor MCP desde la infraestructura de Anthropic. Confirma que url en Configuración de MCP es correcta, que el servicio está en la internet pública y que cualquier firewall corporativo permite los rangos de IP de Anthropic. Consulta Comenzar with custom connectors using remote MCP y Anthropic IP addresses.

Inspecciona la entrada iru o lee los errores del host

En Claude Desktop, abre Configuración y, a continuación, Developer. Allí puedes revisar la configuración del servidor iru, ver si el servidor se está ejecutando y leer cualquier error que informe el host. Para conocer las rutas de los registros de Claude, DevTools y los pasos relacionados, consulta Debugging in Claude Desktop en la guía de depuración de Model Context Protocol.

El Iru MCP no se conecta con mcp-remote@latest

Usa mcp-remote@latest en args para mantenerte en el paquete mcp-remote actual. Si la conexión falla, cambia temporalmente ese valor a una versión anterior (por ejemplo, mcp-remote@0.1.13), guarda claude_desktop_config.json y, a continuación, cierra por completo y vuelve a abrir Claude Desktop. Vuelve a mcp-remote@latest cuando puedas. Cuando se produce este fallo, el problema está en mcp-remote, no en Iru.

Puente stdio (npx / mcp-remote) o configuración del archivo de configuración

Confirma que Node.js 20+ está instalado y, a continuación, abre claude_desktop_config.json y confirma que la URL de MCP de la entrada iru en args y los valores de env siguen coincidiendo con url, X-API-Key y X-MCP-Profile de Configuración de MCP (IRU_X_API_KEY debe incluir el prefijo sk_live:). Las líneas --header deben seguir usando ${IRU_X_API_KEY} y ${IRU_X_MCP_PROFILE}, no tu clave ni tu perfil sin procesar. En macOS, command debe ser npx; en Windows, usa la ruta completa C:\Program Files\nodejs\npx.cmd. Guarda el archivo y cierra por completo Claude Desktop (Claude → Quit Claude en macOS, Quit en la bandeja en Windows) antes de volver a abrirlo. En Windows, revisa logs\mcp-server-iru.log junto a claude_desktop_config.json si iru sigue fallando. Consulta Agregar el Iru MCP a Claude Desktop.

Cursor

MCP no se carga o iru sigue desactivado después de editar la configuración

Cierra Cursor por completo y vuelve a abrirlo; Cursor carga MCP al iniciarse. Si mcp.json sigue sin cargarse, confirma que el JSON es válido. En una configuración nueva, confirma que reemplazaste todo el archivo por la Configuración de MCP; si lo combinaste con servidores existentes, confirma que el bloque iru y las comas son correctos. Comprueba que url, X-API-Key y X-MCP-Profile coinciden con Configuración de MCP (consulta Agregar el Iru MCP a Cursor). X-API-Key debe incluir el prefijo sk_live: que ya figura en el fragmento. Para problemas más profundos del host, consulta la guía de depuración de Model Context Protocol.

OpenAI Codex

Add a project to use Codex (extensión para IDE)

Si Codex muestra Add a project to use Codex al chatear, primero abre o crea una carpeta de proyecto en el editor y, a continuación, vuelve a la barra lateral de Codex.

Codex: edita config.toml directamente

Si no puedes guardar ni cambiar la configuración de MCP en la interfaz, edita ~/.codex/config.toml directamente. Según Model Context Protocol in Codex, la CLI, la Codex IDE extension y la Codex Desktop App comparten este archivo. Consulta Codex IDE extension o Codex Desktop App para ver los flujos de configuración en la interfaz.Abre ~/.codex/config.toml en un editor de texto. ~ es tu carpeta de inicio (por ejemplo, /Users/your-user-name/.codex/config.toml en macOS).Establece url y http_headers a partir de Configuración de MCP, copiados exactamente como los muestra Iru. El valor de X-API-Key en http_headers incluye el prefijo sk_live: que ya figura en el fragmento. Usa Iru MCP como nombre del servidor. En config.toml, el nombre de la tabla después de mcp_servers. debe coincidir con la forma en que Codex almacenó ese servidor (a menudo derivado de Iru MCP, por ejemplo, iru_mcp).Ejemplo para Iru MCP:

config.toml

[mcp_servers.iru_mcp]
enabled = true
url = "https://YOUR_TENANT.connect.iru.com/mcp-server/connector/kandji/tools"
http_headers = { "X-API-Key" = "sk_live:YOUR_API_KEY", "X-MCP-Profile" = "YOUR_PROFILE_ID" }

Guarda el archivo y, a continuación, cierra por completo Codex o reinicia tu editor para que se recargue la configuración de MCP.

El servidor MCP no se conecta o las herramientas siguen sin conexión

Confirma que Iru MCP está habilitado en la configuración de MCP de Codex y que url y headers coinciden con Configuración de MCP (X-API-Key debe incluir el prefijo sk_live: que ya figura en el fragmento) y, a continuación, cierra por completo la app host y vuelve a abrirla para que Codex recargue MCP. Para la Codex IDE extension, esto significa cerrar el editor; para la Codex Desktop App, cierra Codex por completo. Para la depuración a nivel de transporte, consulta la guía de depuración de Model Context Protocol.

Descripción general de la API de Iru

API REST, tokens, permisos y Activity de la Enterprise API que MCP expone como herramientas.

Cómo configurar la API de Iru Endpoint en Postman

Importa la colección publicada y envía solicitudes autenticadas fuera de MCP.

Referencia de la Iru Endpoint Management API

Explora los endpoints, parámetros y ejemplos de solicitudes y respuestas de la API subyacente.

Integrar apps de terceros con la API de Iru Endpoint

Conecta productos de terceros y asigna los permisos de API que necesita cada integración.

Primeros pasos

Dispositivos

Agente

Blueprints

Inscripción

Library

Guías de implementación

Configuración

Integraciones

Endpoint Detection & Response

Gestión de vulnerabilidades

Introducción

Antes de comenzar

Crear un token de API con MCP

Copiar tu token y la configuración de MCP

Configurar los permisos de la API

Revocar un token de API

Consideraciones

Prácticas recomendadas

Usa el mínimo privilegio

Separa los tokens por equipo o caso de uso

Rota ante cualquier sospecha

Protege los archivos de configuración locales

Protege los secretos de MCP y de la API

Agregar el Iru MCP a tu cliente MCP

Agregar el Iru MCP a Claude Desktop

Requisitos previos

Agregar el Iru MCP a Cursor

Agregar el Iru MCP a OpenAI Codex

Codex Desktop App

Extensión de Codex para IDE

Solución de problemas

Artículos relacionados

Descripción general de la API de Iru

Cómo configurar la API de Iru Endpoint en Postman

Referencia de la Iru Endpoint Management API

Integrar apps de terceros con la API de Iru Endpoint

​Introducción

​Antes de comenzar

​Crear un token de API con MCP

​Copiar tu token y la configuración de MCP

​Configurar los permisos de la API

​Revocar un token de API

​Consideraciones

​Prácticas recomendadas

Usa el mínimo privilegio

Separa los tokens por equipo o caso de uso

Rota ante cualquier sospecha

Protege los archivos de configuración locales

Protege los secretos de MCP y de la API

​Agregar el Iru MCP a tu cliente MCP

​Agregar el Iru MCP a Claude Desktop

​Requisitos previos

​Agregar el Iru MCP a Cursor

​Agregar el Iru MCP a OpenAI Codex

​Codex Desktop App

​Extensión de Codex para IDE

​Solución de problemas

​Artículos relacionados

Descripción general de la API de Iru

Cómo configurar la API de Iru Endpoint en Postman

Referencia de la Iru Endpoint Management API

Integrar apps de terceros con la API de Iru Endpoint

Introducción

Antes de comenzar

Crear un token de API con MCP

Copiar tu token y la configuración de MCP

Configurar los permisos de la API

Revocar un token de API

Consideraciones

Prácticas recomendadas

Agregar el Iru MCP a tu cliente MCP

Agregar el Iru MCP a Claude Desktop

Requisitos previos

Agregar el Iru MCP a Cursor

Agregar el Iru MCP a OpenAI Codex

Codex Desktop App

Extensión de Codex para IDE

Solución de problemas

Artículos relacionados