Skip to main content
Both examples use npx so you don’t have to install anything globally — the first run downloads @insito/mcp and caches it. Replace insk_your_key_here with the key you created under Settings → API keys.
Don’t want to run anything locally? Use the hosted remote server instead — a URL for Cursor/Claude Desktop, and OAuth sign-in (no key at all) for Claude.ai.

Claude Desktop

Open Settings → Developer → Edit Config (this opens claude_desktop_config.json) and add an insito entry:
claude_desktop_config.json
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:
.cursor/mcp.json
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.
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.

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.