> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nometria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Desktop Setup

> Add Nometria to Claude Desktop in 2 minutes. No terminal or coding needed.

## What you'll get

After setup, you can type things like this in Claude Desktop:

* "Deploy my app to production"
* "Show me the status of my deployments"
* "Create a preview of my project"

Claude will handle everything using Nometria's deployment tools.

***

## Setup (2 minutes)

<Tabs>
  <Tab title="Mac">
    <Steps>
      <Step title="Download the installer">
        <Card title="Download for Mac" icon="apple" href="https://nometria.com/downloads/install-claude-mcp.command">
          Click to download the setup file. It takes about 10 seconds.
        </Card>

        If your browser asks "Keep or discard?", click **Keep**.
      </Step>

      <Step title="Run the installer">
        1. Open **Finder** and go to your **Downloads** folder
        2. **Right-click** on `install-claude-mcp.command` and select **Open**
        3. If macOS shows a warning, click **Open** again

        <Warning>
          You must **right-click > Open** the first time. Double-clicking may show a security warning that doesn't let you proceed.
        </Warning>

        A small window will open, run for a few seconds, and close automatically. That's it — Nometria is now installed in Claude Desktop.
      </Step>

      <Step title="Restart Claude Desktop">
        Quit Claude Desktop completely (`Cmd + Q`) and reopen it.
      </Step>

      <Step title="Get your API key">
        1. Go to [nometria.com/settings/api-keys](https://nometria.com/settings/api-keys)
        2. Sign in to your account
        3. Click **Generate New Key**
        4. Copy the key (it starts with `nometria_sk_`)
      </Step>

      <Step title="Tell Claude your key">
        In Claude Desktop, type:

        ```
        Save my Nometria API key: nometria_sk_paste_your_key_here
        ```

        Claude will save it and confirm you're authenticated.
      </Step>

      <Step title="Deploy!">
        Now just tell Claude what you want:

        ```
        Deploy my app to production
        ```

        ```
        Create a staging preview of my project
        ```

        ```
        Show me all my deployed apps
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows">
    <Steps>
      <Step title="Download the installer">
        <Card title="Download for Windows" icon="windows" href="https://nometria.com/downloads/install-claude-mcp.bat">
          Click to download the setup file.
        </Card>

        If your browser asks "Keep or discard?", click **Keep**.
      </Step>

      <Step title="Run the installer">
        1. Open your **Downloads** folder
        2. **Double-click** `install-claude-mcp.bat`
        3. If Windows shows a SmartScreen warning, click **More info** then **Run anyway**

        A command window will open briefly and close when done. Nometria is now installed.
      </Step>

      <Step title="Restart Claude Desktop">
        Quit Claude Desktop completely and reopen it.
      </Step>

      <Step title="Get your API key">
        1. Go to [nometria.com/settings/api-keys](https://nometria.com/settings/api-keys)
        2. Sign in to your account
        3. Click **Generate New Key**
        4. Copy the key (it starts with `nometria_sk_`)
      </Step>

      <Step title="Tell Claude your key">
        In Claude Desktop, type:

        ```
        Save my Nometria API key: nometria_sk_paste_your_key_here
        ```
      </Step>

      <Step title="Deploy!">
        Tell Claude what you want in plain English. It handles the rest.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Manual (any OS)">
    If the download doesn't work, you can set it up manually in under a minute.

    <Steps>
      <Step title="Find your Claude Desktop config file">
        Open this file in any text editor:

        **Mac:**

        ```
        ~/Library/Application Support/Claude/claude_desktop_config.json
        ```

        **Windows:**

        ```
        %APPDATA%\Claude\claude_desktop_config.json
        ```

        <Tip>
          **Mac:** Open Finder, press `Cmd + Shift + G`, paste the path, and press Enter.
          **Windows:** Press `Win + R`, paste the path, and press Enter.
        </Tip>

        If the file doesn't exist, create it.
      </Step>

      <Step title="Paste this config">
        Replace the contents of the file with:

        ```json theme={null}
        {
          "mcpServers": {
            "nometria": {
              "command": "npx",
              "args": ["-y", "@nometria-ai/claude-code"]
            }
          }
        }
        ```

        If the file already has other MCP servers, just add the `"nometria": { ... }` block inside the existing `"mcpServers"` object.

        Save the file.
      </Step>

      <Step title="Restart Claude Desktop">
        Quit and reopen Claude Desktop. Nometria will appear in the tools list (look for the hammer icon).
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## Verify it's working

In Claude Desktop, click the **hammer icon** (tools) at the bottom of the chat. You should see tools starting with `nometria_` in the list:

* `nometria_deploy`
* `nometria_preview`
* `nometria_status`
* `nometria_list_apps`
* and more

If you see these, you're all set.

***

## What you can do

Once set up, just ask Claude in plain English:

| What you say                       | What happens                                    |
| ---------------------------------- | ----------------------------------------------- |
| "Deploy my app"                    | Builds and deploys to production                |
| "Create a preview"                 | Creates a free staging URL (2 hours)            |
| "Check my deployment status"       | Shows status, URL, and instance info            |
| "Show all my apps"                 | Lists everything you've deployed                |
| "Set up this project for Nometria" | Creates config file with auto-detected settings |
| "Add a custom domain"              | Adds your domain to the app                     |
| "Upgrade my instance to 8gb"       | Scales up your server                           |
| "Run a security scan"              | AI-powered security audit                       |

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="I don't see the hammer icon">
    Make sure you have Claude Desktop version 1.0 or later. Update Claude Desktop from [claude.ai/download](https://claude.ai/download).
  </Accordion>

  <Accordion title="Tools don't appear after setup">
    1. Make sure you fully quit Claude Desktop (`Cmd + Q` on Mac, not just close the window)
    2. Reopen Claude Desktop
    3. If tools still don't appear, the config file might be in the wrong location. See the "Manual" tab above.
  </Accordion>

  <Accordion title="Node.js or npx not found">
    The MCP server requires Node.js 18 or later. Download it from [nodejs.org](https://nodejs.org) — pick the **LTS** version and run the installer.

    After installing Node.js, restart Claude Desktop.
  </Accordion>

  <Accordion title="I get 'Unauthorized' errors">
    Your API key may be expired. Generate a new one at [nometria.com/settings/api-keys](https://nometria.com/settings/api-keys) and tell Claude the new key.
  </Accordion>
</AccordionGroup>

***

## Need help?

Email us at [hello@nometria.com](mailto:hello@nometria.com) or visit the [Nometria dashboard](https://nometria.com/dashboard).