Skip to main content

Connect Claude Desktop

Claude Desktop is the most popular MCP client for ScentSell. Setting it up takes about 3 minutes.

What you'll learn​

  • How to add ScentSell to Claude Desktop
  • How the OAuth authorisation works
  • How to test the connection

Prerequisites​

  • Claude Desktop installed (download from claude.ai/download)
  • An active ScentSell Premium subscription

Steps​

1. Open Claude Desktop settings​

  1. Open Claude Desktop.
  2. Click the Settings icon (gear, bottom-left).
  3. Go to MCP Servers.

2. Add ScentSell​

Click + Add MCP Server and enter the following:

{
  "mcpServers": {
    "scentsell": {
      "url": "https://mcp.scentsell.com.au/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Or, if you're editing the claude_desktop_config.json file directly (located at ~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{
  "mcpServers": {
    "scentsell": {
      "url": "https://mcp.scentsell.com.au/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Save and restart Claude Desktop.

3. Authorise ScentSell​

The first time you use a ScentSell tool, Claude Desktop will prompt you to authorise:

  1. A browser window opens and redirects to ScentSell's OAuth page.
  2. Sign in to your ScentSell account if prompted.
  3. Review the permissions and tap Authorise.
  4. The browser closes and Claude Desktop confirms the connection.

4. Test the connection​

In a new Claude conversation, type:

"What fragrances are in my ScentSell collection?"

You should see your collection listed in the response.

Troubleshooting​

"Premium required" error: You need an active Premium subscription. Go to scentsell.com.au/subscribe to upgrade.

"Invalid token" or connection refused: Try disconnecting and reconnecting. In Claude Desktop settings, remove the ScentSell MCP server and add it again.

Next steps: