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
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
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
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
Add Iru to your AI client
Claude Desktop: paste the configuration into
claude_desktop_config.jsonand save it. Fully quit with Claude > Quit Claude (closing the window isn't enough), then relaunch.Cursor: replace the contents of
mcp.jsonwith 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
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/devicesSource: 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.jsonholds 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.