# Claude Code | User Guide | Shotomatic

> Connect Claude Code to Shotomatic over MCP with one click or one command, check that it works, and fix common setup problems.

- Type: Public web page
- Canonical page: [https://www.shotomatic.com/guide/ai-agents/clients/claude-code](https://www.shotomatic.com/guide/ai-agents/clients/claude-code)
- Markdown page: [https://www.shotomatic.com/guide/ai-agents/clients/claude-code.md](https://www.shotomatic.com/guide/ai-agents/clients/claude-code.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)

Claude Code can use Shotomatic on your Mac or Windows PC through Shotomatic's local MCP server. Shotomatic is tested with Claude Code.

## 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**.

Shotomatic runs `claude mcp add` for you with user scope, so Shotomatic is available in every project. It also turns on **Let AI agents use Shotomatic** and allows Claude Code, so no approval card appears. Start a new Claude Code session to load the server.

**Claude** appears in the list once Claude Code or the Claude app is installed. One **Connect** sets up whichever of the two is on your computer.

## Add it by hand

If you prefer the command line, turn on **Let AI agents use Shotomatic** in **Settings > AI agents**, install Node 18.3 or later, and run:

```sh
claude mcp add --scope user shotomatic -- npx -y shotomatic mcp
```

Without `--scope user`, Claude Code adds the server to the current project only. The first time Claude Code connects this way, Shotomatic shows an approval card; select **Allow**. See [Approvals and confirmations](https://www.shotomatic.com/guide/ai-agents/approvals-and-confirmations).

## Check that it works

Run `claude mcp list` in a terminal, or enter `/mcp` in a session, and look for `shotomatic`. Then 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` is missing from `/mcp`.** Start a new session. If you added the server without `--scope user`, open Claude Code in the same project folder.
-   **Connect shows an error about the claude command.** Open Claude Code once in a terminal so its command is installed, then select **Connect** again.
-   **"MCP access is turned off."** Turn on **Let AI agents use Shotomatic** in **Settings > AI agents**, then start a new session.
-   **The agent waits for approval.** Open Shotomatic and select **Allow** on the card.
-   **`npx` is not found.** This applies to the manual command only. See [the troubleshooting list for all clients](https://www.shotomatic.com/guide/ai-agents/other-agents#troubleshooting).

Next, try a request from [What agents can do](https://www.shotomatic.com/guide/ai-agents/what-agents-can-do), or see every tool in the [Tools reference](https://www.shotomatic.com/guide/ai-agents/tools).

## 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.
