> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insito.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure

> Copy-paste MCP configuration for Claude Desktop and Cursor, plus environment options.

Both examples use `npx` so you don't have to install anything globally — the
first run downloads [`@insito/mcp`](https://www.npmjs.com/package/@insito/mcp)
and caches it. Replace `insk_your_key_here` with the key you created under
[Settings → API keys](/mcp/install#get-an-api-key).

<Tip>
  Don't want to run anything locally? Use the [hosted remote
  server](/mcp/remote) instead — a URL for Cursor/Claude Desktop, and OAuth
  sign-in (no key at all) for Claude.ai.
</Tip>

## Claude Desktop

Open **Settings → Developer → Edit Config** (this opens
`claude_desktop_config.json`) and add an `insito` entry:

```json claude_desktop_config.json theme={null}
{
  "mcpServers": {
    "insito": {
      "command": "npx",
      "args": ["-y", "@insito/mcp"],
      "env": {
        "INSITO_API_KEY": "insk_your_key_here"
      }
    }
  }
}
```

Restart Claude Desktop. Open a new chat and you'll see the Insito tools listed
under the tools menu.

## Cursor

Add the same block to `~/.cursor/mcp.json` (available in every project) or
`.cursor/mcp.json` in a single project:

```json .cursor/mcp.json theme={null}
{
  "mcpServers": {
    "insito": {
      "command": "npx",
      "args": ["-y", "@insito/mcp"],
      "env": {
        "INSITO_API_KEY": "insk_your_key_here"
      }
    }
  }
}
```

Cursor picks up the server automatically; check **Settings → MCP** to confirm
it's connected.

## Configuration reference

Every option can be set as an environment variable or a CLI flag (passed in
`args`). Flags win over environment variables.

| Variable         | Flag        | Default                  | Description                                        |
| ---------------- | ----------- | ------------------------ | -------------------------------------------------- |
| `INSITO_API_KEY` | `--api-key` | *(required)*             | Your dashboard API key (`insk_…`).                 |
| `INSITO_API_URL` | `--api-url` | `https://api.insito.app` | Override only for self-hosted / local development. |

<Tip>
  If the server can't start, it writes the reason to stderr — check your MCP
  client's logs. The most common cause is a missing or revoked
  `INSITO_API_KEY`.
</Tip>

## Verify it works

Ask your agent:

> List my Insito apps.

It should call `list_apps` and return your workspace's apps. If you get an
authentication error, re-check the key in
[Settings → API keys](https://admin.insito.app).