Quickstart with Claude Desktop

Get started with CosmetiQ-MCP through Claude Desktop in minutes

0. Prerequisites

Download and install the official Claude Desktop official application here.

1. Access Claude Desktop Settings

Open the Claude menu on your computer and select "Settings...".

Important: These are NOT the Claude Account Settings found in the app window itself.

Look for the Claude menu in your system menu bar (macOS) or system tray (Windows), not within the Claude app interface.

This is what it should look like on a Mac:

2. Navigate to "Developer Settings"

In the Settings window, click on "Developer" in the left sidebar, then click "Edit Config" to open the configuration file.

Navigate to the Developer section and click "Edit Config":

This will create a configuration file at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add CosmetiQ-MCP Configuration

Replace the configuration file contents with this code.

Important: Replace YOUR_TOKEN_HERE with the Demo Environment Token generated during your first access.

Haven't sign up yet? Please see and follow the Quickstart guide.

{
  "mcpServers": {
    "cosmetiq-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "--header",
        "Authorization: Bearer YOUR_TOKEN_HERE"
      ]
    }
  }
}

Remember to use your token!

Replace YOUR_TOKEN_HERE in the configuration file. This connects to our hosted CosmetiQ-MCP server, so you don't need to install anything locally.

4. Verify Node.js Installation

Before restarting Claude Desktop, verify that Node.js is properly installed on your system.

How to check:

  • macOS: Open Terminal from Applications → Utilities

  • Windows: Press Windows + R, type "cmd", and press Enter

Enter this command to check your Node.js version:

$node --version

If you see a version number like "v18.17.0" or similar, you're ready to proceed. If you get an error saying "command not found" or "node is not recognized", please install Node.js from nodejs.org.

5. Restart Claude Desktop

After saving your configuration file, you need to completely quit and restart Claude Desktop.

On macOS, it should look like this:

Important sequence: You must first add your token to the configuration file, then restart Claude Desktop. After this initial restart, you can use "Reload This Page" to ensure cosmetiq-mcp appears correctly:

  • macOS: Go to View menu → Reload This Page

  • Windows: Go to View menu → Reload This Page

On macOS, it should look like this:

Upon restarting Claude and reloading the page view, you should see a slider icon in the bottom left corner of the input box:

Notice "cosmetiq-mcp" appears in the Connect apps menu with the number "3" indicating 3 available tools. This confirms the connection is working.

6. Test Your Connection

Once Claude Desktop is restarted, test your CosmetiQ-MCP connection with this simple prompt:

Test prompt:

Connect to cosmetiq-mcp!

If everything is working correctly, Claude should respond with information about CosmetiQ-MCP and confirm the connection.

Expected response should look like this:

Next Steps

PreviousQuickstartNextDemo Environment

Last updated