# MCP setup

Source: https://getanalog.io/docs/mcp/

Use Analog from Claude Desktop, Cursor, or any MCP-compatible agent.

Connect Analog to an MCP-compatible agent by installing the tools,
connecting an account, and registering the server with your client.
The examples below show Claude Desktop configuration; other stdio MCP
clients use the same server command.

<details class="reference-index">
<summary>On this page</summary>

- [Install the tools](https://getanalog.io/docs/mcp/#install-the-tools)
- [Connect your account](https://getanalog.io/docs/mcp/#connect-your-account)
- [Configure Claude Desktop](https://getanalog.io/docs/mcp/#configure-claude-desktop)
- [Check the connection](https://getanalog.io/docs/mcp/#check-the-connection)

</details>



## Install the tools

`analog-mcp` exposes Analog's tools to your client. It reads the
credential stored by the `analog` CLI, so install both packages.

These commands use uv. If it is not available, the
[terminal installer](https://getanalog.io/docs/install/#install-from-a-terminal) sets up
uv and the CLI first.



### Install the CLI and MCP server

<!-- BEGIN GENERATED: onboarding mcp-install-full -->

```bash example=runnable scenario=onboarding-mcp-install-full
uv tool install analog-sdk
uv tool install analog-mcp
```
<!-- END GENERATED: onboarding mcp-install-full -->





## Connect your account

Already connected through the CLI on this machine as the same local
user? Skip to [Configure Claude Desktop](https://getanalog.io/docs/mcp/#configure-claude-desktop).

Otherwise, choose the command for your account. Complete the email
verification in the browser, then return to the terminal and wait for
confirmation. The MCP server reads the saved credential; you do not
need to put a key in the client's configuration.

For an interactive terminal without a browser, see
[Authenticate](https://getanalog.io/docs/authenticate/#sign-in-without-a-local-browser).



### Connect an existing account

Use this if you have an account, including one created on the website:

<!-- BEGIN GENERATED: onboarding existing-user-auth -->

```bash example=runnable scenario=onboarding-existing-user-auth-default
analog login
```
<!-- END GENERATED: onboarding existing-user-auth -->

### Create a new account

Use this instead if you do not have an account. Creating one during
the private alpha requires an invite code:

<!-- BEGIN GENERATED: onboarding new-user-auth -->

```bash example=runnable scenario=onboarding-new-user-auth-default
analog signup
```
<!-- END GENERATED: onboarding new-user-auth -->





## Configure Claude Desktop

Edit the configuration file for your platform:

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

If the file already registers other servers, add `analog` to its
existing `mcpServers` object.

For Cursor or another stdio MCP client, register `analog-mcp` as the
server command in that client's MCP settings.



### Register the Analog server

<!-- BEGIN GENERATED: onboarding mcp-config -->

```json example=config schema=mcp-client
{
  "mcpServers": {
    "analog": {
      "command": "analog-mcp"
    }
  }
}
```
<!-- END GENERATED: onboarding mcp-config -->

Save the file and restart Claude Desktop.



## Check the connection

Open the client's tool list and confirm that Analog's tools are available,
including `analog` and `assess`.

Once connected, use the [MCP tools reference](https://getanalog.io/docs/mcp-reference/) to look up
tool behavior, arguments, and defaults.