> For the complete documentation index, see [llms.txt](https://sallya1c.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sallya1c.gitbook.io/docs/sally-x402-mcp/how-to-install-and-run-mcp-sally-on-macos.md).

# How to Install and Run MCP Sally on MacOS

## Getting Started

### 1. Install Homebrew

Visit[ https://brew.sh/](https://brew.sh/)

Click the copy button on the Homebrew website.

<figure><img src="/files/DVSu8gZEXygtBO3DYhfh" alt="" width="563"><figcaption></figcaption></figure>

Open Terminal on your Mac and paste the command:

```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

<figure><img src="/files/4mBchMNkePCl3tpCjfxu" alt=""><figcaption></figcaption></figure>

Wait for the installation to finish.

<figure><img src="/files/6usPIop1eGa4zL2NgzSu" alt="" width="473"><figcaption></figcaption></figure>

When prompted, copy and run each of the following lines in your Terminal (replace (user) with your macOS username):

```
echo >> /Users/(user)/.zprofile
```

<figure><img src="/files/OaTS8Eqb6q2r7yzS3W6L" alt="" width="534"><figcaption></figcaption></figure>

```
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/(user)/.zprofile
```

<figure><img src="/files/9RnCUj1NUnAQjlJaJ6wX" alt="" width="537"><figcaption></figcaption></figure>

```
eval "$(/opt/homebrew/bin/brew shellenv)"
```

<figure><img src="/files/ZK4e6sdZsPe8HlawmUot" alt="" width="464"><figcaption></figcaption></figure>

### 2. Install pnpm

In your Terminal, type:&#x20;

```
brew install pnpm
```

<figure><img src="/files/asCx1rQ6xp9nIuRmOga7" alt="" width="537"><figcaption></figcaption></figure>

Press Enter, then wait for the installation to finish.

<figure><img src="/files/yHmL3fZkpZxg3ycwOLeP" alt="" width="540"><figcaption></figcaption></figure>

#### Download the Sally MCP Repository

Go to:[ https://github.com/sally-labs/](https://github.com/sally-labs/)

Open the **sally-mcp** repository.

<figure><img src="/files/KCHMuaJ9w7cnFkFu0Dpe" alt=""><figcaption></figcaption></figure>

Click the **Code** button → **Download ZIP**.

<figure><img src="/files/AHMljhvbpFjXYei4GwCv" alt=""><figcaption></figcaption></figure>

After downloading, extract/unzip the ZIP file.

<figure><img src="/files/XvVRlMC7JIIMqdrLClVp" alt=""><figcaption></figcaption></figure>

Open the folder **sally-mcp-main**.

Right-click the folder and select **New Terminal at Folder**.

<figure><img src="/files/TStrUfOMOQWY8TNRQXrM" alt="" width="385"><figcaption></figcaption></figure>

In the Terminal, run:&#x20;

```
brew install node
```

<figure><img src="/files/Jqc69lTBVf0apaaJ039Y" alt="" width="536"><figcaption></figcaption></figure>

Please wait until it finishes.

<figure><img src="/files/sfk6qCRshjD0LXOgr2X6" alt=""><figcaption></figcaption></figure>

Then run:

```
pnpm install
```

<figure><img src="/files/ivEofe2fSNl0wzVNWTk6" alt="" width="536"><figcaption></figcaption></figure>

Wait until installation completes.

<figure><img src="/files/Z23R1xKXaFtYWcSxR0ZY" alt="" width="536"><figcaption></figcaption></figure>

### 3. Install Claude Desktop

Visit:[ https://www.claude.com/download](https://www.claude.com/download)

Download the macOS version.

<figure><img src="/files/OyPLDQ1g0PFcHLIZ9j1d" alt="" width="563"><figcaption></figcaption></figure>

Run the installer.

<figure><img src="/files/m6L3hdFagXlzjcAa2gyT" alt="" width="324"><figcaption></figcaption></figure>

(Optional) You can also follow this video tutorial:\
<https://www.youtube.com/watch?v=58py_Es696k>

After installation, open the Claude app.

<figure><img src="/files/lzpCz7P7krlZHcykunhh" alt=""><figcaption></figcaption></figure>

#### Configure Claude to Use MCP Sally

In Claude, click the **Toggle Sidebar** button.

Click your **Profile** icon → **Settings**.

<figure><img src="/files/EeSUMRMG5eGZwbrE0c52" alt="" width="563"><figcaption></figcaption></figure>

Select **Developer**.

Click **Edit Config**.

<figure><img src="/files/2fyf8FGLi1eC2w4jkcjf" alt="" width="563"><figcaption></figcaption></figure>

Choose the file **claude\_desktop\_config.json** and open it with **TextEdit**.

<figure><img src="/files/dqEpY7M8N1MockqlNJUi" alt="" width="324"><figcaption></figcaption></figure>

<figure><img src="/files/19d9kEBDbgKapWEibmMK" alt="" width="563"><figcaption></figcaption></figure>

#### Add Sally MCP Configuration

Open: <https://github.com/sally-labs/sally-mcp>

Copy the section labeled “**Step 3: Configure Your MCP Client.**”

<figure><img src="/files/21SL4hQ0X0Tqz8dzI9MY" alt="" width="563"><figcaption></figcaption></figure>

Paste it into your **claude\_desktop\_config.json**.

<figure><img src="/files/ed1vCaruIeZvNS6lIIEn" alt="" width="563"><figcaption></figcaption></figure>

#### Update Two Required Fields:

**PATH\_TO\_YOUR\_MCP\_SERVER**

* Go to your **sally-mcp-main** folder.
* Copy its **full path**.
* Replace <mark style="color:yellow;">PATH\_TO\_YOUR\_MCP\_SERVER</mark> with that folder path.

**{YOUR\_WALLET\_PRIVATE\_KEY}**

* Copy your crypto wallet's private key.
* Paste it into <mark style="color:yellow;">{YOUR\_WALLET\_PRIVATE\_KEY}.</mark>

<figure><img src="/files/5M4tIFOYYdmAEIbwACif" alt="" width="563"><figcaption></figcaption></figure>

Then go to the **sally-mcp-main** folder and copy its pathname.

<figure><img src="/files/imOgiqLJ2pzLEnAxvFgk" alt="" width="563"><figcaption></figcaption></figure>

Then paste it into **PATH\_TO\_YOUR\_MCP\_SERVER** as shown in the image below:

<figure><img src="/files/ghr9PxFeaOr68QKvUsAc" alt="" width="563"><figcaption></figcaption></figure>

#### Verify MCP Sally is Active

In Claude, open **Search & Tools**.

Check if **MCP Ask-Sally** appears as active.

<figure><img src="/files/s89EuijiR1fX90WY8vvl" alt="" width="563"><figcaption></figcaption></figure>

### Test It Out

Try a prompt that starts with **ask Sally**, for example:

```
ask Sally what is CGM?
```

<figure><img src="/files/8SidNcO7yWmhrYIezIbg" alt="" width="563"><figcaption></figcaption></figure>

Claude should now return an answer processed through MCP Sally.

<figure><img src="/files/AmOcE9PHBU4uE4MW2iWf" alt="" width="563"><figcaption></figcaption></figure>
