---
title: "Claude, Cursor & Copilot — Heretic Lazy Shot"
description: Step-by-step MCP integration for Claude Desktop, Claude Code, Cursor and GitHub Copilot. Copy-paste configs, trust settings, working prompts.
canonical: https://giglabo.com/heretic/applications/heretic-lazy-shot/docs/integrations
locale: en
---

# Claude, Cursor & Copilot — Heretic Lazy Shot

> Markdown twin of https://giglabo.com/heretic/applications/heretic-lazy-shot/docs/integrations
> Fetch this instead of the HTML page: same content, a fraction of the bytes.
> Site structure and the full page list for agents: https://giglabo.com/llms.txt

Step-by-step MCP integration for Claude Desktop, Claude Code, Cursor and GitHub Copilot. Copy-paste configs, trust settings, working prompts.

## Claude, Cursor & Copilot

Every MCP-compatible agent can drive Heretic Lazy Shot. Below are copy-paste configs for the four most common clients.

## Prerequisites

1. Heretic Lazy Shot is **installed and running**
2. MCP server is **enabled** under *Settings → MCP*
3. Note your session token — *Settings → MCP → Copy token*

## Claude Desktop

Edit the Claude config file:

- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "heretic-lazy-shot": {
      "command": "lazy-shot-mcp",
      "args": ["--stdio"],
      "env": {
        "LAZY_SHOT_TOKEN": "paste-your-token-here"
      }
    }
  }
}
```

Restart Claude Desktop. The **🔌** icon should show `heretic-lazy-shot` connected.

## Claude Code

In your project, add an MCP server via the CLI:

```bash
claude mcp add heretic-lazy-shot lazy-shot-mcp --stdio
```

Or edit `~/.config/claude/mcp.json` manually with the same shape as Claude Desktop.

## Cursor

Open *Settings → Features → MCP*. Click **+ Add new MCP server**.

- **Name:** `heretic-lazy-shot`
- **Type:** `stdio`
- **Command:** `lazy-shot-mcp --stdio`
- **Env:** `LAZY_SHOT_TOKEN=your-token`

Restart Cursor. Open the composer panel and type `@heretic-lazy-shot` to verify tool discovery.

## GitHub Copilot (CLI)

```bash
gh copilot extension install heretic/lazy-shot
export LAZY_SHOT_TOKEN=your-token
```

Then from any Copilot chat prompt:

```
@lazy-shot capture the active terminal window and export as png
```

## Generic MCP client (HTTP)

If your client supports HTTP transport:

```json
{
  "type": "http",
  "url": "http://127.0.0.1:4717/mcp",
  "headers": {
    "Authorization": "Bearer your-token"
  }
}
```

## Verification prompts

Once connected, paste any of these to verify:

```
List the MCP tools available from heretic-lazy-shot.
```

```
Capture the active window, apply the twitter-16-9 preset,
add a soft drop shadow, and open the result.
```

```
Take 3 screenshots of my Chrome window, each spaced 5 seconds apart,
with filenames run-1, run-2, run-3.
```

## Troubleshooting

| Symptom | Fix |
| --- | --- |
| Tools don't appear | Restart the client after editing MCP config |
| `Permission denied: screen capture` | Grant Screen Recording in OS Privacy settings |
| `Invalid token` | Copy a fresh token from *Settings → MCP* |
| Port conflict on HTTP | Change port in *Settings → MCP → Transport* |

See [MCP tools](https://giglabo.com/heretic/applications/heretic-lazy-shot/docs/mcp-tools) for the full reference.

## Related

- HTML version of this page: https://giglabo.com/heretic/applications/heretic-lazy-shot/docs/integrations
- Site map for agents: https://giglabo.com/llms.txt