Iris

Integrations

Connect Iris to Claude, your terminal, and your browser.

Claude Desktop (MCP)

Give Claude access to your recordings via the Model Context Protocol.

  1. Generate an API key for MCP (read scope is enough):
  2. Open Claude Desktop and edit the config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
  3. Paste this configuration:
    {
      "mcpServers": {
        "iris": {
          "command": "npx",
          "args": [
            "-y",
            "@iris/mcp-server"
          ],
          "env": {
            "IRIS_API_KEY": "ir_live_REPLACE_WITH_YOUR_KEY",
            "IRIS_API_URL": ""
          }
        }
      }
    }

    Replace the placeholder above with your own key once you’ve generated one.

  4. Restart Claude Desktop. The Iris tools appear in the tools panel.

CLI

Upload, list, and search recordings from your terminal.

  1. Install:
    npm install -g @iris/cli
  2. Log in (opens your browser):
    iris login --api-url 
  3. Try it:
    iris upload ~/Movies/screen.mov --wait
    iris list
    iris context <recording-id>

Browser extension

One-click recording from any tab. Tracks clicks, navigation, and typing as ground-truth actions.

Install the Iris extension and point it at this server () in the extension’s options page.