Skip to content
All recipes

Connect Claude, Cursor or Codex to Iru with MCP

Create an API token with Enable MCP turned on, connect your AI client and confirm it can list your devices. Every other recipe starts here.

Open in Claude Open in ChatGPT
Product
Iru MCP
Clients
Claude Desktop, Cursor, Codex
Effect
Setup
You need
Admin access to Access

Before you start

  • An Iru admin account with permission to create and manage API tokens in Access.
  • A supported MCP client: Claude Desktop, Cursor or Codex.
  • For Claude Desktop, Node.js 20 or later.

Prompt for your agent

List my Iru devices. For any action that erases, deletes or locks a device, summarize the impact first and wait for my explicit approval before you run it.

Steps

  1. Create an API token with MCP turned on

    In the sidebar, select the Account Menu Button, then Access, then the API tokens tab.

    Select Add Token, enter a Name and Description, turn on Enable MCP, then select Create. If Enable MCP is off, you get an Enterprise API token with no MCP access.

    Source: Iru MCP

  2. Copy the token and MCP configuration

    Select Copy MCP configuration, then check the box confirming you copied it. The secret shows only once. If you lose it, revoke the token and create a new one.

    Source: Iru MCP

  3. Give the token only the permissions you need

    Select Configure to set permissions now. Turn on only the Enterprise API permissions that the recipes you plan to run need.

    Source: Iru MCP

  4. Add Iru to your AI client

    Claude Desktop: paste the configuration into claude_desktop_config.json and save it. Fully quit with Claude > Quit Claude (closing the window isn't enough), then relaunch.

    Cursor: replace the contents of mcp.json with the configuration, save the file by hand, then fully quit and reopen Cursor.

    Codex Desktop App: select + Add server, enter Iru MCP for Name, select Streamable HTTP, fill in the details from your copied configuration and select Save. Fully quit and reopen Codex.

    Source: Iru MCP

  5. Confirm the connection

    Ask your client to List my Iru devices. When the connection works, it calls the Iru MCP server and returns your enrolled devices.

    GET/api/v1/devices

    Source: Iru MCP

Check it worked

  • Your client returns a list of your enrolled devices.
  • In Cursor, iru appears in the MCP list with its toggle on.
  • Claude Desktop prompts you before each Iru MCP tool use.

Common pitfalls

  • claude_desktop_config.json holds your URL and header values. Keep it out of source control and chat logs. If it leaks, revoke the token and update every client that has the old values.
  • MCP calls count toward the same limit as direct API use: 10,000 requests per hour per customer.
  • A "You do not have permission to perform this action" error means the token lacks a permission. In Access, open the token, select Edit and turn on the permissions for the routes you call.
  • Revoking a token deletes its Activity history for good. To keep the history, edit the token and remove all its permissions instead.
  • Deleting a team member also deletes the API tokens they created.

FAQ

Which AI clients can connect to Iru MCP?

This recipe covers Claude Desktop, Cursor and Codex. Claude Desktop needs Node.js 20 or later.

Why does my token have no MCP access?

Enable MCP was off when the token was created, so Iru made an Enterprise API token instead. Create a new token with Enable MCP turned on.

Is there a rate limit for Iru MCP?

MCP calls count toward the same limit as direct API use: 10,000 requests per hour per customer.

How do I cut off an agent without losing its history?

Remove the token's permissions instead of revoking it. Revoking a token deletes its Activity history.

Next steps

Sources

Stay up to date

Iru's bi-weekly collection of articles, videos, and research to keep IT & Security teams ahead of the curve.