# Claude app (Claude Desktop) | User Guide | Shotomatic

> Connect the Claude desktop app to Shotomatic over MCP with one click or a config entry, check that it works, and fix common problems.

- Type: Public web page
- Canonical page: [https://www.shotomatic.com/guide/ai-agents/clients/claude-desktop](https://www.shotomatic.com/guide/ai-agents/clients/claude-desktop)
- Markdown page: [https://www.shotomatic.com/guide/ai-agents/clients/claude-desktop.md](https://www.shotomatic.com/guide/ai-agents/clients/claude-desktop.md)

Browse the user guide

On this page

1.  [Connect with one click](#connect-with-one-click)
2.  [Add it by hand](#add-it-by-hand)
3.  [Check that it works](#check-that-it-works)
4.  [If the tool is unavailable](#if-the-tool-is-unavailable)

The Claude app for Mac and Windows can use Shotomatic through Shotomatic's local MCP server. Shotomatic lists it as **Claude Desktop**.

## Connect with one click

1.  Open Shotomatic and go to **Settings > AI agents** (`Command + ,`, or `Ctrl + ,` on Windows).
2.  Under **Connect an agent**, select **Connect** next to **Claude**.
3.  Quit and reopen the Claude app.

Shotomatic adds itself to `claude_desktop_config.json`, turns on **Let AI agents use Shotomatic**, and allows the Claude app, so no approval card appears. If Claude Code is installed too, the same **Connect** sets it up as well.

## Add it by hand

Turn on **Let AI agents use Shotomatic** in **Settings > AI agents** and install Node 18.3 or later. In the Claude app, open **Settings > Developer > Edit Config**. This opens `claude_desktop_config.json` (on Windows the file is in `%APPDATA%\Claude`). Add:

```json
{
  "mcpServers": {
    "shotomatic": {
      "command": "npx",
      "args": ["-y", "shotomatic", "mcp"]
    }
  }
}
```

If the file already has an `mcpServers` block, add the `shotomatic` entry inside it. Save, then quit and reopen the Claude app. The first time it connects, Shotomatic shows an approval card; select **Allow**.

## Check that it works

Start a new chat and ask:

> "Check Shotomatic's status and tell me what you can do with it."

A working setup answers with the Shotomatic version, whether **Screen Recording** and **Accessibility** are granted on a Mac, your plan and the free screenshots left today, whether the website browser is installed, and any capture already running.

## If the tool is unavailable

-   **Shotomatic does not appear in the chat's tools.** Quit the Claude app completely and open it again. Closing the window is not enough.
-   **The config change has no effect.** Check that the JSON is valid and that `shotomatic` sits inside `mcpServers`.
-   **"MCP access is turned off."** Turn on **Let AI agents use Shotomatic** in **Settings > AI agents**, then restart the Claude app.
-   **The agent waits for approval.** Open Shotomatic and select **Allow** on the card.
-   **`npx` is not found.** This applies to the manual entry only. See [the troubleshooting list for all clients](https://www.shotomatic.com/guide/ai-agents/other-agents#troubleshooting).

In **Settings > AI agents**, the Claude app is listed under **Approved agents** as **Claude Desktop**, separate from **Claude Code**. Next, try a request from [What agents can do](https://www.shotomatic.com/guide/ai-agents/what-agents-can-do).

## On this page

1.  [Connect with one click](#connect-with-one-click)
2.  [Add it by hand](#add-it-by-hand)
3.  [Check that it works](#check-that-it-works)
4.  [If the tool is unavailable](#if-the-tool-is-unavailable)

## About this version

This Markdown page is generated from the server-rendered public page on Shotomatic. Interactive controls and site navigation are omitted. Use the canonical page when citing or sharing it with people.
