# Connect immut to your AI

This page shows how to give your AI agent the ability to protect your files with immut. Pick your tool below. It is written for both people and AI agents: an agent reading this page has everything it needs to set itself up.

> **Agent summary**
> - immut plugs into an agent two ways. Use either, or both.
> - **Skill** (`immut-proof`): the scan and classify and protect playbook. Install once with `npx skills add enroh-ops/immut-agent`, then run `immut setup`. Available now.
> - **Direct tools** (the immut connector): immut's tools exposed to your agent so it can protect and verify on demand. Coming soon.
> - Live now everywhere that supports skills: `npx skills add enroh-ops/immut-agent`.
> - Need a key: create an agent key in immut (Account, API keys) and set `IMMUT_API_KEY`.
> - Raw twin of this page: [/docs/connect.md](/docs/connect.md).

## What are the two ways to connect?

immut is the proof layer for digital files: permanent, independently verifiable, court-ready proof that a file existed at a moment, unchanged.

- **The skill is the brain.** It watches the files that matter, decides what to protect, organises them into folders, protects them, and reports. It runs on hosts that load skills, such as Claude Code and Cursor.
- **The connector is the tools.** It exposes immut's actions (protect a file, list what is protected, verify a proof) to any agent that can connect tools. This is coming soon.

They are two doors, not a stack. On Claude Code you can install the skill and be done.

## Claude Code

Claude Code runs on your machine with access to your real files, so it scans folders and protects them directly.

**Scan and protect skill (available now):**

```bash
npx skills add enroh-ops/immut-agent
```

The skill loads automatically when your task matches it, or you can run it by name with `immut setup`. Create an agent key in immut (Account, API keys), set `IMMUT_API_KEY`, then preview with `immut dry-run` and go live with `immut sweep`.

**Direct tools (coming soon):** one command to connect immut's tools, no bridge needed:

```bash
claude mcp add --transport http immut https://backend.immut.io/mcp \
  --header "Authorization: Bearer imut_your_key"
```

## Claude Desktop

Claude Desktop is great for asking immut to protect a file or a folder in chat. Point it at files saved on your disk.

**Scan and protect skill:** Desktop chat does not load skills, so use Claude Code for the full experience, or the connector below.

**Direct tools (coming soon):** add immut once under Settings, Connectors, and every chat can protect and verify files.

## Cursor and other IDEs

For Cursor, Windsurf, VS Code, Cline and similar tools. They read your project files, so the skill protects them directly.

**Scan and protect skill (available now):**

```bash
npx skills add enroh-ops/immut-agent
```

Create an agent key, set `IMMUT_API_KEY`, then `immut dry-run` and `immut sweep`.

**Direct tools (coming soon):** add the immut connector in your host's tool settings, for example `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "immut": {
      "url": "https://backend.immut.io/mcp",
      "headers": { "Authorization": "Bearer imut_your_key" }
    }
  }
}
```

## ChatGPT and the API

For agents you build yourself, or hosts that connect tools over the open standard.

**Now:** use the curated immut API directly, or install the skill on any host that supports it. See the [agent playbook](/docs/agents) and the [API reference](/docs/api).

**Direct tools (coming soon):** pass the immut connector to a programmatic agent so it can protect and verify.

## Any other agent

immut is built on open standards, so most modern AI agents can use it.

- If your agent supports skills, install it: `npx skills add enroh-ops/immut-agent`.
- Create an agent key in immut and set `IMMUT_API_KEY`.
- If your host supports connecting tools, the immut connector is coming soon.

## Which should I use?

- To protect your business files and keep them protected, use the **skill** on Claude Code or Cursor. It is the scanner.
- To give your agent immut's tools for ad hoc protect and verify, or on Claude Desktop, use the **connector** when it ships.